Blockonomics for FOSSBilling

Accept crypto payments in FOSSBilling using Blockonomics. When a customer pays, the crypto goes directly into your wallet. No KYC. Currently supports Bitcoin (BTC) and Tether (USDT, ERC-20).

Requirements

FOSSBilling 0.8.3 or later (PHP 8.2+)
Blockonomics API Key

Configure Blockonomics

Create a Blockonomics account using email/password or Google. If using email/password, enter the activation code sent to your email.
Open Dashboard → Wallets and add the wallets you want to accept:

USDT: select USDT Wallet, enter a name, and paste your ERC-20 receiving address.
BTC: select BTC Wallet, enter a name and xPub. When prompted, paste a sample receiving address from the same wallet. Note: Never enter a seed phrase or private key, Blockonomics never asks you to.

Open Dashboard → Stores, click Add a store, enter a name, enable BTC and/or USDT, and select the corresponding wallets. You can initially leave Callback URL empty.

Install and connect FOSSBilling

Download Blockonomics.zip from the latest release
Extract the archive inside /library/Payment/Adapter/ of your FOSSBilling installation. The archive creates the Blockonomics/ folder for you
In FOSSBilling, open System → Payment Gateways → New Payment Gateway and click the cog beside Blockonomics.
Open the Blockonomics gateway settings and copy the generated Callback URL.
Return to Blockonomics → Stores, paste the callback URL into your Store (added in step 3), and click Update Store.
Copy the API key from the Blockonomics Stores page. Paste it into Blockonomics API Key in FOSSBilling, enable the gateway, and click Update Gateway.
Hit Test Setup. Setup is complete when the enabled currencies display check marks. For ex. BTC ✅ USDT ✅

Uninstall

Removing the payment gateway does not remove the companion Blockonomics module. For full removal, uninstall the module separately under Extensions.

Optional Integration Testing

Enable Testmode on the Blockonomics Store to simulate checkout and callback processing without making a real payment. The relevant test-mode control is the one on the Blockonomics Store. Here is a comprehensive guide about this.

Support

Issues and feature requests: GitHub issues
Reach out here for human support

Licensing

This extension is open source software released under the Apache 2.0 license.

Blockonomics