curl --request POST \
--url https://api.paycrest.io/v1/verify-account \
--header 'Content-Type: application/json' \
--data '
{
"institution": "GTBINGLA",
"accountIdentifier": "0123456789"
}
'{
"status": "success",
"message": "Account name was fetched successfully",
"data": "JOHN DOE"
}{
"status": "error",
"message": "Error message",
"data": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"status": "error",
"message": "Error message",
"data": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"status": "error",
"message": "Error message",
"data": [
{
"field": "<string>",
"message": "<string>"
}
]
}Verify Account
Resolves the account holder name when available. For some fiat corridors (e.g. KES M-Pesa), data may be "OK" when the account is valid but no display name is returned — supply your own accountName on the order in that case.
curl --request POST \
--url https://api.paycrest.io/v1/verify-account \
--header 'Content-Type: application/json' \
--data '
{
"institution": "GTBINGLA",
"accountIdentifier": "0123456789"
}
'{
"status": "success",
"message": "Account name was fetched successfully",
"data": "JOHN DOE"
}{
"status": "error",
"message": "Error message",
"data": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"status": "error",
"message": "Error message",
"data": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"status": "error",
"message": "Error message",
"data": [
{
"field": "<string>",
"message": "<string>"
}
]
}metadata (KES Till/Paybill), and when data is "OK" vs a resolved name.
Status codes are the same as v2: 400 means not verified (do not retry), 503 means verification could not complete (retry with backoff). See Status codes.Body
Institution code (SWIFT code or custom PayCrest code ending with 'PC'). See Code Standards for details.
Bank account number, mobile wallet MSISDN, Till/Paybill identifier, or other account identifier.
For mobile_money institutions, the API normalizes phone numbers before verification: strips +, removes a leading domestic 0, and adds the country dial code when missing (KES 254, UGX 256, TZS 255, GHS 233). Examples for KES M-Pesa — 0712345678, +254712345678, and 254712345678 all normalize to 254712345678.
KES Till/Paybill identifiers are not normalized when metadata indicates Till/Paybill, or when the value looks like Paybill (business|reference) or Till (fewer than 9 digits).