Bank Name Verification
Looks up the registered holder name on the bank for the given
account number and compares it with the name you send.
A completed check is billed (pricing=PAID), including when the
account is not found. Validation errors and service failures are
not billed (pricing=FREE).
This feature must be enabled on your account. If it is not, the
API returns UNAUTHORIZED.
Outcomes
| Result | Response |
|---|---|
| Account found | code=SUCCESS, data.status="found", pricing=PAID |
| No account at this bank | code=SUCCESS, data.status="not found", suggestion=reject, pricing=PAID |
| Temporary service issue | code=SERVER_ERROR, pricing=FREE |
Invalid request (account, bank, name, or request_id) | code=CLIENT_ERROR, pricing=FREE |
Same request_id with a different body | code=DUPLICATE_REFERENCE, pricing=FREE |
| Missing token, feature not enabled, or IP not allowlisted | code=UNAUTHORIZED, pricing=FREE |
| Prepaid balance too low | code=INSUFFICIENT_BALANCE, pricing=FREE |
Account numbers
You may include spaces, dashes, dots, or underscores. We ignore those characters. After that, the number must be 6–20 digits.
Bank codes
bank_code is a 3-digit Indonesian clearing code from the
supported-banks list in the dashboard. Values such as 2 or 14
are accepted and padded to 002 / 014. An unknown or disabled
code returns CLIENT_ERROR (not not found).
Idempotency
Use a unique request_id for each new check (UUID v4 is
recommended). Repeating the same request_id with the same body
returns the original result and is billed once — unless the
previous attempt did not complete, in which case the check runs
again. A different body with the same request_id returns
DUPLICATE_REFERENCE.
Authorizations
Body
Response
Check complete (whether the account exists or not). code is
SUCCESS. Read data.status and data.suggestion for the
outcome. pricing is PAID.
