Tạo access token

API này dùng để lấy mã truy cập (access token) bằng cặp khóa Client ID và Client Secret do SePay cấp cho Partner. Mã truy cập này có thời hạn hiệu lực là 6000 giây (tức 100 phút).


API Endpoint

POST
https://speaker-api.sepay.vn/devices/v1/token/create

Xác thực

API này sử dụng Basic Authentication với thông tin đăng nhập:

  • Username: client_id (được cấp khi đăng ký)
  • Password: client_secret (được cấp khi đăng ký)
Lưu ý
  • Gửi yêu cầu với body rỗng (không cần request body)
  • Token có hiệu lực 6000 giây (100 phút)
  • Sử dụng token này cho header Authorization: Bearer {access_token} trong các API tiếp theo

Xử lý lỗi

401Unauthorized

Thông tin xác thực không hợp lệ hoặc bị thiếu

Code mẫu

>
>
>
curl --request POST \
--url https://speaker-api.sepay.vn/devices/v1/token/create \
--header 'Authorization: Basic REPLACE_BASIC_AUTH'

API Response

Response 201 - Tạo token thành công
{
  "code": 201,
  "message": "Resource created",
  "data": "—",
  "access_token": "eyJhbGciOi...",
  "ttl": 6000
}
codeinteger

Mã trạng thái phản hồi

messagestring

Mô tả kết quả thực thi

datastring

Dữ liệu trả về (có thể là "—" khi không có data)

access_tokenstring

Mã truy cập dùng cho các API khác

ttlinteger

Thời gian sống của access token (giây)