Skip to content
ArionPay

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.

Example

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

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

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

Settings: System Settings > Payment Gateways > All Payment Gateways > ArionPay Crypto
  1. 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.

  2. Step 2

    Activate the gateway

    Go to System Settings > Payment Gateways > All Payment Gateways and activate ArionPay Crypto.

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

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

  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

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

It is a pre-release. It passes 29 checks against a stand-in of the WHMCS functions a gateway uses and a real ArionPay server, but it has not yet been tried on a licensed WHMCS install. Please start in Test Mode.

Hosting and billing