Track Invoice Issuance Status API

API Endpoint

GET

https://einvoice-api.sepay.vn/v1/invoices/issue/check/{tracking_code}

API Request

tracking_codestringrequired

Tracking code returned from the invoice issue API

Processing Status

The API returns one of the following statuses:

Status	Description
`Pending`	Processing - The system is processing the issuance request
`Success`	Completed - The invoice has been successfully issued
`Failed`	Failed - An error occurred during the issuance process

Note

tracking_code is obtained from the response of the Issue eInvoice API.
When status is Success, the invoice object will contain complete information about the issued invoice.
A request that hits a transient error is retried automatically, so it may stay Pending for up to 2 hours rather than finishing within seconds. Use retry.next_retry_at in the response to space out your calls, and stop only when status becomes Success or Failed.
If message reads "Hệ thống chưa xác nhận được kết quả phát hành với nhà cung cấp hóa đơn", the invoice state is unconfirmed. Do not resubmit - contact SePay to verify, to avoid issuing a duplicate invoice.
For the retry schedule, the diagnostic steps and what to check before resending, see Error Handling.

API Response

Success Response (200)

{
  "success": true,
  "data": {
    "reference_code": "084e179d-d95a-11f0-aef4-52c7e9b4f41b",
    "status": "Success",
    "message": "Xuất bán hóa đơn điện tử thành công",
    "invoice": {
      "reference_code": "084e179d-d95a-11f0-aef4-52c7e9b4f41b",
      "invoice_number": "589",
      "issued_date": "2026-01-26",
      "pdf_url": "https://beta-portalv2.mifi.vn/DownloadPDFCA.aspx?kk=1434747710&keyinv=...",
      "xml_url": null,
      "status": "issued",
      "buyer": {
        "name": "Công ty ABC",
        "tax_code": "0101234567",
        "address": "123 Đường A, Quận B, Hà Nội",
        "email": "buyer@example.com",
        "phone": "0900000000"
      },
      "seller_store": {
        "xid": "8f14e45f-ceea-4b6d-9c1a-2b3c4d5e6f70",
        "code": "CN01",
        "name": "Chi nhánh 1"
      },
      "total_before_tax": 200000,
      "tax_amount": 20000,
      "total_amount": 220000,
      "notes": "Ghi chú hóa đơn",
      "source": "api"
    }
  }
}

successboolean

dataobject

Error Handling

400Bad Request

Missing or invalid tracking_code.

401Unauthorized

Missing or invalid Bearer token.

404Not Found

Issuance request not found for the given tracking_code.

Code Examples

curl --request GET \
  --url https://einvoice-api.sepay.vn/v1/invoices/issue/check/084e179d-d95a-11f0-aef4-52c7e9b4f41b \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Next Steps

Depending on the status result:

If status is Success:

Download Invoice - Download the PDF or XML file of the issued invoice
Invoice Details - View detailed invoice information (invoice number, issue date, file URLs...)
Invoice List - Manage and query issued invoices

If status is Pending:

Wait and call this API again after 2-3 seconds to check the result

If status is Failed:

Check the message for the error reason, fix the information and try issuing again or contact SePay for assistance.