API reference
Base URL: https://api.swellpayments.com · Auth: Bearer secret key · All amounts in the smallest currency unit (cents).
Endpoints
POST
/v1/checkout/sessionsCreate a hosted checkout sessionGET
/v1/checkout/sessions/:idRetrieve a sessionPOST
/v1/checkout/sessions/:id/completeComplete a session (processor callback)POST
/v1/payment-linksCreate a payment linkGET
/v1/payment-linksList payment linksPOST
/v1/refundsCreate a refundGET
/v1/paymentsList paymentsGET
/v1/payments/:idRetrieve a paymentGET
/v1/customersList customersGET
/v1/balanceRetrieve available / pending balancePOST
/v1/webhooksRegister a webhook endpointGET
/v1/webhooksList webhook endpointsPOST
/v1/api-keysCreate an API keyGET
/v1/analyticsRevenue and conversion metricsPOST
/v1/payoutsRequest a payoutGET
/v1/payoutsList payoutsExample response
checkout.session
{
"id": "cs_01hx...",
"object": "checkout.session",
"amount": 4999,
"currency": "usd",
"status": "open",
"url": "https://checkout.swellpayments.com/session/cs_01hx...",
"livemode": false,
"created": 1720000000
}Amounts are always integers. Never send floating-point currency values.