Huỷ thu hộ tự động

Quy trình

Mô tả:

• Merchant gọi API này để huỷ thu hộ tự động.

Thông tin API

Method: POST

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

Request

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 Baokim cung cấp
4	sub_merchant_code	String	✅	Mã sub merchant Baokim cung cấp
5	url_success	String	✅	URL redirect khi huỷ thành công
6	url_fail	String	✅	URL redirect khi huỷ thất bại
7	token	String	✅	Token thẻ/tài khoản thu hộ tự động

Ví dụ Request

{
  "request_id": "RQID0001",
  "request_time": "2023-08-18T10:00:00.000Z",
  "master_merchant_code": "BAOKIMMASTERMERCHANT",
  "sub_merchant_code": "BAOKIMSUBMERCHANT",
  "url_success": "https://baokim.vn/cancel/success",
  "url_fail": "https://baokim.vn/cancel/fail",
  "token": "Mq7AwLoHkafPdXYxvYedH8sb6MZ18k"
}

Response

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ả: 101 = Cần redirect để xác thực OTP
2	message	String	✅	Thông báo
3	data	Object	✅	Dữ liệu trả về

Thông tin data

STT	Tham số	Kiểu dữ liệu	Bắt buộc	Mô tả
1	created_at	Datetime	✅	Thời gian yêu cầu
2	updated_at	Datetime	✅	Thời gian cập nhật
3	redirect_url	String	✅	Link trang xác thực OTP huỷ thu hộ tự động

Ví dụ Response

{
  "code": 101,
  "message": "Thành công",
  "data": {
    "created_at": "2025-04-14 15:23:10",
    "updated_at": "2025-04-14 15:23:10",
    "redirect_url": "https://b2b-payment-page.devtest.baokim.vn/cancel/verify?checksum=50f1c60363c29c19b1c18359f1b4cfc655165117"
  }
}

Error Codes

Mã lỗi	Mô tả
104	Lỗi xác thực
710	Sub Merchant không tồn tại
711	Master Merchant không tồn tại
712	Sub Merchant đang không hoạt động
713	Master Merchant đang không hoạt động
714	Sub Merchant không thuộc Master Merchant