Linux 软件免费装
Banner图

HENO Tingee Gateway for WooCommerce

开发者 heno
cuongnguyenba
更新时间 2026年6月17日 17:42
PHP版本: 7.2 及以上
WordPress版本: 6.7
版权: GPLv2 or later
版权网址: 版权信息

标签

payment woocommerce qr code bank transfer vietqr

下载

1.0.0

详情介绍:

HENO Tingee Gateway for WooCommerce connects your WooCommerce store to the Tingee payment infrastructure by HENO, allowing customers to pay via bank transfer (VietQR) with automatic order confirmation — no manual reconciliation needed. How it works Mode A — QR + Webhook (default)
  1. Customer selects "Tingee" at checkout.
  2. Plugin generates a QR code linked to the order.
  3. Thank-you page displays the QR code, account number, amount, and transfer reference.
  4. Customer scans and transfers → Tingee sends a Webhook (IPN) to your site.
  5. Plugin verifies the signature, matches the transaction, and automatically marks the order as paid — within 5–15 seconds.
Mode B — Redirect
  1. Customer selects Tingee → plugin creates a Checkout URL via Tingee API.
  2. Customer is redirected to Tingee's hosted payment page.
  3. After payment → redirected back to your site; Webhook confirms the order.
Key Features Requirements

安装:

Automatic installation
  1. Log in to your WordPress admin panel.
  2. Go to Plugins > Add New.
  3. Search for HENO Tingee Gateway for WooCommerce.
  4. Click Install Now, then Activate.
Manual installation
  1. Download the plugin zip file.
  2. Go to Plugins > Add New > Upload Plugin.
  3. Choose the zip file and click Install Now, then Activate.
Configuration
  1. Go to WooCommerce > Settings > Payments.
  2. Find Tingee Gateway and click Manage.
  3. Fill in the following fields:
  4. Environment — choose Sandbox for testing or Production for live.
  5. Client ID — from your Tingee developer dashboard.
  6. Secret Token — from your Tingee developer dashboard.
  7. VA Account Number — your merchant virtual account number.
  8. Bank BIN — the BIN code of the bank that holds your VA.
  9. Integration Mode — Mode A (QR + Webhook) or Mode B (Redirect).
  10. Click Test Connection to verify your credentials.
  11. Copy the Webhook URL displayed in the settings and paste it into your Tingee developer dashboard under Webhook configuration.
  12. Save settings.

屏幕截图:

  • **QR code on thank-you page** — shows QR image, account number, amount, and transfer reference with copy buttons.
  • **Plugin settings page** — Client ID, Secret Token, environment, VA account number, integration mode, and connection test button.
  • **Webhook URL field** — read-only URL to copy into your Tingee developer dashboard.
  • **Order confirmed** — thank-you page automatically updates to "Payment successful" after Webhook IPN is received.

升级注意事项:

1.0.0 Initial release — no upgrade steps required.

常见问题:

Where do I get my Client ID and Secret Token?

Log in to your Tingee merchant account at app.tingee.vn, navigate to the Developers section, and copy your Client ID and Secret Token.

What is the Webhook URL and where do I put it?

The Webhook URL is shown in the plugin's settings page (read-only field). Copy it and paste it into your Tingee developer dashboard under the Webhook / IPN configuration section. Tingee will send payment notifications to this URL.

Do I need ngrok or a public URL to receive webhooks?

Yes, during local development you need a tool like ngrok to create a public URL that Tingee can reach. On a live server with a real domain name, no extra setup is needed.

The QR code says "Dynamic QR not supported" — what do I do?

Some Tingee accounts have dynamic QR disabled by default. The plugin automatically falls back to Static QR (VietQR standard). In this mode, order matching relies on the transfer reference (order number) in the payment description rather than a bill ID. Contact Tingee support to enable dynamic QR for your account.

What happens if a customer sends the wrong amount?

If the transferred amount is less than the order total, the plugin keeps the order in On-Hold status and adds an admin note with the received amount. You can review and handle partial payments manually. Over-payments follow the same flow — the order is marked paid and the discrepancy is noted.

Is it safe? Can someone fake a webhook?

Every webhook is verified using HMAC-SHA512 with your Secret Token. Any request with an invalid or missing signature receives a 401 Unauthorized response and the order is never modified. Replay attacks are also prevented: each transaction ID is stored after processing, so resending the same webhook has no effect.

Does it work with the new WooCommerce Checkout Blocks?

Yes. The plugin registers a Blocks-compatible payment method via AbstractPaymentMethodType, so it appears correctly in both the classic shortcode checkout and the new block-based checkout.

Is it compatible with WooCommerce High-Performance Order Storage (HPOS)?

Yes. All order data is read and written using wc_get_order(), $order->get_meta(), and $order->update_meta_data() — fully compatible with HPOS.

Can I use both Sandbox and Production at the same time?

No. The Environment setting applies globally. Switch to Production only when you are ready to accept real payments.

Will my settings be deleted if I deactivate the plugin?

No. Settings are preserved when you deactivate. They are only removed when you delete the plugin, and only if the "Delete data on uninstall" option is enabled in settings.

更新日志:

1.0.0