Issue Invoices with ezPay

Overview

ezPay Electronic Invoicing is an electronic invoicing value-added service platform under the NewebPay Group in Taiwan (applicable to stores with a "Business Location" in Taiwan TW and "Store Currency" in New Taiwan Dollar TWD).

In Kanorio, the integration with ezPay electronic invoicing is independent of your payment gateway: regardless of whether your customers pay via PAYUNi, SHOPLINE Payments, LINE Pay, or JKO Pay, the system will automatically call the ezPay interface to complete invoice issuance, cancellation, or allowance upon successful payment or refund.

---

3 Essential Preparations in the ezPay Dashboard (Avoid Common Pitfalls)

Many merchants encounter the issue where "the credential connection test passes, but the first invoice fails to issue" when integrating ezPay. Before returning to Kanorio to enter your keys, please ensure you have completed the following 3 steps in the ezPay Electronic Invoicing Platform:

1. Submit the "Fee Plan Application" to Activate the Contract (Most Commonly Missed!)

Why does the connection test pass, but issuance fails (Error Code INV90005)? The ezPay "Query API (used for connection testing)" does not check contract status, but the "Issuance API" strictly verifies whether you have applied for a fee plan. If this step is not completed, the system will return INV90005 (Contract not effective or expired) during actual issuance.

• Log in to the ezPay Electronic Invoicing dashboard › Go to "Invoice Management › Management Settings › Usage Status › Fee Plan Application", select the appropriate plan, and submit the application. Ensure the status is "Enabled".

2. Complete Ministry of Finance (MOF) Authorization and "Invoice Track Number Settings"

1. On the MOF Electronic Invoice Integration Service Platform, use your Business Certificate to authorize ezPay to handle your electronic invoice track number services.
2. Return to the ezPay dashboard › Go to "Invoice Management › Management Settings", enable "Authorize Download of New Tracks" and "Auto-upload Unused Blank Tracks", or go to "Invoice Track Number Settings" to ensure there are available numbers for the current bimonthly period.

3. Copy Merchant ID and 32-character HashKey / 16-character HashIV

1. In the ezPay dashboard, go to "Store Management › Details".
2. Copy the production environment information for the following 3 fields (Note: The ezPay test environment cinv.ezpay.com.tw and production environment inv.ezpay.com.tw are two independent systems. Keys are not interchangeable; please ensure you use the keys from the production environment inv.ezpay.com.tw):
   • MerchantID
   • HashKey (32 alphanumeric characters, for AES-256)
   • HashIV (16 alphanumeric characters)

---

Steps to Integrate and Enable ezPay Invoicing in Kanorio

1. Enter Credentials and Verify Connection

1. Go to your Kanorio dashboard "Store Settings › Invoices".
2. Click "Set Credentials" (or "Enable") on the "ezPay Electronic Invoicing" card.
3. Enter your 8-digit Business Tax ID, MerchantID, 32-character HashKey, and 16-character HashIV.
4. Click "Save": The system will immediately send a connection test to verify your keys. Once verified, the keys will be securely stored using Google Cloud KMS envelope encryption (see ).

2. Enable ezPay in "Invoice Management"

Click the "Invoice Management" button in the top right corner, drag ezPay Electronic Invoicing into the "Enabled" section, and save. It will take effect on your public checkout page immediately.

---

Customer Checkout Experience and Order "Invoice" Tab

1. Customer Checkout Invoice Options:
   • Supports Personal Cloud Invoices (default ezPay member carrier, mobile barcode, citizen digital certificate), Charity Donations (including 919 Genesis, 7585 Children Are Us, 25885 Taiwan Fund for Children and Families), and Corporate Invoices with Tax ID.
   • When a customer enters an 8-digit Tax ID, the system automatically queries the Ministry of Economic Affairs database to populate the "Company Name" and "Company Address" (ezPay requires the buyer's address for corporate invoices where PrintFlag=Y).
2. Automatic Issuance, Cancellation, and Instant Allowance Confirmation:
   • Invoices are issued automatically within 5 minutes of successful payment. Upon refund, the system automatically executes cancellation or allowance based on Taiwan's bimonthly reporting rules (ezPay allowance uses the Status=1 instant confirmation mode, requiring no manual confirmation from the buyer; see ).
3. View Invoices in the Order "Invoice" Tab:
   • Go to "Orders", open an order, and switch to the "Invoice" tab. You can click "Copy Invoice Info / Copy Allowance Info" or click "View Invoice" to jump directly to the official ezPay invoice inquiry page to see the full proof of invoice.

---

Troubleshooting Common Issuance Failures

Related Documents