AinePay for WooCommerce

AinePay for WooCommerce lets your store accept non-custodial stablecoin payments (USDT / USDC) through AinePay.

When a customer chooses AinePay at checkout, the plugin creates an order with AinePay and shows the customer a payment address. Crucially, the plugin verifies locally — without trusting the server — that the address is deterministically derived (via CREATE2) from your own collection address. If verification fails, the address is never shown and the order is marked failed. This protects you from a tampered backend ever diverting funds.

Order status is guaranteed by active AinePay order polling. Signed webhooks speed up updates but are not the only source of truth.

Features

• Non-custodial USDT / USDC payments; funds settle to your own collection address.
• Local CREATE2 address verification before any address is displayed.
• HMAC-SHA256 request signing and webhook signature verification.
• Classic checkout and Cart/Checkout Blocks support.
• HPOS (High-Performance Order Storage) compatible.
• QR code, copy-to-clipboard, countdown, and live status on the order page.
• Active order polling for final consistency; signed webhooks accelerate updates.

How payments are reused

AinePay does not issue automatic refunds or custody the underlying funds. If a
payment is late or the window expires, AinePay may record the amount as a
reusable ledger credit. A logged-in customer who places another order applies
that credit automatically. Guest orders are not linked across orders, so a
guest credit cannot be reused automatically.

External services

This plugin connects to the AinePay API to create orders, fetch supported coins,
and query order status. It is required for the plugin to function.

• What is sent: your API key (in a request header), an HMAC signature, a
  timestamp, the order amount, the selected coin/chain, a site-namespaced order
  identifier, and a pseudonymous user identifier derived as
  sha256(site + “|” + customer id) for logged-in customers, or a
  per-order key for guests. No email address or other personal data is sent.
• When: when a customer places an AinePay order, when you save settings
  (to load supported coins), and when order status is queried.
• Endpoints: https://api.ainepay.com. Additional HTTPS test hosts require an explicit developer allowlist filter.
• AinePay also sends signed webhooks to https://your-site/ainepay/notify.

Service provider: AinePay — https://ainepay.com
Terms: https://ainepay.com/en/terms — Privacy: https://ainepay.com/en/privacy

Usage

1. Open WooCommerce > Settings > Payments > AinePay.
2. Enter your AinePay API Key, API Secret, Notify Secret, Merchant ID, Collection Address, and forwarder contract parameters.
3. Save the settings, then enable the supported coin/chain pairs you want to offer.
4. Set the AinePay dashboard notification URL to your site base URL, for example https://example.com. AinePay will call https://example.com/ainepay/notify. Webhook only accelerates updates; active polling guarantees final status.
5. Click “Test connection & configuration” to verify API reachability and local address verification.
6. Customers select AinePay at checkout, choose a coin/chain, and place the order. The plugin verifies the payment address locally before showing the address, QR code, countdown, and live status.
7. The plugin actively queries AinePay order status. Confirmed payments move the WooCommerce order to processing or completed; expired payments move it to failed.

Late payments are not refunded by AinePay. Signed-in customers can reuse their remaining balance on a later order because their identity is derived from their authenticated WordPress customer account. Guest orders use a per-order identity and cannot automatically reuse a balance; the customer should contact the store if they paid late.

Third-party fulfilment integrations

Third-party integrations must not fulfil AinePay orders based only on the
WooCommerce processing or completed status. Use the
ainepay_order_paid_backed action, or confirm
Ainepay_Order_Sync::is_paid_backed_order( $order ) returns true, before
shipping goods or granting access.

Support

This plugin is developed and maintained by AinePay (https://ainepay.com).
For help, questions, or to report an issue, contact [email protected] or open
an issue at https://github.com/ainepay/ainepay-for-woocommerce/issues.