Title: AinePay for WooCommerce
Author: ainepay
Published: <strong>July 19, 2026</strong>
Last modified: July 19, 2026

---

Search plugins

![](https://ps.w.org/ainepay-for-woocommerce/assets/icon-256x256.png?rev=3613503)

# AinePay for WooCommerce

 By [ainepay](https://profiles.wordpress.org/ainepay/)

[Download](https://downloads.wordpress.org/plugin/ainepay-for-woocommerce.0.1.0.zip)

 * [Details](https://wordpress.org/plugins/ainepay-for-woocommerce/#description)
 * [Reviews](https://wordpress.org/plugins/ainepay-for-woocommerce/#reviews)
 *  [Installation](https://wordpress.org/plugins/ainepay-for-woocommerce/#installation)
 * [Development](https://wordpress.org/plugins/ainepay-for-woocommerce/#developers)

 [Support](https://wordpress.org/support/plugin/ainepay-for-woocommerce/)

## Description

AinePay for WooCommerce lets your store accept **non-custodial** stablecoin payments(
USDT / USDC) through [AinePay](https://ainepay.com).

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 support@ainepay.com or open an issue at
https://github.com/ainepay/ainepay-for-woocommerce/issues.

## Screenshots

[⌊Configure the merchant profile, contract parameters, callback URL, API keys, and
collection addresses in the AinePay dashboard.⌉⌊Configure the merchant profile, 
contract parameters, callback URL, API keys, and collection addresses in the AinePay
dashboard.⌉[

Configure the merchant profile, contract parameters, callback URL, API keys, and
collection addresses in the AinePay dashboard.

[⌊Configure the AinePay payment gateway in WooCommerce, including API credentials,
collection address, contract parameters, supported coins, and diagnostics.⌉⌊Configure
the AinePay payment gateway in WooCommerce, including API credentials, collection
address, contract parameters, supported coins, and diagnostics.⌉[

Configure the AinePay payment gateway in WooCommerce, including API credentials,
collection address, contract parameters, supported coins, and diagnostics.

[⌊The customer payment screen showing the amount, network, QR code, payment address,
countdown, and order cancellation option.⌉⌊The customer payment screen showing the
amount, network, QR code, payment address, countdown, and order cancellation option
.⌉[

The customer payment screen showing the amount, network, QR code, payment address,
countdown, and order cancellation option.

## Installation

 1. Upload the plugin to `/wp-content/plugins/ainepay-for-woocommerce` or install it
    through the Plugins screen.
 2. Activate the plugin.
 3. Go to WooCommerce > Settings > Payments > AinePay.
 4. Enter your API Key, API Secret, Notify Secret, Merchant ID and Collection Address(
    from your AinePay dashboard).
 5. Save to load the supported coins, then enable the coins you want to offer.
 6. In your AinePay dashboard, set the notification URL to your site base (AinePay 
    appends `/ainepay/notify`).

## FAQ

### Which currencies are supported?

The store currency must be USD (or an equivalent treated 1:1 with the stablecoin
amount) in this release.

### Does AinePay hold my funds?

No. Payments go to an address deterministically derived from your own collection
address; the smart contract enforces settlement to you.

### What happens if a customer pays late?

AinePay does not custody the underlying funds. It may record the late amount as 
a reusable ledger credit. A logged-in customer can place the order again to apply
that credit; guest orders are not linked across orders and cannot reuse it automatically,
so the customer should contact the store. AinePay does not issue automatic refunds.

### How do I refund an order?

Refunds are full-only and follow a two-step, WooCommerce-first procedure. First,
open the order in WooCommerce and click Refund for the full amount; this creates
the real refund object, updates your sales and stock reports, and marks the order
refunded. Then issue the matching refund in the AinePay dashboard. Always do WooCommerce
first: if you refund only in the AinePay dashboard, the plugin will reconcile the
order status to refunded when it sees the authoritative REFUND, but that does not
create a WooCommerce refund object, so your sales/net reports will not reflect it
and stock is not returned. To self-heal such an order, click Refund for the full
amount on the WooCommerce order page.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“AinePay for WooCommerce” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ ainepay ](https://profiles.wordpress.org/ainepay/)

[Translate “AinePay for WooCommerce” into your language.](https://translate.wordpress.org/projects/wp-plugins/ainepay-for-woocommerce)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/ainepay-for-woocommerce/),
check out the [SVN repository](https://plugins.svn.wordpress.org/ainepay-for-woocommerce/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/ainepay-for-woocommerce/)
by [RSS](https://plugins.trac.wordpress.org/log/ainepay-for-woocommerce/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 0.1.0

 * Initial release: inline payments, local CREATE2 address verification, classic
   + Blocks checkout, active order polling with webhook acceleration, HPOS compatibility.

## Meta

 *  Version **0.1.0**
 *  Last updated **2 days ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.2 or higher **
 *  Tested up to **7.0.2**
 *  PHP version ** 8.1 or higher **
 * Tags
 * [payment gateway](https://wordpress.org/plugins/tags/payment-gateway/)[stablecoin](https://wordpress.org/plugins/tags/stablecoin/)
   [usdc](https://wordpress.org/plugins/tags/usdc/)[USDT](https://wordpress.org/plugins/tags/usdt/)
   [woocommerce](https://wordpress.org/plugins/tags/woocommerce/)
 *  [Advanced View](https://wordpress.org/plugins/ainepay-for-woocommerce/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/ainepay-for-woocommerce/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/ainepay-for-woocommerce/reviews/)

## Contributors

 *   [ ainepay ](https://profiles.wordpress.org/ainepay/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/ainepay-for-woocommerce/)