curl --request POST \
--url https://api.stablepay.ai/v1/account/validate \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"accountNumber": "+254712345678",
"country": "KE",
"paymentMethod": "MOMO"
}
'{
"accountName": "Jane Doe",
"accountNumber": "+254712345678",
"paymentCode": "MPESA",
"country": "KE",
"currency": "KES",
"paymentMethod": "MOMO",
"accountType": "CONSUMER",
"resolveToken": null
}Validate Account
Resolve payment details across bank accounts, mobile money, merchants, and QR codes.
curl --request POST \
--url https://api.stablepay.ai/v1/account/validate \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"accountNumber": "+254712345678",
"country": "KE",
"paymentMethod": "MOMO"
}
'{
"accountName": "Jane Doe",
"accountNumber": "+254712345678",
"paymentCode": "MPESA",
"country": "KE",
"currency": "KES",
"paymentMethod": "MOMO",
"accountType": "CONSUMER",
"resolveToken": null
}Authorizations
Stablepay API key. Include as Authorization: Bearer <key>.
Body
The bank account number, mobile money number, merchant identifier, or payment QR code.
"+254712345678"
Merchant or recipient country code.
GH, KE, NG, TZ, UG, ZM, CM, CI, SN, BJ, BF, CD, ZA The supported payment method used to deliver funds to the merchant or recipient.
BANK, MOMO, PAYBILL, TILL, QR Required when paymentMethod is BANK or PAYBILL (TZ). Available BANK options: OPAY, PALMPAY, MONIEPOINT, or BANKCODE. Available PAYBILL (TZ) options: PAYBILLCODE.
"OPAY"
Response
Account resolved successfully.
Resolved account holder name for merchant or recipient. Returns the phone number for corridors that only support operator detection.
"Jane Doe"
The resolved bank account number, mobile money number, or merchant identifier.
"+254712345678"
Carry this value forward directly as paymentCode on the payment endpoints.
PAYBILL / TILL: No code applies for these methods.
"MPESA"
Merchant or recipient country code as supplied in the request.
"KE"
Fiat currency derived from the country code. Use as sourceCurrency (payin) or destinationCurrency (payout) in subsequent calls.
"KES"
Payment method as supplied in the request.
"MOMO"
Resolves to CONSUMER for a personal account, or MERCHANT for a business account.
CONSUMER, MERCHANT "CONSUMER"
Shortlived token for merchant validated.
"eyJhciOi......iJ9MzILBkpU"