Skip to main content
The official plugin adds Billions as a WooCommerce payment gateway. It is standalone and does not require Composer, Guzzle, or the Billions PHP SDK.

WooCommerce plugin on GitHub

Browse the plugin source code, releases, and issue tracker.

Compatibility

  • PHP 8.1 or newer
  • WordPress 6.7 or newer
  • WooCommerce 10.5 or newer
  • Classic Checkout
  • Cart and Checkout Blocks
  • High-Performance Order Storage (HPOS)

Install the plugin

1

Download the plugin

Obtain the official plugin ZIP from the approved Billions distribution channel.
2

Upload it to WordPress

In WordPress, open Plugins → Add New Plugin → Upload Plugin, choose the ZIP file, and install it.
3

Activate the plugin

Activate Billions Payments for WooCommerce.
4

Configure the gateway

Open WooCommerce → Settings → Payments, select Billions, and provide the required credentials and currency settings.
5

Run a test order

Complete checkout, pay on the hosted Billions page, and confirm that the WooCommerce order updates after API verification.
TODO: Add the official download URL, screenshots, exact settings fields, environment selection, and a troubleshooting section based on released plugin behavior.

Payment behavior

The plugin:
  1. Creates a Billions invoice for the WooCommerce order.
  2. Stores the invoice ID using WooCommerce order APIs.
  3. Redirects the customer to the hosted payment page.
  4. Receives the Billions callback.
  5. Retrieves the invoice from the authenticated API.
  6. Updates the order using only the API response.
Invoice creation uses both an idempotency key and order_no derived from the site and order IDs, making retries safe.

Currency behavior

The store currency must match the configured Billions invoice currency. USD and EUR orders are supported directly: the invoice uses the store currency and the customer chooses an available cryptocurrency on the hosted payment page. A supported cryptocurrency can also be used as the WooCommerce base currency when it has been registered with WooCommerce.

Current limitations

  • Refunds are not supported.
  • Subscriptions and recurring payments are not supported.
  • Saved payment methods are not supported.
Back up the site and test plugin updates in a staging environment before deploying them to a production store.