Xác thực Merchant

Quy trình

MERCHANT gọi API để lấy JWT Token.

Thông tin API

Method: POST

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

Request

(Tham số Đối tác gửi lên)

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	expired_at	DateTime	✅	Thời gian hết hạn Token

Ví dụ Response

{
  "code": 100,
  "message": "Successfully",
  "data": {
    "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0OjkyOTIvYXBpL2IyYl9hdXRoL2xvZ2luIiwiaWF0IjoxNzA2MDgwODU1LCJleHAiOjE3MDYwODQ0NTUsIm5iZiI6MTcwNjA4MDg1NSwianRpIjoiV0FUWnpJZTB3d0NuU1dpNSIsInN1YiI6IjEiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3IiwibWVyY2hhbnRfaW5mbyI6eyJjb2RlIjoiYWJjIn0sInNjb3BlcyI6W3siYWN0aW9uIjoiR0VUIiwidXJpIjoiYWJjLmNvbSJ9LHsiYWN0aW9uIjoiUE9TVCIsInVyaSI6Inh5ei5jb20ifV19.aRfdvwFz8CDiBqHoCG8IGfPC0bO4vhXRvY76dupRx9k.",
    "token_type": "bearer",
    "expired_at": "2025-10-30 14:41:00"
  }
}

Error Codes

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ệ
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