YS CART – SmilePay Fast Purchase Electronic Invoice
Electronic invoices are automatically issued upon order confirmation, handling carriers, donations, and cancellations all at once.
On the e-commerce platforms in Taiwan, an electronic invoice must be issued for every order. This extension integrates SmilePay's electronic invoicing service into YS CART. After an order is placed, it automatically issues invoices, updates their status, and handles cancellations and reissuance. All of this is done within the backend, eliminating the need to manually process orders in the SmilePay backend.
Auto-issuance, rules set by yourself
You can set timings such as "automatically issue invoices when orders are processed" or have completely manual control. The checkout page offers individual/corporate invoice options and supports mobile barcode carriers, natural person certificates, and charitable donations. If the YS CART core has site-wide invoice rules set, those rules will take precedence, ensuring no conflicts with multiple vendors.
Test Mode with Full Logs
Provide a test mode (connecting to the quick purchase test endpoint, no real invoices generated) for full practice of issuance and voiding processes before going live. All API interactions are logged for easy troubleshooting. Invoice details and statuses are managed centrally in the YS CART invoice list.
功能特色
Automatic opening timing
Automatically open based on order status (e.g., changed to processing), or switch to fully manual.
Individual/Company Invoice
On the checkout page, select the invoice type. Company invoices support uniform invoice numbers and company names.
Vehicles and Donations
Mobile barcode, personal certificate carrier, and love code donations are all supported.
Cancellation management
The backend will directly void the invoice and reissue it, with the status immediately written back.
Test mode
End-to-end practice for connecting Speed Buy's test endpoint, without generating real invoices.
Invoice List and Log
Invoice details are centrally managed, and API transaction logs are complete and traceable.
畫面截圖
更新日誌（最新版）
v1.0.6
Fixed
- Blank storage no longer clears unresolvable CAPTCHAsAfter fail-closed v1.0.5, when a user enters the settings page but presses save without re-entering the password, the password will be left blank, and retain will overwrite the raw encrypted blob with an empty string after decryption. This causes the guiding prompts to disappear silently, and the provider becomes unavailable without any notification. In this version, `preserve_unusable_verify_key()` preserves the raw envelope when left blank, and `encrypt_verify_key()` does not re-encrypt the existing envelope. The admin fallback `decrypt_verify_key()` consistently fail-closes.
Changed
- Change the backend prompt to use "verify_key is not empty after decryption" as the general judgment criterion, covering both "cannot decrypt (site migration)" and "missing (not set)" scenarios. Messages will be customized for each case, and will continue to be displayed even if raw is cleared.
Tests
- Regression v108; Local three-scenario verification: blank-save retain + notice persistent / vacuum -> no guide set / normal -> no false positives; dev normal key no false positives.
See `CHANGELOG.md` for complete changes.
常見問題
What account is needed?
To apply for the electronic invoice service with Sugoi Buy, please fill in the settings page with your invoice account (Grvc) and verification code after obtaining them. You can first practice in test mode using the official trial account.
When will the invoice be issued?
Automatically issue at the timing you set (e.g., when an order status changes to "Processing"), and you can also issue it manually on the order page.
Can it be voided if it's opened incorrectly?
Yes, it can. The backend can void it with one click and reopen it, with the status and number fully recorded.
Will it conflict with other invoice suppliers?
No. YS CART is uniformly managed under the "invoice vendor" framework, and even if multiple vendors are installed, invoices will only be issued by the enabled rules.
