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 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 Payment Gateway Bundle – 2Checkout Subscription Setup

If you want to set up your website with 2Checkout to accept recurring payments please follow these steps:

Step 1) Read our 2Checkout Setup Guide and configure everything according to the instructions.

Step 2) In the INS (Instant Notification Settings) section of your 2Checkout account, please specify the notification URL for “Recurring Installment Success” and “Recurring Stopped”.

2checkout-ins-recurring-installment-started-setting

2checkout-ins-recurring-installment-stopped-setting

The URL you enter in there should look like the following:

http://www.example.com/?estore_2co_ipn=process

Replace “http://www.example.com” with your own site URL.

You need to have this URL configured for the following types of notifications:

  • Order Created
  • Recurring Installment Success
  • Recurring Stopped

Step 3) Save the settings.

Step 4) Insert the following shortcode into a post/page to create a subscription button:

[wp_pg_eStore_subscription_button id="1" gateway="2co_subsc"]

Make sure to replace the value of id with your eStore product id.

Now your website is ready to accept recurring payments (subscription) using 2Checkout gateway.

Important Notes

2Checkout does not support recurring payments in days. You can use weeks instead. In order to do so please specify the equivalent number of days in your eStore product. For example:

  • Recurring Billing Cycle: 7 Day (1 week)
  • Recurring Billing Cycle: 14 Day (2 weeks)
  • Recurring Billing Cycle: 28 Day (4 weeks)

 

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 – PayPal Payments Pro Subscription Setup

If you want to set up your website with PayPal Payments Pro to accept recurring payments please follow these steps:

Step 1: Read our PayPal Payments Pro Setup Guide and configure everything according to the instructions.

Step 2: Login to your PayPal account and follow these instructions to set up your ipn (Instant Payment Notification) listener:

  • Click Profile on the My Account tab
  • Click Instant Payment Notification Preferences in the Selling Preferences column
  • Click Choose IPN Settings to specify your listener’s URL and activate the listener

The following screen appears:

paypal ipn settings screenshot

  • Specify the URL of your website in the Notification URL field
  • Click Receive IPN messages (Enabled) to enable your listener
  • Click Save

Step 3: Embed the following shortcode on a post/page to create a subscription button:

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

Make sure to replace the value of id with your eStore product id.

Now your website is ready to accept recurring payments (subscription) using PayPal Payments Pro gateway.

WP Payment Gateway Bundle – PayPal Payments Advanced Setup

The following video will give you a basic introduction of PayPal Payments Advanced and the requirements for the integration.

After you install the WP Payment Gateway Bundle plugin you will need to configure some PayPal Payments Advanced specific settings in the plugin and in your PayPal Manager Merchant account. This will allow you to accept payments using one of the hosted checkout templates.

You can find the PayPal Payments Advanced Checkout 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 plugin:

Payment Gateway Bundle Plugin Settings

Payment Gateway Bundle Plugin Settings

In order to complete the PayPal Payments Advanced settings simply follow the steps outlined below:

Step 1: Check the “Use PayPal Payments Advanced Gateway” checkbox from the “PayPal Payments Advanced Settings” section of the plugin.

Step 2: Fill in the API details. There are four pieces of API information that you need to enter in the settings so the plugin can process the payment using PayPal Payments Advanced:

  • Partner
  • Vendor
  • User
  • Password

screenshot showing paypal payments advanced settings

 

These are basically the api credentials that you use to login to your PayPal Manager account.

screenshow showing how to login to paypal manager

If you don’t have an account yet you can create one by following the “I would like to create a new account” link.

Step 3: Once you have logged into your paypal manager account switch to the Service Settings tab.

screenshot showing paypal manager account

This is where you will be able to customise the settings and the layout for your hosted checkout page. First, click on the Set up option.

Step 4: The Set up tab contains most of your settings. The default options are fine. So I’m just going to walk you through some of the major options.

screenshot showing paypal manager setup error page

If you are going to run some testing before you go live make sure to set the Transaction Process Mode to “Test”. Otherwise it should be set to “Live”.

