Skip to main content

Tax & E-Invoice Configuration

Configure Vietnamese VAT collection and connect an e-invoice provider to automatically issue invoices after payment.

Overview​

The tax system supports:

  • VAT calculation — Automatically apply 8% or 10% VAT to transactions
  • E-invoice issuance — Auto-generate legal invoices via MISA or SePay after payment
  • Buyer billing info — Collect company name, tax code, and address at checkout

Enabling Vietnamese VAT​

  1. Go to Settings > Payment Gateway
  2. Open the Tax & E-Invoice section
  3. Toggle Enable VAT
  4. Fill in your business information:
FieldDescriptionExample
Tax Code (MST)Your company's tax identification number (10–13 digits)0123456789
Legal NameRegistered business name on tax certificateCông ty TNHH ABC
Business AddressRegistered address123 Nguyễn Huệ, Q.1, TP.HCM
  1. Configure VAT settings:
SettingOptionsDescription
VAT Rate8% or 10%Standard rate applied to all transactions
VAT BehaviorExclusive or InclusiveExclusive: VAT added on top of price. Inclusive: VAT already included in displayed price
  1. Save changes

How VAT Appears at Checkout​

Exclusive (VAT added on top):

  • Product price: 1,000,000₫
  • VAT (10%): 100,000₫
  • Total: 1,100,000₫

Inclusive (VAT included in price):

  • Product price: 1,100,000₫ (includes VAT)
  • VAT portion (10%): 100,000₫
  • Total: 1,100,000₫

E-Invoice Providers​

After enabling VAT, connect an e-invoice provider to automatically issue invoices.

ProviderInvoice FlowBest For
SePaySingle-step (instant)Quick setup, Vietnamese bank users already on SePay
MISAThree-step (create → sign → publish)Enterprises needing HSM digital signing and tax authority submission

Connecting SePay E-Invoice​

Prerequisites: Active SePay account with e-invoice feature enabled.

  1. In Tax & E-Invoice, select SePay as e-invoice provider
  2. Enter your SePay E-Invoice API Token (from SePay dashboard)
  3. Click Test Connection to verify
  4. Toggle Auto-issue invoices to enable automatic issuance after payment
  5. Save

How it works:

  • After a successful payment, Uni8 calls SePay's e-invoice API
  • Invoice is created instantly with buyer info and line items
  • Invoice URL and tracking code are stored in the transaction record
  • Buyer receives the invoice link

Connecting MISA E-Invoice​

Prerequisites: Active MISA e-invoice account with API access.

  1. In Tax & E-Invoice, select MISA as e-invoice provider
  2. Enter your MISA API Token (Bearer token from MISA portal)
  3. Choose Signing Method:
    • HSM — Automatic digital signing via MISA's cloud HSM (recommended)
    • USB — Manual signing with USB token (requires manual step)
  4. Click Test Connection to verify
  5. Toggle Auto-issue invoices to enable
  6. Save

How MISA's three-step flow works:

  1. Create — Draft invoice is created in MISA
  2. Sign — Invoice is digitally signed (HSM: automatic, USB: manual)
  3. Publish — Signed invoice is submitted to Vietnam's tax authority

All three steps happen automatically when HSM signing is selected.

Buyer Billing Information​

When VAT is enabled, the checkout form collects additional billing info from buyers:

  • Company/Full Name — Buyer's legal name for the invoice
  • Tax Code — Buyer's MST (optional for individuals)
  • Address — Buyer's billing address
  • Phone — Contact number

This information is saved to the member's profile and reused for future purchases.

Viewing Invoices​

For Admins​

  • Go to Administration > Financial
  • Each transaction shows invoice status: Pending, Issued, or Failed
  • Click on a transaction to view the invoice URL and tracking code

For Members​

  • Invoice link is included in the payment confirmation
  • Members can access past invoices from their transaction history

Important Notes​

  • E-invoice issuance is non-blocking — if the invoice API fails, the payment still succeeds
  • Failed invoices can be retried from the transaction detail page
  • VAT amounts are recorded in the taxAmount field of each transaction
  • Both providers support the standard Vietnamese e-invoice format
Ask AI Assistant