Tips and Tricks WP eCommerce

eCommerce Solution for WordPress Blog

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.

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 – Configuring One or Multiple Payment Gateways

When you first install the WP eStore plugin, you will see that only the PayPal payment gateway is enabled by default. Most users only use the PayPal standard gateway so that option is automatically enabled for you in the settings when you install the plugin.

However, you have the freedom to uncheck/disable PayPal checkout from the settings and enable any other payment gateway that you prefer to use at any time.

There are two types of setups you can go after with the gateway checkout option for your store:

  1. You can process all of your checkouts using ONE payment gateway
  2. You can give your users an option to choose which gateway they want to use for a checkout

1. Using One Gateway For All Chekcout

This setup is the widely used setup. All of your customers will checkout via the payment gateway that you specified (the customers don’t have a choice). For example, when you specify PayPal gateway, all of your customers will be able to checkout via PayPal.

Lets say you have added the Payment Gateway Bundle addon and you want to process checkout via Google Checkout. You would do the following to achieve this:

  • Go to WP eStore Settings -> Payment Gateway Settings and make sure all the payment gateways offered in eStore are unchecked/disabled.
  • Go to payment gateway bundle addon settings -> Gateway Settings menu and check the “Use Google Checkout Payment Gateway” checkbox to enable Google checkout.

Now, when your customers add items to the shopping cart and click the checkout button, they will be able to pay you for the items via Google Checkout.

2. Using Multiple Gateways At the Same Time

You can use this setup to give your customers the choice of choosing the payment method for a checkout from a range of selections. For example, you can enable both PayPal and Google Checkout gateways and the customers will be able to choose which one they want to use and make then payment.

Lets say, you want to use both PayPal and Google Checkout at the same time. You would do the following to achieve this setup:

  • Go to WP eStore Settings -> Payment Gateway Settings and make sure to enable/check the “Use Multiple Payment Gateways” option.

  • Go to the “PayPal” settings section and make sure the “Use PayPal Payment Gateway” field is checked
  • Make sure to enter your correct PayPal merchant account details in there too
  • Go to payment gateway bundle addon settings -> Gateway Settings menu and check the “Use Google Checkout Payment Gateway” checkbox
  • Make sure to enter your correct Google Checkout merchant account details in there too

Now, when your customers add items to the shopping cart, they will be able to select between PayPal or Google Checkout to make the payment for the items.

You can enable as many gateways as you wish (you will of-course need to have a merchant account with the gateway you select).

The following screenshot gives you an idea of how your customers can select a payment method when they are about to do a checkout.

Multiple payment gateways

WP Payment Gateway Bundle – CCBILL Setup

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

You can find the CCBILL 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 configure the CCBILL portion of the payment gateway bundle you will need to obtain the required details from your CCBILL account by following the steps outlined below:

Step 1: Login to your CCBILL account and switch to the Account Info tab. Now click on the Sub Account Admin link under Manage the Sub Accounts. Choose the sub account that you want to use for this integration (If you don’t have a sub account yet create one first).

CCBILL Setup

Step 2: Click on the Form Admin option

CCBILL Setup

Step 3: You will be able to manage all the forms (under this sub account) from the Form Admin menu. Now create a new form specifically for this integration (we will be using a standard form with credit card options for the time being).

CCBILL Setup

Step 4: Once you set up the form you need to enable Dynamic Pricing option on this form (Contact CCBILL if you cannot enable it manually).

Step 5: Go back to the Sub Account Admin panel. There are some details that you can update here.

a) First, click on the Basic option.

CCBILL Setup

Specify a page URL for transaction approval (A page on your site where the customer will be redirected to after a successful transaction) and denial (A page on your site where the customer will be redirected to if the transaction is denied)

CCBILL Setup

b) Now click on the Advanced option. Specify a URL in the Approval Post URL and Denial Post URL fields (this is where CCBILL will send transaction related data. You can just specify your transaction approval page URL here).

CCBILL Setup

c) Finally, click on the User Management option. There is a select box called Collect Username/Password. Set this value to Do not Collect Usernames and Passwords.

CCBILL Setup

Make sure to reset all the forms after you make any changes.

