Skip to main content

Webhook VA Status

API VA Flow

Path

  • URL: Partner provide url
  • Method: POST
  • Description: This webhook is triggered when there is a status update on a virtual account

Request

Request Table

ParamsData type + lengthRequiredDescription
request_idstring(50)YesUnique request ID, suggested format: MerchantCode+YYYYMMDDHHMMSS+UniqueId
request_timestring(19)YesRequest time in format: YYYY-MM-DD HH:MM:SS
reference_codestring(100)YesThe reference code of VA managed in your system
statusstring(10)Yes1: Active, 2: Inactive
acc_nostring(22)YesBank account number
reject_reasonstring(255)YesIn case of VA deactivation, Baokim will send the reason

Request Example

{
"request_id": "PARTNER12320231105123000ID01",
"request_time": "2023-11-05 12:30",
"reference_code": "ORDER1234567890123456789012345",
"status": 1,
"acc_no": "12345678901234567890",
}

Response

Response Table

ParamsData type + lengthRequiredDescription
response_codeint(4)YesError code from Baokim as per Error Codes Table
response_messagestring(100)YesDescription of the error code from Baokim as per Error Codes Table

Response Example

{
"response_code": 200,
"response_message": "Success"
}

Error Code

Response CodeResponse Message
200Success
11Failed
101System Error