Swaps - Sarafa Docs

Use swaps to convert one merchant wallet balance into another supported currency. Supported pairs are USD to SSP, USDT, or USDC; SSP to USD, USDT, or USDC; and USDT or USDC to USD or SSP.

Endpoint

POST /v3/swap

Required fields

Field	Description
`_from`	Source currency.
`_to`	Destination currency.
`amount`	Amount to convert.
`external_id`	Optional unique reference from your system.
`callback_url`	Required HTTPS URL that receives the completed callback.
`quote`	Set `true` to quote only, or `false` to create the swap.

Quote a swap

curl https://serviceapi.sarafa.ss/v3/swap \
  -H "x-api-key: YOUR_API_KEY" \
  -H "environment: sandbox" \
  -H "Content-Type: application/json" \
  -d '{
    "_from": "USD",
    "_to": "SSP",
    "amount": 50,
    "external_id": "swap-1001",
    "callback_url": "https://example.com/sarafa/callback",
    "quote": true
  }'

Create a swap

Send the request with quote: false after reviewing the quote. A completed swap returns debit and credit transaction records and queues one swap.updated callback.

Last modified on July 22, 2026