Verify bank account

Path

• URL: /cb-core/api/v1/disbursement/verify-bank-account
• Method: POST
• Description: API verify bank account.

Request

Request Table

Params	Data Type	Required	Description
request_id	string(50)	Yes	The only code that corresponds to an upload request. Format: MerchantCode + BK + YYYYMMDD + UniqueId
request_time	string(19)	Yes	Time to send request from merchant, format: YYYY-MM-DD HH:MM:SS
merchant_code	string(20)	Yes	Merchant code provided by Baokim before integration
bank_no	string(6)	Yes	Bank no as per Baokim's list of remittance banks
acc_no	string(22)	Yes	Customer's account number or bank card number
acc_type	int(1)	Yes	Account classification: 0 for bank account number, 1 for bank card number

Request Example

{
  "request_id": "MerchantCodeBK20231106UniqueId",
  "request_time": "2024-11-06 10:15:30",
  "merchant_code": "MERCHANT1234",
  "bank_no": "001122",
  "acc_no": "1234567890123456789012",
  "acc_type": 0
}

Response

Response Table

Params	Data Type	Description
response_code	int(4)	Error code from Baokim as per Error Codes Table
response_message	string(200)	Description of the error code from Baokim as per Error Codes Table
request_id	string(50)	Merchant information posted
bank_no	string(6)	Merchant information posted
acc_no	string(22)	Merchant information posted
acc_type	int(1)	Merchant information posted
acc_name	string(50)	Account Name of requested account number, returned if the Account number and account bank are valid

Response Example

{
  "response_code": 200,
  "response_message": "Success",
  "request_id": "MerchantRequest12345",
  "bank_no": "001122",
  "acc_no": "1234567890123456789012",
  "acc_type": 0,
  "acc_name": "John Doe"
}

Error Code

Response Code	Response Message
200	Success
99	Pending
11	Failed
101	System Error
110	Merchant Code Invalid
120	Invalid Signature
422	Validation Error