Xác thực Merchant

Quy trình

• MERCHANT gọi API để lấy JWT Token. Token này dùng chung cho tất cả các dịch vụ B2B của Baokim (VA, QRPay/QRGlobal...).
• Token có thời hạn ngắn — cần implement logic tự động refresh khi hết hạn.

Thông tin API

Method: POST

URL: /b2b/auth-service/api/oauth/get-token

Request

Bảng tham số chính

STT	Tên trường	Kiểu dữ liệu	Bắt buộc	Mô tả
1	merchant_code	String(50)	✅	Mã Merchant do Baokim cung cấp
2	client_id	String(50)	✅	Client ID của Merchant do Baokim cung cấp
3	client_secret	String(50)	✅	Client Secret của Merchant do Baokim cung cấp

Ví dụ Request

{
  "merchant_code": "BAOKIMMRC",
  "client_id": "BAOKIMMRC",
  "client_secret": "iOiJKV1QiLCJhbGciOiJIUzI1NiJ9"
}

Response

Bảng tham số chính

STT	Tên trường	Kiểu dữ liệu	Bắt buộc	Mô tả
1	code	Number(3)	✅	Mã lỗi của Baokim
2	message	String(200)	✅	Thông báo mã lỗi của Baokim
3	data	Object	✅	Dữ liệu Baokim trả về

Thông tin data

STT	Tên trường	Kiểu dữ liệu	Bắt buộc	Mô tả
1	access_token	String	✅	Chuỗi JWT Token
2	token_type	String	✅	Loại token
3	expires_at	DateTime	✅	Thời gian hết hạn Token

Ví dụ Response

{
  "code": 100,
  "message": "Successfully",
  "data": {
    "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0OjkyOTIvYXBpL2IyYl9hdXRoL2xvZ2luIiwiaWF0IjoxNzA2MDgwODU1...",
    "token_type": "bearer",
    "expires_at": "2026-06-30 14:41:00"
  }
}

Bảng mã lỗi

Mã lỗi	Mô tả
100	Thành công
11	Thất bại
101	Lỗi hệ thống Baokim
103	Lỗi xác thực chữ ký
104	Lỗi xác thực JWT
422	Dữ liệu không hợp lệ (sai định dạng, thiếu trường bắt buộc)