Description
IzichangePay adds a crypto payment gateway to WooCommerce. The customer pays in cryptocurrency and the order is confirmed automatically through a signed webhook.
- Hosted checkout (redirect) or on-site modal (embed.js)
- Cryptocurrencies and currencies loaded from the public IzichangePay catalog
- Confirmation through a signed webhook (HMAC-SHA256), with an automatic check that catches up lost webhooks
- Irregular payments (underpayment, overpayment) put on hold and flagged in the admin, following your decision in the IzichangePay dashboard
- English and French
- Works with both the block-based Checkout and the classic shortcode checkout
- Compatible with HPOS (High-Performance Order Storage)
This plugin requires WooCommerce to be installed and active.
It also requires a PHP version that includes the fixes for CVE-2026-109618 and CVE-2026-109619: PHP 8.2.35, 8.3.36, 8.4.27, 8.5.12 or later. On an older version, the gateway stays hidden at checkout and a notice is shown in the admin.
External services
This plugin connects to the IzichangePay payment service to create and confirm cryptocurrency payments. IzichangePay is the payment provider behind this plugin; using the gateway requires an IzichangePay merchant account.
The API URL follows the “Test mode” setting: https://api.sandbox-pay.izichange.com in test mode, https://api.pay.izichange.com otherwise.
The plugin contacts these endpoints:
-
Payment intent creation —
POST /v1/payment-intentson the configured API URL.
When a customer places an order with this gateway, the plugin sends the order
amount, currency, accepted cryptocurrencies, the order id and return URL, and an
idempotency key, in order to obtain a payment link. Triggered at checkout.Payment intent status —
GET /v1/payment-intents/{id}on the same URL. The plugin
sends the id of a payment to read its current state: when a webhook is received,
when a customer retries or returns to the order confirmation page, and every
15 minutes for the pending orders of the last 7 days. No personal data is sent.Merchant cryptocurrencies —
GET /v1/merchant-assetson the same URL, with your
API key. Called only when the gateway settings screen is displayed, to list the
cryptocurrencies enabled on your IzichangePay account. Requires the optional
merchants:read permission on the key; without it, the catalog is shown read-only. -
Public catalogs —
GET /v1/public/assetsandGET /v1/public/fiat-currencies
on the same URL. No personal data is sent; responses are cached for
6 hours. Used in the admin settings to list supported cryptocurrencies and to
determine whether the store currency is supported. -
Embedded checkout widget — when the “On-site modal” mode is enabled, the script
embed.js is loaded from the IzichangePay checkout origin returned in the payment
link, to render the payment modal on the order-pay page.
IzichangePay also sends signed webhooks back to your store (HMAC-SHA256) to confirm
payment and mark the order as paid.
Service provider: IzichangePay / Izichange.
Terms of service: https://home.pay.izichange.com/conditions-generales-utilisation
Privacy policy: https://home.pay.izichange.com/politique-de-confidentialite
Installation
- Go to Plugins → Add New → Upload Plugin, choose the .zip file, install it, then activate.
- Go to WooCommerce → Settings → Payments → IzichangePay.
- Enter your test and live API keys (from your IzichangePay dashboard). The keys need the payments permission; add
merchants:readto choose the accepted cryptocurrencies. - Declare, in your dashboard, the webhook URL shown in the settings, for the test and the live endpoint, and paste each endpoint secret into its field.
Changelog
0.1.2
- Irregular payments: an underpayment awaiting your decision puts the order on hold, with a note and an admin notice. The order then follows your decision in the IzichangePay dashboard (reopened, encashed, refunded).
- Lost webhooks are caught up: pending orders are checked again every 15 minutes and when the customer returns to the confirmation page.
- Every webhook is logged (WooCommerce → Status → Logs), and the result of the last one is shown in the settings.
- Separate webhook secrets for test and live mode. The existing secret is kept for the mode in use.
- Detailed payment note: amount received and expected.
- Clearer settings messages for a rejected or missing API key and when no cryptocurrency is enabled.
- Customers see a generic message when a payment cannot be created; the reason goes to the order note and the logs.
- French translation. The on-site modal follows the site language.
- Settings and caches are removed when the plugin is deleted.
- Now requires WordPress 6.5 and WooCommerce 9.0 or later.
0.1.1
- IzichangePay logo on the WooCommerce Payments settings page.
- Accepted cryptocurrencies: choose among those enabled on your IzichangePay account (requires the merchants:read permission on the API key). Without it, the catalog is shown read-only and all the cryptocurrencies enabled on your account are offered.
- By default, all the cryptocurrencies enabled on your account are offered, instead of TRX only.
- If the selected cryptocurrencies are no longer enabled on your account, the payment is created with all of them instead of failing.
0.1.0
- Initial version: crypto gateway, redirect and modal modes, webhook confirmation.
- Support for the block-based Cart & Checkout, alongside the classic checkout.
