Tips and Tricks WP eCommerce

eCommerce Solution for WordPress Blog

WP Payment Gateway Bundle – Stripe Checkout SCA Setup

Stripe Checkout SCA is a simplified method for accepting payments with the Stripe payment gateway. When you enable this option in the payment gateway bundle addon, the payment information is collected on a secure, Stripe-hosted payment page.

screenshot of Stripe checkout payment form

Table of Contents

Strong Customer Authentication

Strong Customer Authentication (SCA), a new rule coming into effect on September 14, 2019, as part of PSD2 regulation in Europe, will require changes to how your European customers authenticate online payments. Card payments will require a different user experience, namely 3D Secure, in order to meet SCA requirements. Transactions that don’t follow the new authentication guidelines may be declined by your customers’ banks.

Our Stripe Checkout SCA method supports 3D Secure 2 and users Stripe-hosted checkout flow that automatically handles SCA requirements for you.

Stripe Checkout SCA Setup

After you install the WP Payment Gateway Bundle addon, you will need to configure some Stripe Gateway specific settings in the plugin which you will need to obtain from your Stripe merchant account.

You can find the Stripe Checkout SCA specific settings under the “Gateway Settings” tab when you go to the payment gateway bundle plugin’s settings menu. The following screenshot shows how you can access the settings page of this addon:

screenshot of payment gateway bundle settings

In order to configure the Stripe portion of the payment gateway bundle you will need to obtain the required details from your Stripe merchant account by following the steps outlined below:

Step 1: Log into your Stripe merchant account and click on the API Keys menu item (Under Developers).

screenshot of stripe api keys menu

Step 2: Copy the values for the secret key and the publishable key as shown in the figure above.

Step 3: Now from your WordPress administration panel, go to Stripe Checkout SCA Settings (under WP eStore -> Payment Gateway Bundle -> Gateway Settings) and check “Use Stripe Checkout SCA” option.

Step 4: Enter your Test Secret Key.

Step 5: Enter your Test Publishable Key.

Step 6: Enter your Live Secret Key.

Step 7: Enter your Live Publishable Key.

Step 8: Enter a selector label for Stripe Checkout SCA option. For example: Stripe Payment (This text will be displayed in the select box in the shopping cart as a checkout option).

Step 9: Copy the Stripe Webhook URL for your site and add it as a webhook endpoint in your Stripe account (Developers -> Webhooks). You should only have one webhook set up for our plugin (remove any other URL that you may have configured previously for our plugin).

You can either choose to be notified of all the events (may increase load on your server) or select the ones that our plugin processes at the moment:

  • charge.refunded
  • checkout.session.completed
  • checkout.session.async_payment_succeeded
  • invoice.payment_succeeded
  • customer.subscription.deleted
  • invoice.payment_failed

Step 10: Hit the “Update” button at the bottom to save the settings and now your customers can checkout using the stripe payment form.

Once the above setup is complete, you are ready to use the Stripe payment gateway. You can use it with the standard Add to Cart type buttons and a shopping cart. You can also use it with Buy Now and/or Subscription type buttons using this gateway.

The following section has information on how to use Stripe payment gateway with the different types of buttons.



Using Add to Cart Type Buttons with a Shopping Cart

The add to cart type button allows your customers to add a normal product to the shopping cart. Then they can click the checkout option in the cart.

Read the documentation on add to cart type buttons to set it up (if you want to use this type of button).

Creating Buy Now Type Buttons For Stripe Checkout SCA

If you want to use “Buy Now” type buttons instead of the standard “Add to Cart” buttons then use the following shortcode:

[wp_eStore_buy_now_for_specific_gateway id="1" gateway="stripe_co_sca"]

(Replace 1 with your actual eStore product ID).

Also, check the following documentation to learn how to create a buy now type button for any payment gateways offered in WP eStore plugin:

If you want to use an URL/Link instead of a shortcode to create the Buy Now button, then check this feature of WP eStore plugin.



Creating Stripe Subscription Type Buttons

WP eStore Product Configuration for Subscription Product

There are a few things you need to be aware of when you are configuring a product for Stripe subscription.