Step 6: Contact CCBILL to generate a Salt value for you. It will be used to create a hash (encoded data) which can be verified by CCBILL.

Step 7: Now from your eStore plugin menu in your WordPress administration panel, go to CCBILL Settings (under Payment Gateway Bundle->Gateway Settings) and check Use CCBILL Payment Gateway option.

Step 8: Enter your Client Account Number

Step 9: Enter your Client Sub Account Number

Step 10: Enter the Form Name

Step 11: Enter the Salt Value

Step 12: Hit the Update button at the bottom to save the settings and now you are ready to use CCBILL with the WP Payment Gateway Bundle Plugin

CCBILL Subscription Setup

If you want to use the subscription feature of CCBILL you need to configure a webhook URL where CCBILL will send notification of events happened in your account.

To create a new webhook switch to Sub Account Admin (under Account Info)  from your CCBILL account Dashboard.

ccbill setup

Click Webhooks and set the Webhook URL to the site where you are using the payment gateway bundle addon. Click All so CCBILL sends notification for all the events.

ccbill-webhook

Select a location (Satellite Locations) closer to your server. If you are not sure simply keep all of them selected (CCBILL will automatically choose the most effective server from your selections).

Once you are done click the Update button which will finish creating the webhook.

CCBILL Payment Button Configuration

Now that you have the setup done you can either place a buy now button or a subscription button for a WP eStore product using one of the following shortcodes:

Shortcode for Buy Now button:

[wp_eStore_buy_now_for_specific_gateway id="1" gateway="ccbill" button_text="Buy It Now"]

Here, id = The Unique ID of the eStore product, gateway = the payment gateway you are using to accept payment with this button, button_text = The text you want to display for this button [this field is optional. You don’t need to include this parameter if you want to use the default button name].

Shortcode for Subscription button:

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

Here, id = The Unique ID of the eStore subscription product, gateway = the payment gateway you are using to accept payment with this button.

Important Notes

CCBILL doesn’t offer the same level of flexibility that PayPal does when it comes to creating a subscription/recurring payment. CCBILL has some restrictions for recurring payment which we have to abide by in our plugin.

  • The minimum amount (both trial & recurring) that can be set is $2.95 (upto $100.00 maximum)
  • If you specify a trial period for a product it has to be between 2 to 365 days.
  • The recurring period can only be set on a monthly basis. For example: 1 month, 2 months, 3 months or 30 days, 60 days, 90 days (you cannot set a value like 15 days, 25 days or 45 days). If you want to set a value over 3 months you may need to get permission from CCBILL.
  • A Once off payment doesn’t apply on CCBILL subscription. So entering -1 in the Recurring Billing Count field will not work.
  • Reattempt on failure option is not applicable for CCBILL subscription.
  • Free trial is not available for CCBILL subscription. So specifying 0 in the Trial Billing Amount field won’t work.
  • Recurring Billing Count field represents the total number of occurrences of the subscription (including trial, if any)

Using CCBILL in Sandbox Mode

In addition to checking the Enable Sandbox/Testing Mode option in the Settings, you will actually have to set up a test user on your CCBILL account to run a transaction in sandbox mode.

You can set up a test user from the Transaction Test Settings option (under Main Account).

CCBILL Test User Setup

 

WP Payment Gateway Bundle – ClickBank Setup

What to Expect From a ClickBank Integration

ClickBank integration is good for adding a Buy button like the one shown below to allow a checkout of your product from the landing/pitch page. When the button is clicked the visitor is sent to ClickBank for payment. After the payment the customer will receive an email which will contain encrypted download link for the item he/she just paid for.

ClickBank is not ideal for running a store where you expect your customers to add multiple items to the shopping cart and then checkout.

ClickBank Limitations

ClickBank has the following checkout limitations:

  • ClickBank only lets you checkout a product that you have configured in your ClickBank account. So you will need to configure the product in Your ClickBank account.
  • ClickBank only lets you do one item checkout at a time. So you cannot add 5 items to the shopping cart and checkout via ClickBank.

ClickBank Setup Steps

After you install the WP Payment Gateway Bundle plugin you will need to configure some ClickBank specific settings in the plugin and in your ClickBank merchant/vendor account. You can find the ClickBank 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 ClickBank settings simply follow the steps outlined below

