API tạo Token xác thực

API Endpoint

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ý)

API Response

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

Xử lý lỗi

{
  "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.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:

// 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ể:

1. 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
2. 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ụ
3. Xuất hóa đơn điện tử - Bắt đầu tạo hóa đơn điện tử đầu tiên