Skip to main content
POST

Authorizations

​
Authorization
string
header
required

Stablepay API key. Include as Authorization: Bearer <key>.

Body

application/json
​
accountNumber
string
required

The account number of the payment method. Must be in E.164 format with the + prefix when paymentMethod is MOMO.

Example:

"+254712345678"

​
country
enum<string>
required

Recipient country code.

Available options:
GH,
KE,
NG,
TZ,
UG,
ZM,
CM,
CI,
SN,
BJ,
BF,
CD,
ZA
​
paymentMethod
enum<string>
required

The supported payment method used to deliver funds to the recipient.

Available options:
BANK,
MOMO,
PAYBILL,
TILL
​
paymentCode
string

Required when paymentMethod is BANK. Use the List Supported Banks endpoint to look up the paymentCode for recipient's bank. Available BANK options: OPAY, BANKCODE.

Example:

"OPAY"

Response

Account resolved successfully.

​
accountName
string
required

Registered account holder name is resolved for Kenya (MPESA, PAYBILL & TILL) and Nigeria (BANK). Returns the phone number for corridors that only support operator detection.

Example:

"Jane Doe"

​
accountNumber
string
required

The account number of the payment method. Must be in E.164 format with the + prefix when paymentMethod is MOMO.

Example:

"+254712345678"

​
paymentCode
string | null
required

Carry this value forward directly as paymentCode on the payment endpoints. PAYBILL / TILL: No code applies for these methods.

Example:

"MPESA"

​
country
string
required

Recipient country code as supplied in the request.

Example:

"KE"

​
currency
string
required

Fiat currency derived from the country code. Use as sourceCurrency (payin) or destinationCurrency (payout) in subsequent calls.

Example:

"KES"

​
paymentMethod
string
required

Payment method as supplied in the request.

Example:

"MOMO"