/verify/bankcard_check
1.API Specification
2.Request Params
3.Response Params
4.Error Codes
5.Sample
1.API Specification
This API is used to verify Indonesian bankcard number and name.
Request Method
POST
Request URL
https://cloudapi.indonesia.accuauth.com/verify/bankcard_check
Debugging Tool
2.Request Params
| Parameter |
Type |
Required |
Description |
| X-DF-API-ID |
string |
Yes |
For API credentials，Please visit API Request |
| X-DF-API-SECRET |
string |
Yes |
For API credentials，Please visit API Request |
2.2 Request Body
| Required |
Fields |
Type |
Description |
| required |
account |
string |
Number of the bankcard |
| required |
code |
string |
Code of bank. See the list at Bank code list |
| required |
name |
string |
Name of the card holder |
2.2.1.Bank code list
| Bank Code |
Bank Name |
| 002 |
Bank BRI |
| 008 |
Bank Mandiri |
| 009 |
Bank BNI / Bank BNI Syariah |
| 011 |
Bank Danamon |
| 013 |
Bank Permata |
| 014 |
Bank BCA |
| 016 |
Bank Maybank |
| 022 |
Bank CIMB Niaga/Bank CIMB Niaga Syariah |
| 026 |
Bank Lippo |
| 028 |
Bank OCBC NISP |
| 031 |
CITIBANK |
| 147 |
Bank Muamalat |
| 153 |
Bank Sinarmas |
| 157 |
Bank Maspion |
| 200 |
Bank Tabungan Negara (BTN) |
| 422 |
Bank BRI Syariah |
| 426 |
Bank MEGA |
| 441 |
Bank BUKOPIN |
| 451 |
Bank Syariah Mandiri |
| 536 |
Bank BCA Syariah |
3.Response Params
| Fields |
Type |
Description |
| request_id |
string |
Unique id of each request |
| status |
string |
Response status, OK for success request, Error Codes for failed request |
| result |
object |
The verification result |
3.1 Elements in `result`
| Fields |
Type |
Description |
| real_name |
string |
Realname of the person |
| name_percent |
string |
The similarity between the real name and the name user provide, 0.9 or 1.0 is recommended |
Response Syntax
{
"status": "OK",
"result": {
"real_name": "JHON JUNIOR XXXXX",
"name_percent": 1.0
},
"request_id": "TID1c09629b0b99472caa99d0db54bcc5f6"
}
4.Error Codes
Common error codes of this API:
| Http Status Code |
Status Field |
Description |
400 |
INVALID_ARGUMENT |
Request parameter is invalid |
400 |
QUERY_FAILED |
Query failed |
400 |
ABNORMAL_BEHAVIOURS_DETECTED |
Request with same parameters repeated more than amount of times |
401 |
UNAUTHORIZED |
Unauthorized or access is denied |
401 |
KEY_EXPIRED |
Your API ID has expired |
403 |
NO_PERMISSION |
You are not authorized to use this API |
403 |
OUT_OF_QUOTA |
API calls quota exceeded |
403 |
RATE_LIMIT_EXCEEDED |
API request frequency exceeds the limit |
404 |
NOT_FOUND |
Requested API cannot be found |
500 |
INTERNAL_ERROR |
Internal server error |
512 |
SOURCE_SERVICE_UNAVAILABLE |
Source service is unavailable |
513 |
SOURCE_SERVICE_TIMEOUT |
Source service is timeout |
Comment: Please see the reason field for details when the above 40X / 51X error occurred
Response Syntax
{
"status": "INVALID_ARGUMENT",
"reason": "argument 'id_number': not found",
"request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e"
}
5.Sample