IzichangePay for WooCommerce

By adignonizi

0+ active installationsVersion 0.1.2

Accept cryptocurrency payments (USDT, TRX and more) on your WooCommerce store via IzichangePay.

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:

  1. Payment intent creation — POST /v1/payment-intents on 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-assets on 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.

  2. Public catalogs — GET /v1/public/assets and GET /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.

  3. 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

  1. Go to Plugins → Add New → Upload Plugin, choose the .zip file, install it, then activate.
  2. Go to WooCommerce → Settings → Payments → IzichangePay.
  3. Enter your test and live API keys (from your IzichangePay dashboard). The keys need the payments permission; add merchants:read to choose the accepted cryptocurrencies.
  4. 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.