1) No Trial Payment Amount: Stripe only supports Free Trial. So you cannot charge your customer for the trial period. For example: if you wish to offer one month free trial to your users before they are billed on a recurring basis (2.99/month) you can set up like the following,

  • Trial Billing Amount: 0
  • Trial Billing Period: 1 Month
  • Recurring Billing Amount: 2.99
  • Recurring Billing Cycle: 1 Month
  • Recurring Billing Count: 0
screenshot of eStore product configuration for stripe subscription

If you do not wish to offer a trial, you should leave the Trial Billing Amount and Trial Billing Period fields empty. For example:

  • Trial Billing Amount:
  • Trial Billing Period:
  • Recurring Billing Amount: 2.99
  • Recurring Billing Cycle: 1 Month
  • Recurring Billing Count: 0

2) Recurring Billing: Our Stripe integration supports recurring payments on a daily, monthly or yearly basis. For example: if you wish to charge your customer 2.99/day until cancelled your setup should look like the following,

  • Trial Billing Amount:
  • Trial Billing Period:
  • Recurring Billing Amount: 2.99
  • Recurring Billing Cycle: 1 Day
  • Recurring Billing Count: 0

If you wish to charge your customers 2.99 every 7 days for 3 installments your setup should look like the following,

  • Trial Billing Amount:
  • Trial Billing Period:
  • Recurring Billing Amount: 2.99
  • Recurring Billing Cycle: 7 Day
  • Recurring Billing Count: 3

If you wish to charge your customers 2.99 every/month until cancelled your setup should look like the following,

  • Trial Billing Amount:
  • Trial Billing Period:
  • Recurring Billing Amount: 2.99
  • Recurring Billing Cycle: 1 Month
  • Recurring Billing Count: 0

If you wish to charge your customers 2.99/month for 6 installments your setup should look like the following,

  • Trial Billing Amount:
  • Trial Billing Period:
  • Recurring Billing Amount: 2.99
  • Recurring Billing Cycle: 1 Month
  • Recurring Billing Count: 6

If you wish to charge your customers 2.99 every 2 months until cancelled your setup should look like the following,

  • Trial Billing Amount:
  • Trial Billing Period:
  • Recurring Billing Amount: 2.99
  • Recurring Billing Cycle: 2 Month
  • Recurring Billing Count: 0

3) Reattempt on failure: This checkbox does not have any effect on a Stripe subscription.

4) Editing the subscription amount: Once you make the first transaction of a newly created eStore subscription product, a plan is automatically created in your Stripe account. Stripe doesn’t allow the editing of an existing plan. So if you need to edit the subscription amount after a transaction, create a NEW estore product with the new subscription price.

Shortcode for SCA Stripe Subscription Button

You need to enter the following shortcode in a WordPress Post/Page to create the subscription button. This will allow you to accept recurring payments via Stripe Checkout SCA:

[wp_pg_eStore_subscription_button id="1" gateway="stripe_co_sca_subsc"]

(Replace 1 with your actual eStore product ID)

If you want to use an URL/Link instead of a shortcode to create the subscription button, then check this feature of WP eStore plugin.

Customizing the Look of the Stripe Subscription Button

WP eStore plugin allows you to customize all of your subscription buttons by using a custom button image of your choice. If you want to customize the look of your stripe subscription button then read this post.

Using Stripe Subscription Button with Fancy Display Template

You can use the following shortcode to use a fancy display template with the Stripe subscription button:

[wp_eStore_fancy_display id="50" type="3" style="1" gateway="stripe_co_sca_subsc"]

WP eStore product ID of the item is 50 in the above example. You will need to change that value to your actual product ID.

WP eStore Addon – Alipay Payment Gateway

This addon allows you to do shopping cart checkout using Alipay payment gateway.

Installation

You can install this addon the same way you install any WordPress plugin:

  • Go to the Add New plugins screen in your WordPress admin area
  • Click the Upload Plugin button
  • Browse for the addon file (eStore-alipay-gateway.zip)
  • Click Install Now and then activate the plugin

[Read more…]

WP Payment Gateway Bundle – Braintree Subscription Setup

After you install the WP Payment Gateway Bundle plugin, you will need to configure some Braintree Gateway specific settings in the plugin which you will need to obtain from your Braintree merchant account.

