Coinbase Business
Coinbase Business / CDP crypto checkout. Needs key id, private key, and webhook secret. Sandbox uses same CDP keys.
Coinbase Business
Crypto checkout via Coinbase Business (CDP) checkouts (Commerce successor path in this product).
Where to find it
Admin → Settings → Payment → gateways → Coinbase Business
Setup
1. In the Coinbase CDP portal, create API credentials. Enable Account Read, Customer Read, and Customer Write.
2. Paste CDP JSON id into API key id and privateKey into the secret field (PEM; newlines OK).
3. Create a webhook subscription for checkout.payment.success → https://YOUR-DOMAIN/api/webhooks/coinbase-commerce and paste the signing secret.
4. Enable checkout. Test mode uses the sandbox API path; use sandbox-labeled webhook subscriptions while testing (same CDP keys).
| Field | Key |
|---|---|
| Enable | coinbase_commerce_checkout_enabled |
| API key id | coinbase_commerce_api_key |
| API secret | coinbase_commerce_api_secret |
| Webhook secret | coinbase_commerce_webhook_secret |
| Test mode | coinbase_commerce_test_mode |
Return: /api/checkout/coinbase-commerce/return.
Common problems
Scope / Checkouts errors
Missing CDP permissions on the key.
Webhook signature errors
Secret rotated in Coinbase but not updated in admin; or live webhook used while test mode is on.