Create your first payment
From API keys to a settled payment: create a charge, handle redirect methods, and read the timeline.
8 min read · updated 2026-10-12
Developers
One API, one ledger, readable docs
The API version is 2026-06-01 and the base URL is
https://api.example.com. Everything below is sample data you can call in the
static playground without keys, money, or network.
Guides
Receive webhooks
Verify signatures, respond to retries correctly, and keep the timeline as source of truth.
6 min read · updated 2026-09-28
Run payout batches
Queue thousands of payouts from a file or the API and approve them under maker-checker.
7 min read · updated 2026-10-02
API reference
POST
/v1/payments Create a payment
Charges a customer through the method you select. Returns the payment object with its current status.
GET
/v1/payments/{id} Retrieve a payment
Fetches the payment with its full timeline: authorization, captures, refunds, and dispute state.
GET
/v1/payments List payments
Returns payments newest first, filterable by status, method, and date range.
POST
/v1/payouts Create a payout
Sends funds from one of your balances to a bank account, with maker-checker approval applied per your program rules.
GET
/v1/balances List balances
Returns every balance you hold, with available and pending amounts per currency.
POST
/v1/cards Issue a corporate card
Creates a virtual card with spend controls that are enforced at authorization.
Test cards
Simulate every outcome
Use these numbers with any test key. Live mode rejects them.
| Number | Behavior |
|---|---|
4242 4242 4242 4242 | Succeeds immediately |
4000 0000 0000 9995 | Declined, insufficient funds |
4000 0027 6000 3184 | Triggers 3-D Secure challenge |
5555 5555 5555 4444 | Mastercard, succeeds |
Ready for your first call
The first-payment guide takes about eight minutes from keys to a settled test payment.