Tips and Tricks WP eCommerce

eCommerce Solution for WordPress Blog

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 – Freshbooks Setup

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

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

Step 1: Log in to your FreshBooks account and click on the My Account link and then click on the FreshBooks API menu item (see 1 and 2 in figure below).

Step 2: Copy the values for the API URL and Authentication Token fields as shown by “3” in the figure below.

Getting Freshbooks API Details

Step 3: Now ensure that you have configured your FreshBooks account so it can accept online payments by going to Settings and then clicking Online Payment as shown in the figure below:

Freshbooks Online Payment Setup

You can specify various payment options as shown in “3” in the figure above and once you have selected options you want, click on the “Save” button to save you your changes.

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

Step 5: Enter your API URL.

Step 6: Enter your Authentication token.

Step 7: Enter a selector Label for Freshbooks or you can leave this as default. (This text will be displayed in the select box if a customer chooses Freshbooks for checkout).

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

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 – ePay dot DK Gateway Setup

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

Step 1: Log in to your ePay.dk merchant account. Click Payment system under Settings.

ePay.dk Setup

Step 2: Copy your merchant number to a text file (you will need it to enter in the payment gateway bundle settings). Enter your domain name in the Domain(s) filed (where you will be using payment gateway bundle plugin). Click “Update settings for domains”.

ePay.dk Gateway Setup 2

Step 3: Enter a key for MD5 security check (Don’t forget to copy this to a text file. You will need to enter it in the payment gateway bundle settings) and select “On accepturl and by authorization” option. Click “Update settings for the payment system”.

ePay.dk Gateway Setup 3

Step 4: Now go to ePay.dk Settings (under Payment Gateway Bundle->Gateway Settings) and check “Use ePay.dk Payment Gateway” option.

ePay.dk Gateway Setup 4

Step 5: Enter your epay.dk merchant number.

Step 6: Enter your MD5 key created in epay.dk.

Step 7: Enter a selector Label for ePay.dk (This text will be displayed in the select box if a customer chooses ePay.dk for checkout).

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

WP Payment Gateway Bundle – eWAY Gateway Setup

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

eWAY Settings Menu

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

Step 2: Enter your eWAY Customer ID

Step 3: Enter your eWAY username

Step 4: Enter a Company Name (optional)

Step 5: Select the country you are using eWAY from.

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

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

WP Payment Gateway Bundle – Authorize.net ARB Setup (Automated Recurring Billing)

The Authorize.net ARB (Automated Recurring Billing) lets your customers pay for a subscription/recurring payment without leaving your site (onsite checkout).

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

Do the following to use ARB with the Payment Gateway Bundle plugin.

Step 1: Before you can use ARB, you will need to configure some Authorize.net AIM (Advanced Integration Method) specific settings in the plugin. Follow the setup instruction from the following link to complete the authorize.net merchant specific setup:

Step 2: Login to your Authorize.net merchant account and go to “Account > Select Silent Post URL”.
screenshot showing the silent post menu the authorize.net account
Copy the “Silent Post URL” value for your site from the gateway bundle settings and paste it into the URL field.
screenshot showing the silent post URL field in the authorize.net account
This is where Authorize.net will send notification of a subscription billing/cancellation.
Step 3: Enable the recurring payment facility (ARB) in your Authorize.net merchant account. Authorize.net requires you to activate this service in your account before you can use it.
Step 4: Once you have the setup done you can place a subscription button for a WP eStore subscription product using the following shortcode:
[wp_pg_eStore_subscription_button id="1" gateway="auth_arb"]
1 is the eStore product ID in this example so change it to your product ID.

Important Notes

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

  • 1. ARB doesn’t have any option to set a different “trial period” (e.g. 7 days) from the one specified in the “Recurring Billing Cycle” (example, 1 month). So “Trial Billing Period” will always follow the values specified in the “Recurring Billing Cycle” (under Subscription/Recurring Payment settings section). Basically you can’t set a different period for trial and recurring. For example: Trial Period: 10 days, Recurring Period: 30 days won’t work. If you set Recurring Period: 30 days, Trial Period will also have to be 30 days. Please note that you will only need to worry about this option if you choose to offer a trial.
  • 2. “Recurring Billing Cycle” cannot be more than 1 year or less than 7 days (as ARB only support a Subscription Length of 7-365 days or 1-12 months). The term “Recurring Billing Cycle” refers to how often it will be charged. For example: once every 7 days, once every month (30 days), once every year (365 days). Here, 7 days is the minimum value that ARB accepts and you can set it up to a year (365 days).
  • 3. A Once off payment doesn’t apply on ARB. So entering -1 in the “Recurring Billing Count” field will not work.
  • 4. “Reattempt on failure” option is not applicable for Authorize.not ARB since it doesn’t send any notification when the subscription is rebilled or a payment fails. They do claim that they have a silent post feature to notify a remote script when a particular event occurs on their site. But it doesn’t seem to work and they don’t have any official documentation on it either.
  • 5. A free trial can be offered by specifying “0” in the “Trial Billing Amount” field. For example - If you set Trial: 0.00 for 1 Month and Recurring: 5.00 for 1 Month, Authorize.net will not charge any initial amount when the user subscribes. When one month runs out it will charge 5.00 (recurring) and will keep doing it every month unless you limit the number of occurrences (By specifying a value in the “Recurring Billing Count” field).
  • 6. If you are using a trial amount then the number of occurrences/installments (Recurring Billing Count) need to include the trial one too. For example – if you specify “4” in the “Recurring Billing Count” field then ARB will charge 1 count as the trial and 3 count as the actual recurring subscription. That means Authorize.net will charge the initial amount (trial amount) and rebill 3 more times (recurring amount). If you don’t have any trial then it will charge the initial amount (recurring amount) and rebill 3 more times (recurring amount).

Here is a screenshot of how the eStore subscription settings section looks like:

wp estore subscription

Frequently Asked Questions

1. Do I have to have the Authorize.net ARB service for this to work?

– yes, because it uses the Authorize.net ARB (Automated Recurring Billing) api

2. Can I use both PayPal and Authorize.net at the checkout and they can choose which option that they want?

- Subscription buttons work like “Buy Now” buttons. Once you click it takes you to the checkout page. So the users don’t get to select any checkout method. They click on a button and it takes them to a page where they make the payment using their credit card.

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.