Tạo Token xác thực

API tạo Bearer token để xác thực các API calls tiếp theo. Token có thời hạn 24 giờ.

API Endpoint

POST

https://einvoice-api-sandbox.sepay.vn/v1/token

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 86400 giây (24 giờ)
Sử dụng token này cho header Authorization: Bearer {access_token} trong các API tiếp theo

API Response

Response 200 - Tạo token thành công

{
  "success": true,
  "data": {
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "token_type": "Bearer",
    "expires_in": 86400
  }
}

successboolean

dataobject

Xử lý lỗi

400Bad Request

Thiếu hoặc sai định dạng tham số.

401Unauthorized

Sai thông tin client_id hoặc client_secret.

Response 401 - Unauthorized

{
  "success": false,
  "error": {
    "code": "BAD_REQUEST",
    "message": "Thiếu hoặc sai định dạng trường bắt buộc."
  }
}

Code mẫu

curl --request POST \
  --url https://einvoice-api-sandbox.sepay.vn/v1/token \
  --header 'Authorization: Basic REPLACE_BASIC_AUTH'

Sử dụng token

Sau khi lấy được access_token, sử dụng nó trong header của các API eInvoice khác:

JSSử dụng Bearer Token

// Thêm token vào header Authorization
const headers = {
'Authorization': 'Bearer ' + access_token,
'Content-Type': 'application/json'
};
 
// Gọi API eInvoice khác
const response = await fetch('https://einvoice-api.sepay.vn/v1/invoices', {
method: 'GET',
headers: headers
});

Bước tiếp theo

Sau khi có access token, bạn có thể:

Xem danh sách tài khoản - Lấy danh sách tài khoản nhà cung cấp hóa đơn điện tử để chọn tài khoản sử dụng
Kiểm tra hạn ngạch - Xem số lượt phát hành hóa đơn còn lại trong gói dịch vụ
Xuất hóa đơn điện tử - Bắt đầu tạo hóa đơn điện tử đầu tiên