# Integration prompts

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

Source: https://help.boltapp.com/ai-agents/integration-prompts

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

## Accept payments (managed checkout) [#accept-payments-managed-checkout]

<Note>
  You are integrating Managed Checkout into an existing web app with Bolt Payments sandbox.

  1. Read [https://help.boltapp.com/products/checkout](https://help.boltapp.com/products/checkout)
  2. Follow the single flow in the quickstart. Use platform alternatives only when the user selects one.
  3. Use sandbox API base `https://api-sandbox.boltapp.com` for all test calls
  4. Use endpoint-specific authentication from the spec; keep API keys on the server.
  5. Verify order creation against [https://assets.boltapp.com/external-api-references/bolt.yml](https://assets.boltapp.com/external-api-references/bolt.yml): POST /v1/merchant/orders
  6. Verify the payment and matching app order, then run [https://help.boltapp.com/products/checkout-test-plan](https://help.boltapp.com/products/checkout-test-plan). Report unrun cases as Not run.

  Do not invent fields. Mark anything not in the spec as BLOCKED.
</Note>

## Embeddable checkout [#embeddable-checkout]

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

  1. Read [https://help.boltapp.com/products/embeddable-checkout](https://help.boltapp.com/products/embeddable-checkout) and [https://help.boltapp.com/api-reference/guides/embeddable-checkout](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](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. Verify the payment and matching app order, then run [https://help.boltapp.com/products/embedded-api-test-plan](https://help.boltapp.com/products/embedded-api-test-plan).

  Do not promote v3 unless explicitly requested.
</Note>

## Checkout Everywhere [#checkout-everywhere]

Follow [https://help.boltapp.com/products/checkout-everywhere](https://help.boltapp.com/products/checkout-everywhere) using its BigCommerce sandbox flow. Verify the same product through the link and QR code, then reconcile the Bolt payment and store order. Run [https://help.boltapp.com/products/checkout-everywhere-test-plan](https://help.boltapp.com/products/checkout-everywhere-test-plan). Other platforms use their own setup guides; do not mix instructions across stores.

## Marketplace Connect [#marketplace-connect]

Follow [https://help.boltapp.com/products/connect](https://help.boltapp.com/products/connect) for one seller and one sandbox payment. Preserve server-owned seller identity and verify the matching order. Run [https://help.boltapp.com/products/connect-test-plan](https://help.boltapp.com/products/connect-test-plan). Payment completion does not prove payout settlement. Flag unavailable account enablement instead of substituting another flow.

## Verify webhooks [#verify-webhooks]

<Note>
  You are implementing Bolt webhook signature verification.

  1. Read [https://help.boltapp.com/api-reference/guides/verify-webhooks/](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. Reject invalid signatures. For valid events, use the documented acknowledgement and durable processing flow.
  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](/api-reference/merchant-callback/overview).
</Note>

## Gaming payment links [#gaming-payment-links]

<Note>
  You are integrating in-game checkout links.

  1. Read [https://help.boltapp.com/gaming/guide/quickstart/](https://help.boltapp.com/gaming/guide/quickstart/)
  2. Create sandbox merchant account at merchant-sandbox.boltapp.com
  3. Verify the payment-link request against [https://help.boltapp.com/gaming/guide/bolt-api/create-payment-link/](https://help.boltapp.com/gaming/guide/bolt-api/create-payment-link/). Gaming endpoints are not in the published general OpenAPI specs.
  4. Handle webhooks per [https://help.boltapp.com/gaming/guide/bolt-webhooks/validate-authenticity/](https://help.boltapp.com/gaming/guide/bolt-webhooks/validate-authenticity/)
  5. Verify the payment on the server and grant the correct reward once. Identify any missing app-owned persistence or retry logic before claiming completion.

  Use Unity C# or JavaScript SDK labels consistently in CodeGroups.
</Note>

## Related [#related]

* [FAQ](/ai-agents/faq)
* [Docs for agents](/ai-agents/docs-for-agents)