WHMCS gateway module
Accept crypto payments in WHMCS
Let clients pay WHMCS invoices in crypto, straight to your own wallet. This module is a pre-release: try it in Test Mode first.
Pre-release. Checked against a WHMCS stand-in; not yet tried on a licensed WHMCS install. Try it in test mode before you take real payments, and tell us how it went.
What it does
ArionPay for WHMCS
Read more
When ArionPay confirms the payment, it tells WHMCS through the callback URL and the payment is added to the invoice. Version 2.1.0 has not yet been tried on a licensed WHMCS install, so please start in Test Mode.- Adds a payment only when the ArionPay invoice amount and currency exactly match the WHMCS invoice balance and currency.
- Pressing the pay button again reuses the ArionPay invoice that is still open.
- The ArionPay invoice id is the transaction id of the payment in WHMCS.
- Every update is written to Billing > Gateway Log. Keys and secrets are never written there.
- Nothing to paste into ArionPay: every invoice tells ArionPay where to send its payment updates.
- Replaces the old ArionPay module in place and keeps your saved Public Key, Secret Key and API Base URL.
Requirements and licence
- Works with
- WHMCS 8.x · PHP 7.4 or newer with cURL
- Tested
- Checked against a WHMCS stand-in; not yet tried on a licensed WHMCS install
- Cost
- The plugin is free. ArionPay charges 0.5% per payment, with no monthly fee.
- Source
- Open source (MIT) on GitHub, version 2.1.0.
Setup
Set it up in 5 steps
Step 1
Copy the files
Copy the contents of the zip into your WHMCS main folder, the one with configuration.php in it. This adds the gateway file, the callback file and the arionpay folder.
Step 2
Activate the gateway
Go to System Settings > Payment Gateways > All Payment Gateways and activate ArionPay Crypto.
Step 3
Add your keys
Paste the Public Key (pk_), Secret Key (sk_) and Webhook Secret (whsec_) from your ArionPay dashboard. Leave API Base URL as it is.
Step 4
Test with pretend money
Tick Test Mode, pay an unpaid invoice from the client area with the test payment buttons, and check that it turns Paid. Billing > Gateway Log shows what happened.
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
- The pay button creates an ArionPay invoice, or reuses the one that is still open, and sends the client to the ArionPay page.
- When ArionPay confirms the payment, it tells WHMCS through the callback URL, and the payment is added to the invoice.
- The exact amount is confirmed automatically, and so is a small difference inside your store's payment tolerance (default 1%).
- Any other amount leaves the invoice unpaid and goes to Payment Radar, where you decide. If you accept it, the invoice is paid here too.
- If the amount or currency does not match the invoice balance, the Gateway Log says so and the invoice is not paid.
- Coming back from the payment page does not mark 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 WHMCS
Short answers before you install it.