Truy Vấn Trạng Thái KYC

Đường dẫn

• URL: /cb-core/api/v1/seller/query-status
• Method: POST
• Mô tả: API cho phép truy vấn trạng thái KYC của seller

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

Ví dụ Request

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

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
merchant_code	string(20)	Có	Mã Merchant
seller_id	string(50)	Có	Mã Seller
status	string(1)	Có	1: Đang xử lý 2: KYC thành công 3: KYC thất bại 4: Cần tài liệu bổ sung 5: Tài liệu bổ sung đã được cung cấp.
reason	string(255)	Không	Lý do sẽ có sẵn khi status = 3 hoặc 4

Ví dụ Response

{
    "response_code": 200,
    "response_message": "Success",
    "merchant_code" :"MERCHANT001",
    "seller_id": "SELLER123456",
    "status": 1,
    "reason": ""
}

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
404	Không Tìm Thấy