You can find the Braintree specific settings required by the plugin under the “Gateway Settings” tab when you go to the payment gateway bundle plugin’s settings menu. The following screenshot shows how you can access the settings page of this addon:

In order to configure the Braintree Subscription portion of the payment gateway bundle you will need to obtain the required details from your Braintree merchant account by following the steps outlined below:

Step 1: Log into your Braintree merchant account and click My User under Account.

screenshot1 showing how to get the braintree credentials from the merchant account

 

Step 2: Go to the API Keys, Tokenization Keys, Encryption Keys section and click View Authorizations. Copy and paste your account credentials into a notepad for later use.

screenshot2 showing how to get the braintree credentials from the merchant account

 

Step 3: Now from your WordPress administration panel, go to Braintree Subscription Settings (under Payment Gateway Bundle->Gateway Settings).

Step 4: Enter your Merchant ID.

Step 5: Enter your Public key.

Step 6: Enter Private key.

Step 7: Copy the  Braintree Webhook URL for your site and specify it in your merchant account (Settings > Webhooks).

configure a webhook for braintree subscription

You can choose to receive notifications for all the subscription events. However, the plugin will currently handle these events – Cancelled, Charged Successfully and Expired.

configuring braintree webhook notification types for a subscription

Step 8: Hit the “Update” button to save your Braintree account credentials in the Payment Gateway Bundle settings.

Create a Subscription Plan

In order to accept recurring payments for your eStore subscription product, you will need to create a plan in your Braintree account. If you have 10 eStore subscription products that you wish sell with Braintree, you will need to create 10 separate plans in your Braintree merchant account. Each plan interface is very similar to the subscription settings section of an eStore product. For example: Recurring Billing Price, Recurring Billing Cycle etc.

configure a plain in braintree

When a new subscription is created on your site, Braintree will charge/rebill the customer based on these configurations (not your eStore subscription product). Your eStore subscription product will just be a template for the plan that you create in your Braintree account. Unfortunately, Braintree API doesn’t allow an external script to create this plan (you will need to do this manually). That means the payment gateway bundle addon needs to assume the ID of the plan that you are going to create for an eStore product.

How to Name a Plan ID

The Plan name can be anything you like. However, The Plan ID needs to be unique in your account and something that can be synchronized with the eStore product in question. In order to integrate an eStore product with a plan created in your Braintree account, your Plan ID should be:

SiteAddress-estore-EstoreProductID

Here, SiteAddress is the URL specified in your WordPress dashboard (Settings > General > Site Address) and EstoreProductID is the eStore product ID (example: 1). Since you can only use limited special characters in the plan ID you will need to remove http:// or https:// from SiteAddress and replace all dots with hyphens.

Plan ID Example

1. if your SiteAddress is http://example.com and you are creating a plan for eStore product 2, your plan ID should be:

example-com-estore-2

2. if your SiteAddress is http://www.example.com and you are creating a plan for eStore product 7, your plan ID should be:

www-example-com-estore-7

3. if your SiteAddress is http://www.my-site.com and you are creating a plan for eStore product 10, your plan ID should be:

www-my-site-com-estore-10

configure a plan name in braintree

Subscription Limitation

When a new subscription is created, Braintree plan allows you to bill the customer in a future date (instead of charging immediately). Unfortunately, we can’t support this feature since our eStore product was designed to charge the customer immediately.

Shortcode for Subscription Button

You need to embed the following shortcode in a WordPress Post/Page to accept recurring payments via Braintree:

[wp_pg_eStore_subscription_button id="1" gateway="braintree_subsc"]

(Replace 1 with your actual eStore product ID)

Customizing the Look of the Braintree Subscription Button

WP eStore plugin allows you to customize all of your subscription buttons by using a custom button image of your choice. If you want to customize the look of your Braintree subscription button then read this post.

Using Braintree Subscription Button with Fancy Display Template

You can use the following shortcode to use a fancy display template with the Braintree subscription button:

[wp_eStore_fancy_display id="50" type="3" style="1" gateway="braintree_subsc"]

WP eStore product ID of the item is 50 in the above example. You will need to change that value to your actual product ID.

WP Payment Gateway Bundle – Stripe Basic Gateway Setup

