FOSSBilling payment gateway
Accept crypto payments in FOSSBilling
Let clients pay FOSSBilling invoices in crypto. The money is paid straight to your own wallet.
What it does
ArionPay for FOSSBilling
Read more
When the payment is confirmed, the amount is added to the client's balance and the invoice is paid from it, the same way FOSSBilling's other gateways work. It was tested on a real FOSSBilling 0.8.9 install.- Pays invoices through the client's balance, the same way FOSSBilling's own gateways do.
- Every update is recorded as a transaction with a note, under Invoices > Transactions.
- An invoice is paid only if the paid ArionPay invoice still matches it: same currency and same total.
- Opening the payment page again reuses the open ArionPay invoice. After it expires, a new one is made.
- A second payment for an invoice that is already paid is recorded with a note and not credited.
- Keys and secrets are stored like FOSSBilling's other gateway secrets and are not shown again.
Requirements and licence
- Works with
- FOSSBilling 0.8 or newer
- Tested
- A real FOSSBilling 0.8.9 install with PHP 8.3
- Cost
- The plugin is free. ArionPay charges 0.5% per payment, with no monthly fee.
- Source
- Open source (MIT) on GitHub, version 1.0.0.
Setup
Set it up in 5 steps
Step 1
Unzip the files
Unzip arionpay-fossbilling.zip into your FOSSBilling folder. It adds ArionPay.php, arionpay.png and the ArionPay folder under library/Payment/Adapter/.
Step 2
Install the gateway
In the admin area, go to System > Payment gateways, open New Payment Gateway and install ArionPay.
Step 3
Add your keys
Open ArionPay in the gateway list and paste the API key (pk_), API secret (sk_) and webhook signing secret (whsec_) from your ArionPay dashboard. Leave ArionPay address empty.
Step 4
Turn it on in test mode
Tick Enabled, Allow one time payments and Test mode, then save. As a client, pay an unpaid invoice with the test payment buttons: no real money moves.
Step 5
Go live
Check that Old ArionPay (v1) integration compatibility is off in your ArionPay store settings. Untick Test mode before you take real payments.
After the setup
How invoices change
- When the payment is confirmed, the amount is added to the client's balance and the invoice is paid from it.
- Payment seen, partial payment, expired and "needs review" updates are recorded as transactions with a note, without paying the invoice.
- If the invoice was edited after the client went to pay, it is not paid, and the transaction shows an error explaining why.
- A payment that is not exact goes to Payment Radar. A small difference inside your store's payment tolerance (default 1%) is accepted automatically; anything else you decide.
- A late payment, after the ArionPay invoice expired, still pays the invoice, with a note on the transaction.
- Coming back from the payment page never marks an invoice paid.
16 coins and tokens on 9 networks
All coins- BTCBitcoin
- ETHEthereum
- USDTEthereum
- USDCEthereum
- BNBBNB Smart Chain
- USDTBNB Smart Chain
- USDCBNB Smart Chain
- POLPolygon
- USDTPolygon
- USDCPolygon
- TRXTRON
- USDTTRON
- LTCLitecoin
- DOGEDogecoin
- BCHBitcoin Cash
- DASHDash
Questions about ArionPay for FOSSBilling
Short answers before you install it.