FastSpring, a leading e-commerce and subscription management company, provides a robust set of features and services that enables digital goods companies to sell more of their products online. FastSpring provides a global digital commerce, subscriptions, billings and management platform.
Setting Up FastSpring
FastSpring support Fixed payments.
FastSpring support Recurring and Recurring + Trial.
FastSpring requires user to create an account with them. Navigate to FastSpring sign-up section, define your business model and provide some details for your application.
Whitelisting Your Domain or Subdomain
Get your website domain or subdomain whitelisted by FastSpring Support. In your request you should specify the exact site domain or subdomain of which your storefront should be rendered. Once your site domain or subdomain has been whitelisted, the popup storefront section of your FastSpring dashboard will shown a green indicator with the number of website whitelisted.
Popup Storefront URL
Once your website URLs have been whitelisted, then you'll need to create Popup Storefront. If you already have a Storefront, choose any of the Storefront and click on PLACE ON YOUR WEBSITE link. A window will be open of which there will be a block of Javascript snippet. Your Storefront URL is located at data-storefront attribute. The following screenshot illustrate the URL.
Access Key
On the Store Builder Library tab, you can obtain the Access Key for use when encrypting secure payload in PayPlans.
Products
In order for you to integrate PayPlans with FastSpring, you'll need to create a mirror product for each plans that you have in PayPlans into FastSpring. You may use this FastSpring product documentation as a guide in creating your products. Once you have created your products, copy the products id and place it in the integration page.
When you create Recurring plan it should be "standard" type only.
Webhook Configuration
In order for you to capture payment notification in PayPlans you will need to create webhook url's where Fastspring will send the payment notification for payment success, failure and refund.
You may use this FastSpring Webhook Documentation as a guide.
You need to create 5 webhook as mentioned below.
order.created : This webhook event is used for payment success notification.
order.failed : This webhook event is used for payment failure notification.
return.created : This webhook is used for payment Refund notification.
subscription.charge.completed : This webhook is used for recurring payment success notification.
subscription.deactivated : This webhook is used for recurring subscription cancellation notification.
The webhook url will be as shown below.
http://yoursite.com/index.php?option=com_payplans&gateway=fastspring&view=payment&task=notify
FastSpring Configuration
The General options for FastSpring are fairly the same among all payment methods. You'll need to give a suitable title, determine whether to be published or unpublished and the appropriate description for this payment method. You may set this payment method to be applied on all plans or only on selected plans.
The following screenshot illustrate the options available in FastSpring.
Storefront URL : Enter the Storefront URL that generated from FastSpring.
Access Key : Enter the Access Key generated from FastSpring.
Plan Mapping : You will need to map the plans on the site with the alias of products that you created on FastSpring.
When everything are in order, click on Save button to store the configuration.