Developer docs

SawaPay API

Use application credentials from your Developer Dashboard. Keep secret keys server-side and use a unique idempotency key for supported POST requests that move money.

Core endpoints

POST/api/v1/checkout/sessions

Create a hosted checkout session.

POST/api/v1/payments

Initiate a supported merchant payment.

POST/api/v1/transfers

Initiate an account transfer.

GET/api/v1/transactions

Read transaction history available to the application.

GET/api/v1/wallets/me/balances

Read supported wallet balances for the linked account.

GET/api/v1/exchange-rates

Read currently active exchange-rate records.

POST/api/v1/withdrawals

Initiate a supported withdrawal request.

POST/api/v1/refunds

Create an eligible business refund.

Authentication

Use a secret application key as a bearer token on server-to-server requests.

Idempotency

Reuse the same idempotency key only when retrying the same logical request.

Webhooks

Verify the SawaPay signature before trusting an incoming event.