Sarafa Business API - Sarafa Business API

The Sarafa Business API gives your server access to your verified organization’s account. Use it to read balances and transactions, collect payments, send payouts, swap wallet balances, and create hosted checkout links.

Get started

Complete your organization’s verification in the merchant dashboard.
Create an API key in the dashboard’s API section. Save the full key when it is created; the secret is shown only once.
Make your first authenticated request:

curl "https://api.sarafa.site/v3/" \
  -H "Authorization: Bearer $SARAFA_API_KEY" \
  -H "Content-Type: application/json"

Keep your API key on your server. It grants access only to your organization’s account.

Choose an operation

Task	Endpoint	Guide
Read your organization and account	`GET /v3/`	Profile
Read wallet balances and deposit addresses	`GET /v3/wallets` and `GET /v3/wallets/{currency}`	Wallets
Read transaction history	`GET /v3/transactions`	Transactions
Check payment status	`GET /v3/transactions/{id}`	Payment details
Collect a payment	`POST /v3/charge`	Charge
Send a payment	`POST /v3/transfer`	Transfer
Convert wallet balances	`POST /v3/swap`	Swap
Create or check a hosted payment link	`POST /v3/checkout` and `GET /v3/checkout/{reference}`	Hosted checkout

Read authentication and request conventions before integrating, then implement signed callbacks and retries.

Charge, transfer, and swap default to a quote. Set quote to false to execute. A response with status: "success" confirms the API request succeeded. Only transaction.status: "completed" confirms payment.