Read this page to get a good idea of how the checkout flow works when you use the gateway bundle addon.

Note: There are a couple of different checkout flows available for the Stripe gateway. The recommended setup is the Stripe SCA setup explained here.

Stripe Basic is a simplified method for accepting payments with the Stripe payment gateway. When you enable this option in the payment gateway bundle addon, the payment information is collected in a popup form instead of our default checkout page.

screenshot of Stripe basic payment form in a popup

This method is useful if you just want to quickly accept payments from your customers.

screenshot of Stripe basic credit card form

Stripe Basic Setup

After you install the WP Payment Gateway Bundle addon, you will need to configure some Stripe Gateway specific settings in the plugin which you will need to obtain from your Stripe merchant account.

You can find the Stripe Basic specific settings under the “Gateway Settings” tab when you go to the payment gateway bundle plugin’s settings menu. The following screenshot shows how you can access the settings page of this addon:

In order to configure the Stripe portion of the payment gateway bundle you will need to obtain the required details from your Stripe merchant account by following the steps outlined below:

Step 1: Log into your Stripe merchant account and click on the API Keys menu item (Under Developers).

Step 2:  Copy the values for the secret key and the publishable key as shown in the figure above.

Step 3: Now from your WordPress administration panel, go to Stripe Basic Settings (under WP eStore -> Payment Gateway Bundle -> Gateway Settings) and check “Use Stripe Basic Payment Gateway” option.

Step 4: Enter your Test Secret Key.

Step 5: Enter your Test Publishable Key.

Step 6: Enter your Live Secret Key.

Step 7: Enter your Live Publishable Key.

Step 8: Enter a selector label for Stripe Basic option. For example: Stripe Payment (This text will be displayed in the select box in the shopping cart as a checkout option).

Step 9: Copy the Stripe Webhook URL for your site and add it as a webhook endpoint in your Stripe account (Developers -> Webhooks). You should only have one webhook set up for our plugin (remove any other URL that you may have configured previously for our plugin).

You can either choose to be notified of all the events (may increase load on your server) or select the ones that our plugin processes at the moment:

  • charge.refunded
  • checkout.session.completed
  • invoice.payment_succeeded
  • customer.subscription.deleted
  • invoice.payment_failed

Step 10: Hit the “Update” button at the bottom to save the settings and now your customers can checkout using the stripe basic payment form.

Creating Buy Now Type Buttons For Stripe Basic

If you want to use “Buy Now” type buttons instead of the standard “Add to Cart” buttons then check the following documentation to learn how to create a buy now buttons for any payment gateways offered in WP eStore plugin:

Shortcode for Subscription Button

You need to embed the following shortcode in a WordPress Post/Page to accept recurring payments via Stripe Basic:

[wp_pg_eStore_subscription_button id="1" gateway="stripe_basic_subsc"]

(Replace 1 with your actual eStore product ID)

Customizing the Look of the Stripe Subscription Button

WP eStore plugin allows you to customize all of your subscription buttons by using a custom button image of your choice. If you want to customize the look of your stripe subscription button then read this post.

Using Stripe Subscription Button with Fancy Display Template

You can use the following shortcode to use a fancy display template with the Stripe subscription button:

[wp_eStore_fancy_display id="50" type="3" style="1" gateway="stripe_basic_subsc"]

WP eStore product ID of the item is 50 in the above example. You will need to change that value to your actual product ID.

Payment Gateway Bundle Checkout Experience

With our Payment Gateway Bundle addon you can add more payment gateway options to your store in addition to the core payment gateways offered in the WP eStore plugin. This includes processing both on-site and off-site payments.

You may already be familiar with an off-site checkout where the payment is collected on a secure page on the payment gateway’s site. However, In an on-site checkout scenario, the user never leaves your site and the payment is processed via credit card on a secure page on your site (a SSL certificate is required for the page that will take the user’s credit card).

How the Checkout Flow Works

Depending on the type of checkout option a payment gateway offers, the checkout flow in our payment gateway bundle will vary.

If you are accepting payments with a gateway like Stripe or PayPal Pro then here is how it will work:

Step 1) The customer adds item(s) to the shopping cart by clicking the add to cart buttons of your products. The item(s) will appear in the shopping cart.

