Skip to main content
POST

Authorizations

x-api-key
string
header
required

Merchant API secret.

Headers

environment
enum<string>
default:production

Target environment. Defaults to production when omitted.

Available options:
production,
sandbox

Body

application/json
currency
enum<string>
required
Available options:
USD,
SSP
amount
number
required
Required range: x <= 1000000000
destination
enum<string>
required
Available options:
mobile,
sarafa
account_number
string
required

Phone number for mobile transfers or Sarafa account number for Sarafa transfers.

Required string length: 3 - 64
external_reference
string
required
Required string length: 3 - 120
Pattern: ^[A-Za-z0-9._:-]+$
callback_url
string<uri>
required
Maximum string length: 500
destination_currency
enum<string>
Available options:
UGX,
KES,
SSP
quote
boolean
default:true

Callbacks

POST
{$request.body#/callback_url}transferPending

Body

application/json
event
enum<string>
required
Available options:
transfer.pending
status
enum<string>
required
Available options:
pending
data
object
required

Response

200

Callback accepted.

Response

Quote, mobile transfer transaction, or Sarafa transfer legs.

status
enum<string>
required
Available options:
success
data
object
required
Last modified on July 17, 2026