Skip to main content
POST
/
v1
/
account
/
validate
curl --request POST \
  --url https://stablepay-money-api-production.up.railway.app/v1/account/validate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "accountNumber": "0722000001",
  "destinationCurrency": "KES",
  "paymentMethod": "MOMO"
}
'
{
  "accountName": "Jane Wanjiku",
  "accountNumber": "0722000001",
  "network": "MPESA"
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
accountNumber
string
required

The account number or phone number to resolve.

Example:

"0722000001"

​
destinationCurrency
enum<string>
required

Fiat currency associated with the account.

Available options:
GHS,
KES,
NGN,
TZS,
UGX,
ZMW
​
paymentMethod
enum<string>
required

How the recipient receives funds.

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

Bank code — required when paymentMethod is BANK.

Example:

"01"

Response

Account resolved successfully.

​
accountName
string | null
required

Registered account holder name. Null when the corridor only supports network detection.

Example:

"Jane Wanjiku"

​
accountNumber
string
required

The account number as submitted.

Example:

"0722000001"

​
network
string | null
required

Detected MNO for MOMO requests. Null for BANK, PAYBILL, TILL.

Example:

"MPESA"