Guides
Payment Flows
Follow the current invoice payment-link flow for merchant integrations.
Use this page to follow the current first integration path. It is a routing guide, not a replacement for the API reference.
Current first path
Start with server-created invoices and the returned payment link:
- Create an API key in the dashboard.
- Create an invoice from your server with an idempotency key.
- Send the payer to the invoice
checkout_urlpayment link. - Confirm fulfillment from a verified webhook or a server-side invoice status check.
- Reconcile credited funds with balances and the ledger.
- Create payouts from trusted server-side code when funds are ready to move.
This keeps API keys server-side and keeps fulfillment decisions on your backend.
Where each surface fits
| Surface | What it does | Merchant action | Where to continue |
|---|---|---|---|
| API keys | Authenticate server-side merchant API calls | Create a test key, keep live keys on your backend | Authentication |
| Invoices | Create one payment request and get a payment link | Send the payer to checkout_url, then check status server-side | Get Started, Invoices |
| Balances and ledger | Show spendable funds and audit history | Reconcile credits, fees, payouts, reversals, and late deposits | Balances and Ledger |
| Payouts | Move funds from merchant balances | Create payout requests from trusted server-side code | Payouts |
| Static addresses | Reusable deposit rails that auto-create invoices | Use for deposits, account top-ups, or repeated deposits | Static Addresses |
Static addresses are deposit rails
Static addresses auto-create invoices after deposits arrive, so use invoice status checks and balance events before crediting a user account. They are useful for repeat deposits, not for replacing the invoice payment-link path for a specific order.
Main integration path
- Authentication - create and protect API keys.
- Get Started - create the first invoice.
- Invoices - understand invoice fields, payment links, and statuses.
- Balances and Ledger - reconcile spendable funds.
- Payouts - send funds from merchant balances.
- Addresses - understand invoice addresses and static deposit rails.
- Webhooks - confirm payments and balance credits.
- Merchant API - generated endpoint reference.