​
Checkout Quickstart

⏱️ 15-minute integration This Quickstart helps you set up Bolt Checkout Links in a flash ⚡ By the end of this guide you will be able to process payment links anywhere in your app. Sections should take no more than a few minutes:
Review the Process Flow Overview page to see how the overall end-to-end integration flow works.

​
Create a Bolt Sandbox Account

If you don’t have one, create a Bolt Merchant Sandbox account by completing the following steps:
  • Enter your company website URL – Use the public website for your game studio or company.
  • Provide company details – Add your legal business name, address, and contact information.
  • Add sandbox user information – Create a user profile for yourself (and optionally register additional team member).
  • Review and confirm – Check that all details are correct, confirm the pricing information, and select Submit.
  • Activate your account – Open the activation email from Bolt and follow the link to complete setup.
After activation, you can access your sandbox account here: Bolt Merchant Sandbox.

​
Install an SDK

We provide lightweight SDKs to help you get started:
More SDKs are coming soon.

​
Get Your API Keys

Once you create a Bolt Merchant account, sign in and navigate to:
  • In the left-side menu, Administration → API.
Copy the following into your request headers:
  • API Key - for authentication
  • Publishable Key - for identifying your public-facing integration
--header 'X-API-KEY: YOUR_API_KEY' \
--header 'X-PUBLISHABLE-KEY: YOUR_PUBLISHABLE_KEY' \
A Payment Link is a hosted checkout page for your item. POST /v1/gaming/payment_linksYou can create a payment link by providing the following parameters:
  • Item details - name, price, currency, and optionally an image
  • Game identifiers - your game_id and user_id
  • Redirect URL - a redirect_url for post-checkout
  • Metadata (optional) - custom values
The example below shows a minimal request payload in the Sandbox environment. For complete request and response examples, see Create Payment Link in the Bolt API. cURL 
curl --location 'https://api-sandbox.bolt.com/v1/gaming/payment_links' \
--header 'X-API-KEY: YOUR_API_KEY' \
--header 'X-PUBLISHABLE-KEY: YOUR_PUBLISHABLE_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "game_id": "YOUR_GAME_ID",
    "user_id": "USER_ID",
    "redirect_url": "bubble-merge://bolt-webcheckout/success",
    "item": {
        "price": 699,
        "name": "Gems Pack",
        "image_url": "https://yourcdn.com/image.png",
        "currency": "USD"
    },
    "metadata": {
        "beamable_id": "9876543210",
        "greeting": "Hello World!"
    }
}'

​
Enable Webhooks

To receive transaction updates in your backend, configure a webhook endpoint in your Bolt Merchant account:
  • In the left-side menu, go to Administration → Webhooks.
  • Enter the URL of the endpoint that will receive Bolt webhook requests.
See how to Validate Webhook Authenticity in the Bolt Webhooks.

​
Next Steps

You now have a working sandbox environment, an SDK installed, and your first payment link configured. Next, you can: Production When you are done with your testing you need to get ready for production.