one api. one integration. every market.
Full API reference, webhook schemas, SDKs and integration guides are on the way. Below is a preview of the surface. Join the developer preview to get early access and shape it.
a single call opens a session.
Create a checkout session, redirect the buyer, and Settld handles the rest , local method routing, tax, invoicing, dispute defence and settlement in your elected currency.
curl https://api.settld.global/v1/checkout_sessions \
-H "Authorization: Bearer $SETTLD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"amount": 34900,
"currency": "ZAR",
"customer": { "email": "[email protected]" },
"return_url": "https://your.app/return"
}'the surface, previewed.
Create a hosted checkout session in-market, with local methods surfaced automatically.
Create a mandate on the rail your customer holds, card, mobile money or bank rail.
Execute a charge against an existing mandate. You keep the schedule, we execute the collection.
Itemised, export-ready settlement records in your elected currency.
Refund a charge as the seller of record, including tax reversal.
Read dispute state. Settld defends the case; you see the timeline and outcome.
signed events, at every state change.
Every lifecycle transition emits a signed webhook. Verify with your endpoint secret and reconcile against the events feed.
- · checkout_session.completed
- · subscription.activated
- · subscription.renewed
- · subscription.failed
- · charge.succeeded
- · charge.failed
- · settlement.paid
- · dispute.opened
- · dispute.won
- · dispute.lost
server sdks, in progress.
questions? [email protected]