screenshot of selecting a payment gateway in the eStore shopping cart

Step 2) The customer clicks the checkout button in the cart.

Since Stripe requires the payment to be processed on-site, the user will be redirected to a page on your site called “Collect Details” when the “Proceed to Checkout” button is clicked. You can edit the title of the “Collect Details” page to anything you want by editing the page in WordPress page editor. Don’t change the URL of the page though.

Step 3) Once the customer lands on the “Collect Details” page, he will need to enter some details to complete the checkout.

If all the items in the shopping cart are digital items then no shipping information will be collected from the user on this page. However, If there is one or more physical product in the cart, a shipping block will also appear in addition to the Billing and Credit Card details fields.

The screenshot below shows you how the “collect details” page looks like.

screenshot of payment gateway bundle collect details page

Step 4) When the “Submit” button is clicked, the payment will be processed in the backend and upon completion, the user will receive a success message.

Step 5) The plugin will complete the post payment processing tasks and send a notification email to the customers (and the admin).

Optionally, you can create and configure a Thank You page on your site (where the customers will be redirected to after the payment).

WP eStore PayPal Installment Payment Addon

Ever wanted to offer your customers the option to pay via installment payment for your products or services? The eStore PayPal Installment Payment addon allows you to accept payments in installments for the products or services you sell from your website. Offering an installment payment option can be very helpful if you are selling high priced items.

You can offer installment plans that collect the first installment on checkout, with up to 3 additional installments. Or, you can set up installment plans that defer the first installment, with up to 4 installments.

Installing the eStore PayPal Installment Addon

You can install this addon the same way you install any WordPress plugin:

  • Go to the “Add New” plugins screen in your WordPress admin area
  • Click the “upload” tab
  • Browse for the addon file (estore-paypal-installment.zip)
  • Click “Install Now” and then activate the plugin

Product Configuration

In order to configure PayPal Installment specific options for a product click “Add/Edit Products” from the admin dashboard.

screenshot showing how to add a new product in the wp estore plugin

Click on the “PayPal Installment Specific Settings” section and configure the details of your installment plan.

screenshot showing how to configure PayPal Installment specific settings in the WP eStore plugin

Click Save product.

Please note that All payments must be collected within one year of checkout (This is a requirement of PayPal Installment checkout from PayPal). So you need to configure your plan accordingly.

Shortcode Usage

You can now add the following shortcode to a WordPress page (your landing page) to create an installment payment button for a product or service:

[eStore_paypal_installment id="1"]

Here, id is your unique eStore product ID.

Using Installment Payment Button With Fancy Product Display

If you want to use it with a fancy product display template then you just need to make sure that the product in question has the installment details configured. Then you can use the fancy display template shortcode as usual.

Get the PayPal Installment Addon

The price of this addon is $39.00

Make Credit Card the Default Checkout Option for PayPal Standard

When your customers checkout using the standard PayPal checkout option in eStore, PayPal figures out (using a cookie) if the user has PayPal account or not. Then it presents the checkout option (Paypal account or Credit card) accordingly. The customers can always switch between the checkout options from this page and make the payment.

If you want to force the credit card checkout option to be the default option, then use this addon plugin on your site. When the customers land on the PayPal checkout page, the credit card payment option will be open by default.

Note: You need to have a PayPal business or premiere account to accept credit card from your customers.

credit-card-default-paypal-checkout-option

Installing the Addon

You can install this addon the same way you install any WordPress plugin:

  • Go to the “Add New” plugins screen in your WordPress admin area
  • Click the “upload” tab
  • Browse for the addon file (estore-card-default-paypal-checkout-option.zip)
  • Click “Install Now” and then activate the plugin

Using the Addon

You just have to keep this addon active.

Download the Addon

You can download this addon from the addon download area of our customer only support forum.

How to Setup PayPal IPN Notification

Instant Payment Notification (IPN) allows you to integrate your PayPal payments with your website’s back-end operations, so you get immediate notification and authentication of the PayPal payments you receive.

Note: This is not needed for the PayPal Commerce Platform (PayPal’s New API).

Video Tutorial on PayPal IPN Setup

Written Instruction

