{
"institution": "GTBINGLA",
"accountIdentifier": "0123456789"
}
{
"status": "success",
"message": "Account name was fetched successfully",
"data": { "accountName": "JOHN DOE" }
}
API Reference
Verify Account
Resolve the account holder’s name for an institution + account number before creating an order.
POST
/
v1
/
sender
/
verify-account
{
"institution": "GTBINGLA",
"accountIdentifier": "0123456789"
}
{
"status": "success",
"message": "Account name was fetched successfully",
"data": { "accountName": "JOHN DOE" }
}
Confirms a payout account and returns the account holder’s name. Recommended
before creating an order so transfers don’t bounce.
accountName may be "OK" when the account is valid but the corridor returns
no display name (e.g. KES M-Pesa). In that case, supply your own accountName
on the order / recipient.Header Parameters
string
required
Unique API key issued manually through Telegram.
Request Body
string
required
Institution code from List Institutions
(SWIFT code, or a custom code ending in
PC).string
required
Bank account number, mobile-money MSISDN, or Till/Paybill identifier. For
mobile-money institutions, phone numbers are normalized (strips
+, drops a
leading domestic 0, adds the country dial code — KES 254, UGX 256, TZS 255,
GHS 233, MWK 265). e.g. 0712345678, +254712345678, 254712345678 all
resolve to 254712345678.object
Optional. Used for KES Till/Paybill so phone normalization is skipped (e.g.
channel: Till | Paybill, businessNumber).Response
string
Response state (
success).{
"institution": "GTBINGLA",
"accountIdentifier": "0123456789"
}
{
"status": "success",
"message": "Account name was fetched successfully",
"data": { "accountName": "JOHN DOE" }
}