Checkout API

FinCobra Checkout lets you accept payments programmatically. Funds go directly to your wallet — no custodial intermediary.

How it works

1. Configure — add the payment methods you want to accept. Checkout supports Bitcoin payment methods and Ethereum stablecoin payment methods with wallet and direct-transfer rails.
2. Create an API key — generate an API key from POST /api/checkout/api-keys, or from the dashboard, to authenticate requests.
3. Create invoices — call POST /api/checkout/invoices with a USD amount. The API returns one invoice with paymentOptions[], a selected rail, and a QR code for the active option.
4. Share the payment link — redirect your customer to /pay/:id or embed the QR code. The page shows one active payment rail at a time and updates automatically when payment is detected.
5. Get notified — configure a webhook URL to receive webhook events when payments are received, confirmed, expired, underpaid, or otherwise resolved.

Payment methods

The checkout model is payment-method based:

• bitcoin for Bitcoin address generation
• ethereum for Ethereum stablecoin checkout on supported rails

Invoices are built from the configured methods and expose paymentOptions[] so the hosted page and merchant views can render the active rail directly from the invoice payload.

Base URL

All API endpoints are relative to:

https://fincobra.com

Next steps

• Authentication — learn how to authenticate API requests
• Configuration — set up your checkout config
• Invoices — create and manage invoices
• Webhooks — receive real-time payment notifications
• API Reference — full endpoint reference