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
Download the repository source ZIP.
This is the current source archive, not a versioned release asset. Check
the plugin version and contents before installing it on a production site.
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 configure
the settings described below.
Gateway settings
Payment behavior
The plugin:- Creates a Billions invoice for the WooCommerce order.
- Stores the invoice ID using WooCommerce order APIs.
- Redirects the customer to the hosted payment page.
- Receives the Billions callback.
- Retrieves the invoice from the authenticated API.
- Updates the order using only the API response.
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.
Troubleshooting
- If the gateway is absent at checkout, confirm that it is enabled, has an API key, and its invoice currency matches the order currency.
- If invoice creation fails, check the WooCommerce logs when debug logging is
enabled and confirm that the server can reach
api.billions.worksover HTTPS. - If an order remains on hold after payment, check that the WooCommerce callback URL is public and the plugin can retrieve the invoice from the authenticated API. A customer’s return from checkout does not mark it paid.