ClickBank Setup Settings

Step 1: Check the “Use ClickBank Payment” option from the ClickBank Settings section.

Step 2: Enter your ClickBank Account Username, also known as your ClickBank ID, nickname, account ID, or affiliate/vendor ID.

Step 3: Enter your ClickBank account secret key. You can configure your secret key from the "Account Settings -> My Site -> Advanced Tools" section of your ClickBank account.

Step 4: Hit the “Update” button at the bottom to save the settings.

Step 5: Log into your ClickBank account and Edit your “Advanced Tools” section. Enter the URL shown in the “ClickBank Instant Notification URL value” field of the plugin’s ClickBank settings section. The URL will look similar to the example shown below

http://www.your-domain.com/?wp_pg_clickbank_notify=1

ClickBank Account’s Advanced Tools Settings

Step 6: Now that all the setup is complete you can use the following sortcode to place a “Buy” button for your eStore and ClickBank product:

[wp_pg_eStore_clickbank_buy_now cb_item_number="1" product_id="4"]

cb_item_number = Your Clickbank product item number
product_id = Your WP eStore product ID for this item

Customizing the Look of the Clickbank Buy Now Button

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

WP Payment Gateway Bundle – Verotel FlexPay Gateway Setup

After you install the WP Payment Gateway Bundle plugin you will need to configure some Verotel specific settings in the plugin and in your Verotel merchant profile account. You can find the Verotel 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 Verotel profile settings simply follow the steps outlined below so after a payment, Verotel can send payment notification to the plugin for post payment processing.

Step 1: Log in to your Verotel Merchant account go to My Setup tab. Click FlexPay options (under Order page)

Verotel FlexPay Setup 1

Step 2:  Select the website you want to configure this option for (Copy the shopID associated with the website to a text file. you will need to enter this in the payment gateway bundle settings). Click Continue

Verotel FlexPay Setup 2

Step 3: Check FlexPay enabled option. Enter a URL in the Success URL field (Your customer will be redirected to this URL after a successful payment). A signature key should be automatically generated for you (you will need to enter this signature key in the payment gateway bundle settings. So copy this to a text file).

Verotel FlexPay Setup 3

Click Continue to save the settings.

Step 4: Go to My Setup tab again and click Order page setup.

Step 5: Select your website and click Continue. As you can see that there are options for you to customize the order page. By default the order page doesn’t collect any billing or shipping details from the user. But you can set it so the user needs to fills them in during checkout. You at least need to have the Require billing address option checked for the payment to be successfully processed. You can leave the rest of the options to their default values for now.

Note: If the user chooses United States as the country an additional State option is also displayed on the verotel order page. If the user is not from US there won’t be any option to select the state. In that case the plugin will set the user’s state value as undefined.

Step 6: Now go to Verotel FlexPay Settings (under Payment Gateway Bundle->Gateway Settings) and Check the “Use Verotel FlexPay Payment Gateway” option.

Verotel FlexPay Setup 4

Step 7: Enter your ShopID

Step 8: Enter your Signature Key

Step 9: Enter a selector Label for Verotel FlexPay (This text will be displayed in the select box if a customer chooses Verotel FlexPay for checkout)

Step 10: Hit the “Update” button at the bottom to save the settings and now you are ready to use Verotel FlexPay Checkout with the WP Payment Gateway Bundle addon.

WP Payment Gateway Bundle – SagePay Payment Gateway Setup

After you install the WP Payment Gateway Bundle plugin you will need to configure some Sagepay specific settings in the plugin and in your Sagepay merchant profile account. You can find the Sagepay 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 Sagepay profile settings simply follow the steps outlined below so after a payment, Sagepay can send payment notification to the plugin for post payment processing.

sagepay payment gateway setup

SagePay Setup Settings

Step 1: Check the “Use Sagepay Payment Gateway” option from the Sagepay Settings section.

Step 2: Enter your Sagepay Vendor Login Name

Step 3: Enter the email address where you want to receive the confirmation email after a successful transaction

Step 4: Enter your Sagepay encryption password.

Note: A unique Vendor name and encryption password are provided when Sage Pay creates an account for you. This data is emailed to the person registered on the account. Please email [email protected] if you need to retrieve your password.