Do the following to enable IPN in your PayPal account:

locating-IPN-new-PayPal
  1. Log into your PayPal account.
  2. Click on the “cog” icon in the right hand corner and then on “Account Settings“.
  3. Under “Solutions and Services” click on “Website Payments“.
  4. Look for an option labelled “Instant Payment Notification“. Click on the update button for that option.
  5. Click “Choose IPN Settings“.
  6. Enter the URL of your website and hit “Save“.
enable-paypal-ipn-in-your-profile

Resend PayPal IPN Message

Read the how to Resend PayPal IPN message tutorial.

PayPal Beginner Video Tutorials

The PayPal beginner video tutorials is a good resource to check if you are new to PayPal as a merchant.

WP Payment Gateway Bundle Stripe Subscription Setup

After you install the WP Payment Gateway Bundle plugin, you will need to configure some Stripe Gateway specific settings in the plugin which you will need to obtain from your Stripe merchant account.

Note: There are a couple of different checkout flows available for the Stripe gateway. The recommended setup is the Stripe SCA setup explained here.

You can find the Stripe specific settings required by the plugin under the “Gateway Settings” tab when you go to the payment gateway bundle plugin’s settings menu. The following screenshot shows how you can access the settings page of this addon:

In order to configure the Stripe portion of the payment gateway bundle you will need to obtain the required details from your Stripe merchant account by following the steps outlined below:

Step 1: Log into your Stripe merchant account and click on the API Keys menu item (Under Developers).

Step 2:  Copy the values for the secret key and the publishable key as shown in the figure above.

Step 3: Now from your WordPress administration panel, go to Stripe Settings (under WP eStore -> Payment Gateway Bundle -> Gateway Settings) and check “Use Stripe Payment Gateway” option.

Step 4: Enter your Secret Key.

Step 5: Enter your Publishable Key.

Step 6: Enter a selector label for Stripe. For example: Stripe Payment (This text will be displayed in the select box in the shopping cart as a checkout option).

Step 7:  Copy the Stripe Webhook URL for your site and add it as a webhook endpoint in your Stripe account (Developers -> Webhooks). You should only have one webhook set up for our plugin (remove any other URL that you may have configured previously for our plugin)

You can either choose to be notified of all the events (may increase load on your server) or select the ones that our plugin processes at the moment:

  • charge.refunded
  • checkout.session.completed
  • invoice.payment_succeeded
  • customer.subscription.deleted
  • invoice.payment_failed

Step 8: Hit the “Update” button at the bottom to save the settings and now your site is ready to accept subscription/recurring payments via Stripe.

eStore Product Configuration

There are a few things you need to be aware of while you are configuring a product for Stripe subscription.

1) No Trial Payment Amount: Stripe only supports Free Trial. So you cannot charge your customer for the trial period. For example: if you wish to offer one month free trial to your users before they are billed on a recurring basis (2.99/month) you can set up like the following,

  • Trial Billing Amount: 0
  • Trial Billing Period: 1 Month
  • Recurring Billing Amount: 2.99
  • Recurring Billing Cycle: 1 Month
  • Recurring Billing Count: 0
screenshot of eStore product configuration for stripe subscription

If you do not wish to offer a trial, you should leave the Trial Billing Amount and Trial Billing Period fields empty. For example:

  • Trial Billing Amount:
  • Trial Billing Period:
  • Recurring Billing Amount: 2.99
  • Recurring Billing Cycle: 1 Month
  • Recurring Billing Count: 0

2) Recurring Billing: Our Stripe integration supports recurring payments on a daily, monthly or yearly basis. For example: if you wish to charge your customer 2.99/day until cancelled your setup should look like the following,

  • Trial Billing Amount:
  • Trial Billing Period:
  • Recurring Billing Amount: 2.99
  • Recurring Billing Cycle: 1 Day
  • Recurring Billing Count: 0

If you wish to charge your customers 2.99 every 7 days for 3 installments your setup should look like the following,

  • Trial Billing Amount:
  • Trial Billing Period:
  • Recurring Billing Amount: 2.99
  • Recurring Billing Cycle: 7 Day
  • Recurring Billing Count: 3

