Skip to content
ArionPay

FOSSBilling payment gateway

Accept crypto payments in FOSSBilling

Let clients pay FOSSBilling invoices in crypto. The money is paid straight to your own wallet.

Example

What it does

ArionPay for FOSSBilling

ArionPay for FOSSBilling is a payment gateway for client invoices. The client chooses ArionPay on an invoice, pays on the ArionPay page, and the money goes straight to your own wallet: ArionPay never holds it.
Read moreWhen 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.
Example

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

Settings: System > Payment gateways > ArionPay
  1. 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/.

  2. Step 2

    Install the gateway

    In the admin area, go to System > Payment gateways, open New Payment Gateway and install ArionPay.

  3. 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.

  4. 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.

  5. 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.

FOSSBilling 0.8 or newer. It was tested on a real FOSSBilling 0.8.9 install with PHP 8.3.

Hosting and billing