HENO Tingee Gateway for WooCommerce

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

• Automatic order confirmation via Webhook IPN — no manual checking.
• VietQR display on the thank-you page with one-click copy for account number, amount, and transfer reference.
• HMAC-SHA512 signature verification for every webhook — forged requests are rejected with 401.
• Idempotency protection — retried webhooks (up to 5 times) never double-charge an order.
• Dual integration modes — admin selects QR+Webhook or Redirect in settings.
• Checkout Blocks compatible — works with both classic shortcode and the new WooCommerce Checkout Blocks.
• HPOS compatible — supports WooCommerce High-Performance Order Storage.
• WC Logger integration — webhook activity logged under WooCommerce > Status > Logs (tingee-webhook), secrets masked.
• Connection test button — verify your Client ID and Secret Token before going live.
• Vietnamese and English translations included.

Requirements

• WordPress 5.6 or higher
• WooCommerce 5.0 or higher
• PHP 7.2 or higher
• A Tingee merchant account with Client ID and Secret Token

External Services

This plugin connects to the Tingee payment API (operated by HENO) to generate QR codes, create payment links, and verify Webhook (IPN) notifications when a payment is completed.

Data sent to Tingee:

• Order amount, order ID, and transfer reference — sent when creating a payment QR or checkout URL.
• No customer personal data (name, email, address) is forwarded to the Tingee API by this plugin.

When data is sent:

• When the customer places an order and clicks “Pay” — the plugin calls the Tingee API to generate a QR code or hosted payment URL.
• When Tingee sends a Webhook to your site (this is incoming data from Tingee, not outgoing).

Tingee API endpoints used:

• Production: https://open-api.tingee.vn
• Sandbox (UAT): https://uat-open-api.tingee.vn

By using this plugin, your store connects to Tingee’s infrastructure. Please review Tingee’s policies before going live:

• Terms of Service
• Privacy Policy

For developer documentation, visit https://developers.tingee.vn.