Setup

BuiltByBit connects Kora to your BuiltByBit resources. When someone buys, Kora issues a license and links it to the buyer, so your customers are licensed the moment they check out.

Set it up

1. Add your API token. Put your BuiltByBit API token in BUILTBYBIT.API_TOKEN. It is what lets the poller read your sales.
2. Map your resources. For each resource you sell, add an entry to BUILTBYBIT.RESOURCES with its RESOURCE_ID, the Kora PRODUCT it maps to, and any ADDONS to grant.
3. Add the webhook (optional, for real time). In the resource's BuiltByBit settings, point a webhook at https://your-kora-host/api/builtbybit/webhook and set the same secret in BUILTBYBIT.WEBHOOK_SECRET.
4. Pick a claim mode (see below).

Restart Kora after editing the config.

How purchases become licenses

The CLAIM.MODE setting decides what happens on a new purchase:

• auto-link (default): Kora issues a license and links it to the buyer's Kora user right away.
• unclaimed-key: Kora issues an unclaimed key with a redeem code. The buyer redeems it later, and Kora links the license to them. Redeem through POST /api/builtbybit/claim on the API Reference.

Staying in sync

Kora keeps up with BuiltByBit two ways, and both share the same idempotent ingest, so a purchase is never handled twice:

• A poller reconciles recent purchases every POLL.INTERVAL.
• The webhook delivers purchases in real time.