If you wish to charge your customers 2.99 every/month until cancelled your setup should look like the following,

  • Trial Billing Amount:
  • Trial Billing Period:
  • Recurring Billing Amount: 2.99
  • Recurring Billing Cycle: 1 Month
  • Recurring Billing Count: 0

If you wish to charge your customers 2.99/month for 6 installments your setup should look like the following,

  • Trial Billing Amount:
  • Trial Billing Period:
  • Recurring Billing Amount: 2.99
  • Recurring Billing Cycle: 1 Month
  • Recurring Billing Count: 6

If you wish to charge your customers 2.99 every 2 months until cancelled your setup should look like the following,

  • Trial Billing Amount:
  • Trial Billing Period:
  • Recurring Billing Amount: 2.99
  • Recurring Billing Cycle: 2 Month
  • Recurring Billing Count: 0

3) Reattempt on failure: This checkbox does not have any effect on a Stripe subscription.

4) Editing the subscription amount: Once you make the first transaction of a newly created eStore subscription product, a plan is automatically created in your Stripe account. Stripe doesn’t allow the editing of an existing plan. So if you need to edit the subscription amount after a transaction, create a NEW estore product with the new subscription price.

Shortcode for Subscription Button

You need to embed the following shortcode in a WordPress Post/Page to accept recurring payments via Stripe:

[wp_pg_eStore_subscription_button id="1" gateway="stripe_subsc"]

(Replace 1 with your actual eStore product ID)

Customizing the Look of the Stripe Subscription Button

WP eStore plugin allows you to customize all of your subscription buttons by using a custom button image of your choice. If you want to customize the look of your stripe subscription button then read this post.

Using Stripe Subscription Button with Fancy Display Template

You can use the following shortcode to use a fancy display template with the Stripe subscription button:

[wp_eStore_fancy_display id="50" type="3" style="1" gateway="stripe_subsc"]

WP eStore product ID of the item is 50 in the above example. You will need to change that value to your actual product ID.

WP Payment Gateway Bundle – Stripe Gateway Setup

Note: There are a couple of different checkout flows available for the Stripe payment gateway. The recommended setup is the Stripe SCA setup explained here.

Read this page to get a good idea of how the checkout flow works when you use the gateway bundle addon.

After you install the WP Payment Gateway Bundle plugin you will need to configure some Stripe Gateway specific settings in the plugin which you will need to obtain from your Stripe merchant account.

You can find the Stripe specific settings required by the plugin under the “Gateway Settings” tab when you go to the payment gateway bundle plugin’s settings menu. The following screenshot shows how you can access the settings page of this addon:

wp payment gateway bundle settings

In order to configure the Stripe portion of the payment gateway bundle you will need to obtain the required details from your Stripe merchant account by following the steps outlined below:

Step 1: Log into your Stripe merchant account and click on the Account Settings menu item (Under Your Account).

stripe menu setup screenshot

Step 2: Switch to the API Keys tab. Copy the values for the secret key and the publishable key as shown in the figure below.

stripe api setup screenshot

Step 3: Now from your WordPress administration panel, go to Stripe Settings (under Payment Gateway Bundle->Gateway Settings) and check “Use Stripe Payment Gateway” option.

Step 4: Enter your Secret Key.

Step 5: Enter your Publishable Key.

Step 6: Enter a selector label for Stripe. For example: Stripe Payment (This text will be displayed in the select box in the shopping cart as a checkout option).

Step 7: Copy the Stripe Webhook URL for your site and add it as a webhook endpoint in your Stripe account (Developers -> Webhooks). You should only have one webhook set up for our plugin (remove any other URL that you may have configured previously for our plugin).

You can either choose to be notified of all the events (may increase load on your server) or select the ones that our plugin processes at the moment:

  • charge.refunded
  • checkout.session.completed
  • invoice.payment_succeeded
  • customer.subscription.deleted
  • invoice.payment_failed

Step 8: Hit the “Update” button at the bottom to save the settings and now your customers can checkout using stripe gateway.

Creating Buy Now Type Buttons For Stripe

If you want to use “Buy Now” type buttons instead of the standard “Add to Cart” buttons then check the following documentation to learn how to create buy now buttons for any payment gateways offered in WP eStore plugin: