Webhook huỷ thu hộ tự động

Quy trình

Mô tả:

• Sau khi nhận được kết quả huỷ thu hộ tự động từ Ngân hàng hợp tác, Baokim sẽ gửi webhook cho merchant.

Thông tin API

Method: POST

URL: /b2b/core/api/ext/mm/order/cancel

Header yêu cầu:

Header	Kiểu dữ liệu	Mô tả
Signature	string	Chữ ký số để xác thực tính toàn vẹn dữ liệu

Request

Tham số yêu cầu

(Baokim gửi tới Merchant)

Bảng tham số chính

STT	Tham số	Kiểu dữ liệu	Bắt buộc	Mô tả
1	request_id	String	✅	ID request
2	request_time	Datetime	✅	Thời gian request. Format: YYYY-MM-DD H:m:s
3	master_merchant_code	String(50)	✅	Mã master merchant
4	sub_merchant_code	String(50)	✅	Mã sub merchant
5	result_code	Integer	✅	Trạng thái huỷ thu hộ tự động
6	result_message	String	✅	Message
7	token_info	Object	❌	Thông tin token sau khi huỷ

Thông tin token (token_info)

STT	Tham số	Kiểu dữ liệu	Bắt buộc	Mô tả
1	token	String	✅	Chuỗi token thẻ lưu trên Baokim
2	status	Integer	✅	Trạng thái token: 1 = Active, 0 = Deactive

Ví dụ Request

{
  "request_id": "1e3fe73d3054904a9a4bb",
  "request_time": "2023-08-18 10:00:00",
  "master_merchant_code": "BAOKIMMASTERMERCHANT",
  "sub_merchant_code": "BAOKIMSUBMERCHANT",
  "result_code": 200,
  "result_message": "Thành công",
  "token_info": {
    "token": "Mq7AwLoHkafPdXYxvYedH8sb6MZ18k",
    "status": 0
  }
}

Response

(Merchant phản hồi lại Baokim)

Bảng tham số chính

STT	Tham số	Kiểu dữ liệu	Bắt buộc	Mô tả
1	code	Integer	✅	Mã kết quả. 0 = Merchant xử lý webhook thành công
2	message	String	✅	Thông báo kết quả xử lý
3	data	Object	❌	Dữ liệu trả về (nếu có)

Ví dụ Response

{
  "code": 200,
  "message": "Successfully",
  "data": null
}