User Guide for Prestashop Stripe Recurring Payment Gateway

• Admin can use the module either in test or live mode, as per the requirement.
• Provide the API keys according to the mode selected.
• Specify whether the created stripe plans will delete from the stripe.com on uninstalling the module or not.
• Choose to add product amount with subscription amount at the time of checkout or not.
• Show or hide subscription plan information on product page.
• Create order in back office whenever subscription is renewed.
• Send email to customers on subscription renewal.
• Show or hide one time purchase option on product page.
• Enable users to pay using alternative payment methods offered by Stripe.
• Create the stripe plan on store itself, which will automatically synchronize to admin’s stripe account.
• Select default option as a one-time purchase or subscribe.
• Choose to make the payment on the host website or redirect the customer to the Stripe website for payment.
• Admin can also synchronize the stripe plan from stripe account to prestashop.
• Specify the plan ID and name while creating plan. Plan Id will be unique for every plan.
• Admin need to specify the amount & the duration of the subscription plan.
• Can also add the trial period of the plan. The duration will start after the completion of trial period.
• Admin can also edit/delete the subscription plan.
• Admin can assign plan to products in two way.
• With a new tab in the add/update product page, admin can assign any plan to the product.
• Assign products with or without combinations to the subscription plan.
• Admin can update/delete the assigned plan from the product.
• View the separate list of transactions made through Stripe.
• Admin can either refund full or partial amount to customer for their order.
• Admin can view the list of subscribed customers.
• Cancel the subscription of any customer.
• Buyer can view the subscription details on product page.
• Subscription is only possible through stripe payment gateway.
• View subscription detail in the buyer’s order detail page.
• Choose to display the alternative payment option either in tabs or accordion on the self-host payment page.

Note: This module is compatible with SCA(Strong Customer Authentication) and multi-store feature of PrestaShop.

• Firstly, go to the module manager in back office and click on ‘upload a module’.
• After that, drag and drop the module file or select the file from the system.
• In this way, the module installation will be successful.

After the successful installation of the module, the admin needs to configure it.  

General Settings

Under General Settings, the admin can:

• Select the mode (live or test) in which he wants to use the module.
• Specify API secret and publishable keys as per the selected mode.
• Select whether payments will be made on self hosted (Stripe payment form) page or Stripe hosted page.
• Choose to show alternative payment options as tabs or accordion.

Note that the admin has to activate the Stripe payment methods at Stripe end as shown in the below image.
Go to Settings -> Payment Methods

Subscription Settings

Under Subscription Settings, the admin can choose to:

• Delete all the Stripe plans from Stripe account upon module uninstallation.
• Add product price with subscription plan price at the time of checkout.
• Hide subscription plan information on product page.
• Hide one time purchase option from product page.
• Show subscribe or one time purchase as default selected on product page.

Create order in backoffice on subscription renew

If enabled, then new order will create in backoffice whenever subscription is renewed. Also, the admin can choose to send email to customer on subcription renewal.

Alternative payment methods

The admin can allow users to pay using alternative payment methods enabled on Stripe.

Admin needs to have their account on Stripe Payment Gateway. Once the admin is logged in to the Stripe account, go to user account settings.

Now, an admin needs to go to the API keys tab to get the API key for either test or live mode.

For new SCA(Strong Customer Authentication), an admin has to enable Checkout Client Integration as shown below:

As per the requirement, an admin can fill the API keys in the module configuration.

After successful installation, new tabs add to manage the stripe payment with recurring and refund options.

Four new tabs add to the Stripe Manager tab. We will discuss the functionality of each tab in detail

Create Stripe Plans

Go to Stripe manager -> Create stripe plans for creating a stripe subscription plan.

On clicking Create plan, an admin can create a stripe subscription plan on the Prestashop store itself which will directly synchronize on the admin’s stripe account.

Admin does not have to mention “Trial Period” separately at the stripe end.

In this way, you can easily create subscription plans.

Assign Stripe Subscription

After creating the plans, an admin has to assign stripe subscription plans to products.

So that the products can become subscription-based products if a customer makes the payment through the stripe payment gateway.

Go to Stripe manager -> Assign stripe subscription

• Assigning product with combinations

• Assigning product without combination(s)

Once admin has assigned the products to the subscription plans, it can view the plan details and number of products assigned to the particular plan under “Subscription products”.

By clicking on the “View” button, admin can view the products and number of product combinations added to a plan.

Purchasing subscription product with Stripe

On the product page, a customer can see whether a product is subscription-based or not. On visiting the product page, the detail related to the subscription plan is also visible to them.

Once buyers proceed to purchase the product, the stripe payment gateway will be available to buyers to purchase the subscription-based product.

When admin selects Allow payment through as Stripe hosted checkout

After clicking on the “Pay by debit/credit card” payment option, the customer lands on the payment page of the Stripe website. Here, customers can complete the payment by filling required details.

If admin has enabled the addition of product price with plan price, then product price will be included with plan price at the time of checkout.

If disabled the addition of product price, then the product amount is not added with the subscription amount, and only the plan price is displayed on the payment page.

When admin selects Allow payment through as Self hosted (Stripe payment form)

The customer will not redirect to Stripe’s website for the payment.

Note: 

1. The amount displayed on the payment page is only the product amount. The subscription amount will automatically deduct while paying through the stripe gateway. The detail of the full payment made by “stripe payment gateway” will display on the order confirmation page.
2. The alternate payment methods will only support the recurring feature on the Stripe-hosted payment page.

List of alternate payment methods offered by Stripe that support recurring payment on the stripe-hosted payment page

• SEPA Direct Debit
• ACH Direct Debit
• Alipay
• Apple Pay
• Google Pay
• Cash App Pay
• Link
• Canadian pre-authorized debits

List of alternate payment methods offered by Stripe that support recurring payment on stripe-hosted payment page via SEPA Direct Debit

• iDEAL – supported through Stripe via SEPA Direct Debit
• Sofort – supported through Stripe via SEPA Direct Debit
• Bancontact – supported through Stripe via SEPA Direct Debit

Here is the list of alternate payment methods offered by Stripe that do not support recurring payment and are only available for purchasing normal products

• Klarna
• Przelewy24
• EPS
• giropay
• Afterpay / Clearpay
• WeChat Pay
• Affirm

Admin can go to “Orders” to view the order detail.

Purchasing non-subscription products with Stripe

If the customer has purchased a non-subscription product using Stripe payment then as enabled by admin, other payment options will be available.

When admin selects Allow payment through as Stripe hosted checkout

The alternate payment option offered by Stripe will be displayed on the Stripe payment page.

When admin selects “Allow payment through“ as “Self hosted (Stripe payment form)“

The alternative payment option will display like this when the admin chooses to display them in tabs.

The alternative payment option will display like this when the admin chooses to display them in Accordion.

Stripe Customers

Admin can view the list of those customers who have purchased the products with subscription plans.

Stripe Transactions

After a customer places the order, an admin will be able to view the list of stripe transactions under the ‘Transactions’ tab.

Buyer can view the list of their subscription in the new tab. Go to My Account -> My Subscription.

In this way, an admin can successfully provide subscription-based products to buyers.

Buyers can easily make the payment for the same and the amount will automatically deduct from their Stripe account regularly as per the plan.

So, this was all about Prestashop Stripe Recurring Payment Gateway Module. I hope this document will help you in checking the functionality of the module in a better way.

Also, do let us know about your views in the comments.

For any kind of technical assistance or query, please raise a ticket or send us a mail at support@webkul.com

Also, please explore our Prestashop development services and vast range of quality Prestashop addons.