Webhook

Mô tả quy trình

Baokim gửi webhook đến hệ thống đối tác với phương thức POST, dữ liệu được ký số theo cơ chế của mục Phương thức bảo mật. Baokim ghi nhận gửi webhook thành công trong trường hợp body response tồn tại tham số code nằm trong các giá trị 0, 100 hoặc 200 (Đối tác phản hồi là Thành công)

Các trường hợp webhook thất bại bao gồm:

• http_code là 4xx hoăc 5xx (Lỗi kết nối HTTP)
• http_code = 200 nhưng trong body response tồn tại code khác 0, 100 hoặc 200

Trường hợp webhook ghi nhận thất bại, Baokim sẽ thực hiện gửi lại webhook trong vòng 9 lần tiếp theo, giãn cách giữa các lần dựa theo dãy Fibonaci, ví dụ retry:

• Lần 1: sau 1 phút với lần gửi chính thức
• Lần 2: sau 2 phút với lần 1
• Lần 3: sau 3 phút với lần 2
• Lần 4: sau 5 phút với lần 3
• ...

Response

(Merchant trả lại cho Baokim)

ghi chú

HTTP 200 - Thành công

Bảng tham số chính

Tên trường	Kiểu dữ liệu	Bắt buộc	Mô tả
code	Integer	✅	0, 100 hoặc 200 = thành công, 99 = Baokim sẽ gửi lại webhook
message	String	✅	Nội dung phản hồi
data	Object	❌	Dữ liệu đính kèm (nếu có)

Ví dụ Response thành công

{
  "code": 100,
  "message": "Thành công",
  "data": { }
}

Ví dụ Response thất bại

{
  "code": 99,
  "message": "Thất bại",
  "data": { }
}

Error Codes

Mã lỗi	Mô tả
0, 100 hoặc 200	Thành công
99	Thất bại (cần retry)