Bitcoin Payment Gateway WHMCS Module Documentation – Serversaurus Support

Bitcoin (via Coinjar.io) Payment Gateway for WHMCS

This module uses the Coinjar Checkout service to provide your clients with a Bitcoin payment option.

Setup

Extract the module

You will need to extract the provided zip file into the root directory of your WHMCS installation. it will extract a coinjar.php into your includes folder, and install identically named files to modules/gateways/ and modules/gateways/callback.

Configuration

Once this has been done, navigate to the Payment Gateways configuration page in WHMCS administration (typically located at /admin/configgateways.php).

You will need to populate a number of settings:

Setting	Explanation
Display Name	What the call the payment option on the invoice display page.
Merchant UUID	Get this from https://checkout.coinjar.com/merchant/credentials
Merchant Secret	Get this from https://checkout.coinjar.com/merchant/credentials
API Key	Get this from https://secure.coinjar.com/authentication_token/show.
Use the Coinjar.io Sandbox	Whether you want to test using Coinjar’s sandbox
OK URL	Where to send users after they’ve made the Bitcoin payment
Cancel URL	Where to send users if they choose to abort the payment process.

Testing

Once configured, you can try paying the invoice using either the sandbox or live environments.

If you run into trouble, ensure that /modules/gateways/callback/coinjar.php is accessible by outside servers. Otherwise, please submit a support ticket.

User flow

When viewing an invoice, clients will be presented with an option to ‘Pay with Bitcoins’:

If the user chooses to continue, they will be presented with the Coinjar hosted payment page, which will convey to the user the exchange rate, how much Bitcoin is owed for the invoice, and what address to send it to:

Once CoinJar detects that the payment has been made, it will redirect the user back to the configured OK URL.

Once Coinjar has determined that adequate confirmations have been made on the Bitcoin transaction, it will invoke an IPN (Instant Payment Notification) on the module, and the module will add a payment to the invoice.