Track Invoice Issuance Status

API to track e-invoice issuance status using the tracking_code returned from the issue request.

API Endpoint

GET

https://einvoice-api-sandbox.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.
When status is Pending, you should call the API again after a few seconds to check the result.

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": "2025-12-15",
      "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"
      },
      "total_before_tax": 200000,
      "tax_amount": 20000,
      "total_amount": 220000,
      "notes": "Ghi chú hóa đơn"
    }
  }
}

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-sandbox.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-5 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.