Webhook Trạng Thái KYC

Đường dẫn

• URL: Đường dẫn do khách hàng định nghĩa
• Method: POST
• Mô tả: API được dùng để nhận thông báo về trạng thái quy trình KYC.

Request

Bảng Request từ Baokim

Tham số	Kiểu dữ liệu + Độ dài	Bắt buộc	Mô tả
request_id	string(50)	Có	Mã ID duy nhất cho mỗi request từ khách hàng đến Baokim
request_time	string(19)	Có	Thời gian gửi request. Định dạng: YYYY-MM-DD HH:MM:SS
merchant_code	string(20)	Có	Merchant code được cung cấp bởi Baokim
sub_merchant_code	string(20)	Có	Mã sub-merchant. Nếu seller trực thuộc merchant, điền merchant_code
seller_id	string(50)	Có	Mã Seller trong hệ thống merchant
status	string(1)	Có	2: KYC thành công 3: KYC thất bại 4: Cần tài liệu bổ sung
reason	string(255)	Không	Lý do sẽ có sẵn khi status = 3 hoặc 4

Ví dụ Request

{
  "request_id": "BK009373788182HUYLLAPU",
  "request_time": "2024-11-01 14:00:00",
  "merchant_code": "MERCHANT001",
  "sub_merchant_code": "MERCHANT001",
  "seller_id": "SELLER123456",
  "status": "2",
  "reason": ""
}

Response

Bảng Response

Tham số	Kiểu dữ liệu + Độ dài	Bắt buộc	Mô tả
response_code	int(4)	Có	Mã lỗi từ Baokim theo Bảng Mã Lỗi
response_message	string(100)	Có	Mô tả mã lỗi từ Baokim theo Bảng Mã Lỗi

Ví dụ Response

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

Mã Lỗi

Mã Response	Thông báo Response
200	Thành công
11	Thất bại
101	Lỗi Hệ thống