Integrating Checkout.com
Auth: OAuth 2.0 (client credentials) · Partner program: not required · Setup time: about 10 minutes · Last verified: 2026-05-15
Enterprise card gateway with strong fraud, 3-D Secure 2, and global acquiring coverage.
Auth model
Section titled “Auth model”OAuth 2.0 client credentials (oauth2_cc). Submit clientId + clientSecret via the Connect Link form. The adapter exchanges them at https://www.checkout.com/docs/developer-resources/api/manage-api-keys/oauth-2-0-client-credentials with scope=gateway and caches the resulting bearer.
Configure in admin
Section titled “Configure in admin”- Sign in to the Hub at https://www.checkout.com.
- Go to Developers → API keys, copy the OAuth client ID + secret.
- Open
/platforms→ Payments → Checkout.com → Configure and submit:clientIdclientSecret
Webhooks
Section titled “Webhooks”Set up under Workflows → Add workflow. Point the URL at https://${PUBLIC_BASE_URL}/webhooks/checkout-com, set the signature key, and subscribe to:
payment_*(captures, refunds, voids)dispute_*payment_payout_*
The adapter verifies the cko-signature header (HMAC-SHA-256 of the raw body with the configured secret).
Quirks
Section titled “Quirks”- No native Subscription / Invoice / Plan resource. Recurring billing on Checkout.com is implemented client-side via stored card-on-file + scheduled charges. The router returns
501 NOT_IMPLEMENTEDfor these endpoints. balance_transactionsis Reporting-side. The adapter consumes the Financial Actions endpoint to back the canonical resource.- Live keys must be issued through your account manager. Sandbox keys self-serve.
References
Section titled “References”- API docs root: https://www.checkout.com/docs
- Webhooks (signature verification): https://www.checkout.com/docs/developer-resources/webhooks
- Payments overview: https://www.checkout.com/docs/payments
opensteward.dev ·Plans and free license ·Terms ·Privacy ·support@opensteward.dev
© 2026 Falco Consulting AB. Built from open-steward/opensteward@a3961d8. This site sets no cookies, runs no analytics and loads nothing from other sites, except platform logos from Brandfetch on the Platforms page.