SpectroCoin WHMCS Crypto Payment Extension

Integrate cryptocurrency payments seamlessly into your WHMCS store with the SpectroCoin WHMCS Payment Extension. This extension facilitates the acceptance of a variety of cryptocurrencies, enhancing payment options for your customers. Easily configure and implement secure transactions for a streamlined payment process on your WHMCS website.

Installation

1. Download latest release from github.
2. Extract the contents of the zip file.
3. Access WHMCS site root directory via ftp and navigate to /modules/gateways/, upload spectrocoin, spectrocoin.php, logo.png and whmcs.json
4. While in the same directory, navigate to /callback/ folder and upload spectrocoin.php file.
5. From WHMCS admin dashboard navigate to Addons -> Apps & Integrations -> Payment Gateways -> All Payment Gateways -> Browse -> Payments -> SpectroCoin -> Manage.
6. Move to section Setting up.

Setting up

1. Sign up for a SpectroCoin Account.
2. Log in to your SpectroCoin account.
3. On the dashboard, locate the Business tab and click on it.
4. Click on New project.
5. Fill in the project details and select desired settings (settings can be changed).
6. Click "Submit".
7. Copy and paste the "Project id".
8. Click on the user icon in the top right and navigate to Settings. Then click on API and choose Create New API.
9. Add "API name", in scope groups select "View merchant preorders", "Create merchant preorders", "View merchant orders", "Create merchant orders", "Cancel merchant orders" and click "Create API".
10. Copy and store "Client id" and "Client secret". Save the settings.

Test order creation on localhost

We gently suggest trying out the plugin in a server environment, as it will not be capable of receiving callbacks from SpectroCoin if it will be hosted on localhost. To successfully create an order on localhost for testing purposes, change these 3 lines in CreateOrderRequest.php:

$this->callbackUrl = isset($data['callbackUrl']) ? Utils::sanitizeUrl($data['callbackUrl']) : null;,
$this->successUrl = isset($data['successUrl']) ? Utils::sanitizeUrl($data['successUrl']) : null;,
$this->failureUrl = isset($data['failureUrl']) ? Utils::sanitizeUrl($data['failureUrl']) : null;

To

$this->callbackUrl = "https://localhost.com/";,
$this->successUrl = "https://localhost.com/";,
$this->failureUrl = "https://localhost.com/";

Don't forget to change it back when migrating website to public.

Testing Callbacks

Order callbacks in the SpectroCoin plugin allow your WordPress site to automatically process order status changes sent from SpectroCoin. These callbacks notify your server when an order’s status transitions to PAID, EXPIRED, or FAILED. Understanding and testing this functionality ensures your store handles payments accurately and updates order statuses accordingly.

1. Go to your SpectroCoin project settings and enable Test Mode.
2. Simulate a payment status:
   • PAID: Sends a callback to mark the order as Completed in WordPress.
   • EXPIRED: Sends a callback to mark the order as Failed in WordPress.
3. Ensure your callbackUrl is publicly accessible (local servers like localhost will not work).
4. Check the Order History in SpectroCoin for callback details. If a callback fails, use the Retry button to resend it.
5. Verify that:
   • The order status in WordPress has been updated accordingly.
   • The callback status in the SpectroCoin dashboard is 200 OK.

Contact

This client has been developed by SpectroCoin.com If you need any further support regarding our services you can contact us via:

E-mail: merchant@spectrocoin.com
Skype: spectrocoin_merchant
Web
X (formerly Twitter)
Facebook