Step 5: Hit the “Update” button at the bottom to save the settings and now you are ready to use Sagepay with the WP Payment Gateway Bundle Plugin.

WP Payment Gateway Bundle – Authorize.net AIM Setup (Advanced Integration Method)

The Authorize.net AIM (Advanced Integration Method) lets your customers checkout and pay for products without leaving your site (onsite checkout).

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 Authorize.net AIM (Advanced Integration Method) specific settings in the plugin. This will let you process credit card on your own site without sending the customer to Authorize.net site.

You will however need to have SSL certificate installed on your site (it is a requirement from the payment gateway).

You can find the Authorize.net Advanced Integration 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 AIM settings simply follow the steps outlined below:

authorize.net advanced integration (AIM) settings

Auth.net AIM Settings

Step 1: Check the “Use Authorize.net Advanced Integration Methode” checkbox from the “Authorize.net Advanced Integration Settings” section of the plugin.

Step 2: There are two pieces of information that you need to get from your Authorize.net account and specify it in the plugin so the plugin can process the payment using AIM:

  • API Login ID
  • Transaction Key

If you don’t know how to retrieve the API Login ID and Transaction Key you can have a look here

Step 3: Make sure you have filled in the values in the general settings section of this plugin including the “Form Processing Page URL” field.

 

WP Payment Gateway Bundle – PayPal Payments Pro Payment Gateway Setup

The following video shows a basic demonstration of how the PayPal Payments Pro Gateway Works

PayPal Payment Pro Demo

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 addon plugin you will need to configure some PayPal Payments Pro specific settings in the plugin and in your PayPal merchant profile account. This will let you process credit card on your own site without sending the customer to PayPal’s site.

You will however need to have SSL certificate installed on your site (it is a requirement from the payment gateway).

Video Instructions

PayPal makes frequent changes to their interface so the following video may not match exactly as you see things in your PayPal account. However, it should give you a good idea of how it works and how to set it up.

Written Instructions

You can find the PayPal Payments Pro 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:

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

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

Step 2) Fill in the API details. There are three pieces of API information that you need to get from your PayPal merchant account and specify it in the plugin so the plugin can process the payment using PayPal payments pro:

  • API Username
  • API Password
  • API Signature
PayPal Payments Pro Setup

PayPal Payments Pro Setup

If you do not know how to get your PayPal payments Pro API details then the following should help (you can also contact PayPal to get your PayPal Payments Pro account API details):

Getting Your PayPal Pro API Credentials

PayPal frequently makes changes to their interface. So the following steps may not match 100% according to the interface you see in your PayPal account right now. However, the general guideline will still be helpful for you to retrieve your PayPal Pro API details.

  • Log into your PayPal account.
  • Hover over the gear icon and select Account Settings.
  • Go to the Account Access section and select Update next to API Access.
  • Find the NVP/SOAP API Integration (Classic) and select Manage API credentials.
  • Select Show next to API Username, API Password, and Signature.
  • If you have never activated this API, then you may need to request permission for the API first. Select the “Request an API signature” option and submit.
  • Once you can see the API Details, copy and paste the details into the settings fields of the Payment Gateway Bundle addon.

Creating Buy Now Type Buttons For PayPal Pro

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:

WP Payment Gateway Bundle – Google Checkout Payment Gateway Setup

After you install the WP Payment Gateway Bundle plugin you will need to configure some Google Checkout specific settings in the plugin and in your Google checkout merchant profile account. You can find the Google 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 Google Checkout profile settings simply follow the steps outlined below so after a payment, Google Checkout can send payment notification to the plugin for post payment processing.

Step 1: Log into your Google Checkout Sellers account and go to the “Settings” tab:

Google Checkout Merchant Profile Settings

Google Checkout Merchant Profile Settings

Step 2: Click on the “Integration” tab:

Google Checkout Merchant Profile Integration Settings

Google Checkout Merchant Profile Integration Settings

Step 3: Configure the Integration settings as outlined in the screenshot below:

Google Checkout Merchant Profile Integration Settings

Google Checkout Merchant Profile Integration Settings

Step 4: Hit the save button and now you are ready to use Google Checkout with the WP Payment Gateway Bundle Plugin.