Bolt HelpDocs
SupportMerchant Dashboard
DocumentationAPI ReferenceAI Agents
Skip to content

Integration prompts

Copy-paste agent prompts for Bolt checkout, embeddable payments, webhooks, and gaming payment links.

Copy a prompt into Cursor, Claude Code, or your agent harness. Each prompt links to canonical docs and OpenAPI specs.

Accept payments (managed checkout)

You are integrating Bolt Checkout for a supported eCommerce platform.

  1. Read https://help.boltapp.com/products/checkout
  2. Confirm platform: Shopify, BigCommerce, or Direct API
  3. Use sandbox API base https://api-sandbox.boltapp.com for all test calls
  4. Include X-Api-Key and X-Nonce on every outbound request
  5. Verify order creation against https://assets.boltapp.com/external-api-references/bolt.yml: POST /v1/merchant/orders
  6. Expected result: order token returned; test transaction visible in merchant-sandbox.boltapp.com

Do not invent fields. Mark anything not in the spec as BLOCKED.

Embeddable checkout

You are adding Bolt payment fields to a custom checkout UI.

  1. Read https://help.boltapp.com/products/embeddable-checkout and https://help.boltapp.com/api-reference/guides/embeddable-checkout
  2. Default to Embeddable API v1: verify against https://assets.boltapp.com/external-api-references/embedded.yml
  3. Load connect.js from connect-sandbox.boltapp.com in sandbox
  4. Use publishable key client-side; API key server-side only
  5. Expected result: shopper can complete payment in your UI; transaction in dashboard

Do not promote v3 unless explicitly requested.

Verify webhooks

You are implementing Bolt webhook signature verification.

  1. Read https://help.boltapp.com/api-reference/guides/verify-webhooks/
  2. Use signing secret from Merchant Dashboard → Administration → API
  3. Verify HMAC on inbound requests before processing payload
  4. Return 200 only after verification succeeds
  5. Expected result: forged requests rejected; valid webhooks update order state

For cart, shipping, and tax callbacks Bolt calls on your server, see Merchant Callback.

You are integrating in-game checkout links.

  1. Read https://help.boltapp.com/gaming/guide/quickstart/
  2. Create sandbox merchant account at merchant-sandbox.boltapp.com
  3. POST /v1/gaming/payment_links with X-API-KEY and X-PUBLISHABLE-KEY: verify body in OpenAPI
  4. Handle webhooks per https://help.boltapp.com/gaming/guide/bolt-webhooks/validate-authenticity/
  5. Expected result: payment link URL opens hosted checkout; webhook confirms completion

Use Unity C# or JavaScript SDK labels consistently in CodeGroups.

Skills for agents

Previous Page

FAQ for AI agents

Next Page

On this page

Accept payments (managed checkout)Embeddable checkoutVerify webhooksGaming payment linksRelated