Installation and Configuration
This tutorial will show you how to successfully install and configure FastSpring Payment Gateway Module.
We will guide you step by step through the whole installation and configuration process.
Installation
1. Log in to our client area and download the module.
~~
~~
~~
2. Extract the "FastSpring" package which contains "includes" & "module" directories.
3. Now Connect your WHMCS Installed server via FTP Client-like "FileZilla".
4. Upload "includes" & "module" Directory on WHMCS installed root directory
5. Now you have to activate the module in your WHMCS system.
Log in to your WHMCS admin area. Go to 'Setup' → 'System Settings' and click on "Payment Gateways"
~~
6. From the "All Payment Gateways" tab Click on "FastSpring"
7. The "FastSpring" payment gateway has now been activated. Now, Configure below details and finally click on "Save Changes"
~ Storefront → Go FastSpring Storefronts->Popup Storefronts-> PLACE ON YOUR WEBSITE-> domain.onfastspring.com/popup-domain Copy and paste here
To Create Storefront:
From the left pane click on" Strorefronts > Popup Storefronts and click on "Create Popup Storefront" Type Storefront ID and finally click on "Create".
~~~
Now Whitelist Websites
To Whitelist Websites Click on "No Whitelisted websites" Button.
Insert List of URLs, one per line and finally click on "Save"
Now Switch to Online
To Switch to Online Click on "Offline" Button and click on "Switch to Online"
To Get the Storefront Link
Click on "Place on your website" Button and copy the "data-storefront" Link and paste it to Store Front Field.
~~
~~
~ Access Key → FastSping dashboard under Integrations > Store Builder Library where you can also obtain the Access Key to enter below.
To Get "Access key" Click on "Integrations" from left Pane and Click on "Store Builder Library" Copy "Access Key" and Paste it to Access Key Field.
~~
~~
~ Private Key → FastSping dashboard under Integrations > Store Builder Library ##SBL documentation. How to generate public key and private key "C" "Click Here to View User Manual to Generate Public Key and Private Key"
~ API Username → FastSping dashboard under Integrations > API Credentials
To Get "API Username" Click on Integrations > API Credentials from Left Pane Copy "API Username" and Paste it to "API Username" Field.
~~
~~
~ API Password → FastSping dashboard under Integrations > API Credentials
To Get "API Password" Click on Integrations > API Credentials from Left Pane Click on "Reset Credentials" and Get API Password, Copy API Password and Paste it to "API Password" Field.
~~
~~
~ WHMCS ROOT path → Where you installed whmcs like: https://my.domain.com or https://domain.com/my
Insert your WHMCS Install Path like: https://my.your-domain.com or https://your-domain.com/order
~~
~~
~ Gateway Fees (Optional) → Optional field, if you need charge gateway fees
~ License Key → This is gateway module license key
To Get a License key login to your Client Area from https://everestcast.com/order and copy the license key and paste it to License Key Field and finally click on Save.
~~~
~~~
~~~
7. Now Configure "FastSpring" "Product Path" for each "Products/Services". To Setup "Product Path" follow the following steps:
a. Login to your FastSpring Dashboard and click on "Products > Subscription from Left Pane.
b. Click on "Create Subscription" Type "Subscription Name" and Finally click on "Create"
c. Click on Subscription Name from List and configure "Product Tax Category" as per your needs.
~~~~
d. Now Setup Webhooks
Login to your FastSpring Dashboard and click on "Integrations > Webhooks from Left Pane. Click on "Add URL Endpoint"
Insert your webhook link : https://yourdomain.com/whmcs-install-path/modules/gateways/callback/fastspring.php
Insert any HMAC SHA256 Secret, Check all Events & Finally Click on Save
~~
~~
~~
e. Log in to your WHMCS admin area. Go to 'Setup' → 'System Settings' and click on "Products/Services" and from the Product List list edit your existing product.
~~
~~
~~~
~~~
e. Click on "FastSpring" Tab Paste "Product Path" and Finally Click on "Update Product Path" and "Save Changes"