Enter a URL where the user will be redirected to upon cancellation or if an error occurs. You can just copy the value of Transaction Error Page (under Settings->Payment Gateway Bundle->General Settings) and paste it here for now.

Step 5: Move on to the Billing & Shipping info sections. You can just check the fields that you would like a user to fill out (or check everything so you can get all the information).

screenshot showing billing and shipping info of paypal manager

Step 6: Now is the important part which is the Payment Confirmation Section. This is where you need to specify how your website will receive the payment notification.

screenshot showing paypal manger payment confirmation section

Make sure that you have set the options to the following:

  • Show Confirmation page:  On my website
  • Enter Return URL: the return url specified in the eStore settings (WP eStore->Settings->General Settings->General Image and Page URL Settings->Return URL)
  • Return URL Method: Post

Step 7: In the Security Options section select Enable Secure Token: Yes.

screenshot showing paypal manager security token settings

Click on the Save Changes button to update your settings.

That’s pretty much it. There is still one thing that you need to do. Go back to the top of the page and select the Customize option.

screenshot showing paypal manager layout options

Select Layout A. Currently the gateway bundle addon is integrated with Layout A (since it gives a merchant the flexibility of customizing the checkout form with billing & shipping information). We plan to integrate the other two layout options in future.

Click on the Save and Publish button at the bottom of the page to update your settings.

Now your website is ready to accept payments using PayPal Payments Advanced.

Getting Started with WP Payment Gateway Bundle Addon

If you have just installed the Payment Gateway Bundle Addon for the first time, this guide will help you set up your site so it’s ready to accept payment via one of your preferred payment gateways.

The Payment Gateway Bundle is an Addon for the WP eStore plugin. So before you move on to the Payment Gateway Bundle setup you need to make sure that you are familiar with WP eStore plugin configuration. Here is what you need to do:

Step 1

Watch the eStore’s basic setup video tutorials and complete the required setup of the plugin so you can start selling (Ignore this step if you have done this already).

Step 2

Once you have configured WP eStore plugin, created a product, placed an “Add to Cart” button on your site, you can go to the next step.

Step 3

Install the WP Payment Gateway Bundle Addon (if you haven’t installed it already).

  • Go to the Add New plugins screen in your WordPress admin area
  • Click the upload tab
  • Browse for the plugin file (wp-payment-gateway.zip)
  • Click Install Now and then activate the plugin

Step 4

Go to Settings > Payment Gateway Bundle interface from your WordPress admin dashboard.

Step 5

Configure and save the general settings of the Payment Gateway Bundle extension. The general settings page has two sections:

a) General Settings

This section allows you to set your language, currency code, currency symbol etc.

Also, there are some pages that automatically gets created for you when you first install the addon (simply check the settings and verify that a URL value exists in the field in question):

  • Return URL: The Page where your users will be redirected to after a successful transaction. You can also use this page to deliver digital downloads to your customers after the transaction.
  • Transaction Error Page: The page where your users will be redirected to if there is an issue with the transaction.
  • Form Processing Page URL: The page where your users fill up the details before they make the payment.

Please make sure that none of the fields are empty. If a page didn’t get created for some reason, you should read the help text for the field and create the page manually.

b) Testing and Debugging Settings

This section allows you to run a transaction in test mode (if you need).

There is also a debug option. You can enable this to track every step of a user’s transaction (This can help you quickly identify a transaction failure and why it happened). You should keep this option enabled if you are having an issue with getting the plugin to work correctly.

Hit the Update button to save the changes.

Step 6

Switch to the Gateway Settings tab at the top of the page.

This is where you can fill up the API details specific to the payment gateway you want to use.

We have documentation that explains how to setup each payment gateway supported by the Payment Gateway Bundle addon. Please make sure to check the gateway specific documentation (marked blue in the screenshot below) before you enter any information.

Click the Update button to save the settings.

Step 7

Read this documentation to learn how to setup the WP eStore plugin to use ONE payment gateway or show a selection of multiple gateways (the ones that you have enabled).

If you show multiple gateways, your customers will be able to choose the checkout option they want to use.

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: