Skip to main content
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

​
API-Key
string
required
Unique API key issued manually through Telegram.

​
Request Body

​
institution
string
required
Institution code from List Institutions (SWIFT code, or a custom code ending in PC).
​
accountIdentifier
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.
​
metadata
object
Optional. Used for KES Till/Paybill so phone normalization is skipped (e.g. channel: Till | Paybill, businessNumber).

​
Response

​
status
string
Response state (success).
​
data
object
​
accountName
string
The resolved account holder name, or "OK" (see note above).
{
  "institution": "GTBINGLA",
  "accountIdentifier": "0123456789"
}

{
  "status": "success",
  "message": "Account name was fetched successfully",
  "data": { "accountName": "JOHN DOE" }
}