Xác thực API

Quy trình

• MERCHANT gọi API để lấy JWT Token.
• Baokim sẽ xác thực trên Merchant tích hợp trực tiếp với Baokim:
  • Nếu Master tích hợp, thông tin xác thực sẽ sử dụng thông tin của Master.
  • Nếu Sub tích hợp, thông tin xác thực sẽ sử dụng thông tin của Sub.

Thông tin API

Method: POST

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

Request

Bảng tham số chính

Tên trường	Kiểu	Bắt buộc	Mô tả
merchant_code	String(50)	✅	Mã Merchant do Baokim cấp
client_id	String(50)	✅	Client ID do Baokim cấp
client_secret	String(50)	✅	Client Secret do Baokim cấp

Ví dụ resquest

{
  "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 (bearer)
3	expired_at	DateTime	✅	Thời gian hết hạn

Ví dụ response

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

Bảng mã lỗi Response Code

Mã lỗi	Mô tả
100	Thành công
11	Thất bại
101	Lỗi hệ thống Baokim
104	Lỗi xác thực Oauth
105	Lỗi xác thực chữ ký
422	Lỗi validate: RequestId không hợp lệ
422	Lỗi validate: RequestTime không hợp lệ
422	Lỗi validate: PartnerCode không hợp lệ
422	Card_data không hợp lệ
422	Amount không hợp lệ
301	Không tìm thấy đơn hàng theo order_code
302	Thẻ có vấn đề (không tồn tại, hết hạn)
303	Thẻ bị từ chối
304	Thẻ không đủ số dư
305	User huỷ giao dịch
306	Sai mã OTP
308	Giao dịch chưa thực hiện Authentication
309	Giao dịch chưa thực hiện Authorize
310	Giao dịch đã reversal — không thể capture
311	Giao dịch đã capture — không thể reversal
313	Lỗi xử lý phía ngân hàng