Skip to content

Updated 20 Nov 2026

FOSSBilling crypto payment gateway

Plaxswap - Bitcoin & Crypto Payments Gateway is a free module for FOSSBilling. Your clients pay invoices with Bitcoin, USDT, USDC, ETH, SOL, LTC and other coins on our hosted checkout, and the invoice is marked paid once the module has checked the payment against our API.

Module details

Price
Free, Apache License 2.0
Version
0.1.0, from 18 Nov 2026
Needs
FOSSBilling 0.8.9 or newer (0.8.x)
Invoices
Priced in the invoice currency, one of 67 currencies
Platform fee
1.5% of each payment, paid by your client and shown at checkout. The module adds nothing on top
Where to get it
GitHub release v0.1.0 (plaxswap-fossbilling-0.1.0.zip). Not yet in the FOSSBilling extension directory

Install the module

  1. Make a folder named Plaxswap in library/Payment/Adapter/ of your FOSSBilling installation.
  2. Extract the release zip into that folder. You should end up with library/Payment/Adapter/Plaxswap/Plaxswap.php and library/Payment/Adapter/Plaxswap/lib/.
  3. In the admin area open System, then Payment Gateways, and press New Payment Gateway. Plaxswap is listed under Install Locally. Install it, then open it from the Payment Gateways list.

Once the module is in the FOSSBilling extension directory, you can install it from System, then Payment Gateways, then Install from the Extension Directory.

Connect your Plaxswap account

  1. Open a merchant account. Sign in with Google or Telegram, finish the business profile and turn on your authenticator.
  2. In the merchant dashboard open Developers. Under API keys, make a test key (pxs_test_). Make a live key (pxs_live_) when your test passes. Each key is shown once.
  3. Open the Plaxswap gateway in FOSSBilling. The IPN Callback URL at the bottom of its page is your webhook URL. It looks like https://your-fossbilling-address/ipn.php?gateway_id=ID. Use the https address of your installation.
  4. Under Webhooks in the Plaxswap dashboard, paste that URL and choose Save. Choose Make a new secret to get the signing secret (whsec_), then choose Send test to check the connection.
  5. On the Plaxswap gateway page in FOSSBilling, paste the test key, the live key when you have it, and the signing secret. Turn on Enabled and Allow One Time Payments, then press Update Gateway. Saved keys show as Configured and stay hidden.
  6. Make sure the gateway accepts the currencies of your invoices.

Test it first

FOSSBilling has an Enable Test Mode switch on every payment gateway. With it on, the module uses your test key, and payments never move real coins. The checkout shows a test banner, a pretend address and buttons that act out each outcome: paid, partly paid, overpaid, late, expired and failed.

A good test: open an unpaid invoice as a client, choose Plaxswap, and act out paid. The invoice turns paid, and Invoices > Transactions shows a processed Plaxswap transaction. Then try partly paid and expired on new invoices. Those invoices stay unpaid.

Anyone who can open an invoice can press the test buttons, so use test mode on a test installation or while no real clients are paying. Turn it off when you go live.

What happens to a FOSSBilling invoice

The module never trusts a notification alone. After a signed webhook it reads the payment back from our API and checks that it is this site's payment for this invoice, amount, currency and mode.

PaymentInvoiceWhat it means
Paid, confirmed and checkedPaidThe amount is added to the client's balance and applied to the invoice, once.
Partly paidUnpaidKept in Invoices > Transactions as an error, so you can settle it by hand.
Coins arrived after the payment expired (late)UnpaidKept as an error transaction.
Held for a compliance reviewUnpaidKept as an error transaction.
A different amount or currency than the invoiceUnpaidKept as an error transaction.
Expired, cancelled or failedUnpaidLogged. Nothing is applied to the invoice.
A second payment for an invoice already paidStays paidNot applied again.
  • Opening the pay page again within 50 minutes reuses the same payment, so a client isn't asked to pay twice for one invoice.
  • If the webhook is late, the payment is also checked when the client comes back from the checkout.
  • We retry webhook deliveries for about a day. A repeated webhook is recognised and ignored.

What your client sees

Your client chooses Plaxswap on an invoice and goes straight to our hosted checkout. They pick a coin and network and send the amount shown, with a QR code. It takes multiple coins and networks, including BTC, ETH, USDT, USDC, SOL, TRX, BNB, LTC, DOGE, BCH, XRP, GRAM, AVAX, POL, DAI and DASH.

Costs and your money

Our platform fee is 1.5% of each payment, paid by your client and shown at checkout. Your client also pays the conversion and network costs of the coin they choose, plus a 0.5% cushion for price moves while the coins confirm. Anything extra reaches you. Confirmed payments are added to your Plaxswap merchant balance, in the coin and network you receive, and we hold them until you withdraw. A withdrawal costs 0.3% plus the network fee, both shown before you approve. Work out amounts with the fee calculator, and see every cost on the fees page.

If something goes wrong

What you seeWhat to check
The return to the invoice doesn't workPlaxswap only accepts https return links. Use the https address of your FOSSBilling installation.
Send test failsThe webhook URL must be the IPN Callback URL from the gateway page, on your public https address.
An error transaction says the API could not be reachedOpen Invoices > Transactions and press Process Again on that transaction.
The client sees "Test mode: no real coins move."Enable Test Mode is on for the gateway. Turn it off when you go live, and paste the live key.

Error transactions show an error code in the Status column. Click it, or open the transaction, to read the explanation. Still stuck? Contact support with your module version, FOSSBilling version and the invoice number. Never send an API key, signing secret, recovery phrase or authenticator code.

Questions

Is the FOSSBilling module free?

Yes. It's released under the Apache License 2.0. Your client pays our 1.5% platform fee, and you pay 0.3% plus the network fee when you withdraw.

Which FOSSBilling versions does it support?

FOSSBilling 0.8.9 or newer in the 0.8 series. Version 0.1.0 was tested end to end on FOSSBilling 0.8.9.

Which invoice currencies work?

67 currencies, including USD, EUR, GBP and INR. Make sure the gateway accepts the currencies of your invoices.

Is my client's name or email sent to Plaxswap?

No. The module sends the invoice total and currency, the invoice number, its own reference, the return and cancel links, and references to the invoice, gateway and site.

Does it add a database table?

No. The module uses FOSSBilling's own transactions and cache.

Related

See all our plugins and integrations. Using WHMCS instead? See the WHMCS module. To build your own checkout, read the payment API docs, or see the crypto payment gateway.

Using Plaxswap means you accept our terms and privacy notice, recorded with your IP address and browser details. Extra cookies are optional.