CCBill WooCommerce Module

 

Introduction

This section provides installation and configuration instructions for the CCBill WooCommerce billing module. You should have a working knowledge of WordPress and have already installed WooCommerce for WordPress.

Instalation

The CCBill WooCommerce billing module enables easy integration of your CCBill account within the WooCommerce ecommerce platform for WordPress. Installation involves the following steps:

  1. Installing the CCBill payment module for WooCommerce.
  2. Configuring your CCBill account for use with WooCommerce.
  3. Configuring the module with your CCBill account information.

Installation Options

The CCBill WooCommerce module can be installed either by searching for the hosted WordPress plugin, or by uploading the plugin downloaded from the CCBill website.

Installing via WordPress Plugin Directory

From the WordPress administration menu, navigate to Plugins. Type “CCBill” into the text field and click Search Plugins.

Locate the official CCBill plugin for WooCommerce from the search results and click the Install Now link next to the module title.

Installing a CCBill plugin for WooCOmmerce.

Installing via File Upload

From the WordPress administration menu, navigate to Plugins and select Upload from the top menu. Click the Choose File button and select the .zip file downloaded from the CCBill website.

Once the file is selected, click Install Now to complete the installation process.

Upload CCBill plugin to WordPress.

Configuring your CCBill Account

Before using the plugin, it’s necessary to configure a few things in your CCBill account. The following CCBill settings must be correct for the payment module to work correctly.

Enable Dynamic Pricing

Please work with your CCBill Support representative to activate Dynamic Pricing for your account. You can verify that Dynamic Pricing is active at Account Info > Manage the Sub Accounts > Feature Summary in the Admin Portal. Your Dynamic Pricing status appears at the bottom of the Billing Tools section.

Check if Dynamic Pricing is enabled in the CCBill Admin.

Creating a Salt/Encryption Key

A "salt" is a string of random data used to make your encryption more secure. You must contact CCBill Merchant Support to generate your Salt/Encryption key. Once set, it will be visible under the Advanced section of the Sub Account Admin menu. It will appear in the Encryption Key field of the Upgrade Security Setup Information section.

Location of Salt Key in the CCBill Admin.

Disabling User Management

Since this account will be used for Dynamic Pricing transactions (not managing user subscriptions), User Management must be disabled.

1. Sign in to the Admin Portal.

2. On the Account Info mega menu, click Sub Account Admin.

3. Open the User Management menu.

4. Click Turn off User Management in the top section.

5. Select Do Not Collect Usernames and Passwords in the Username Settings section.

Turning off the User Management feature in the CCBill Admin.

Webhooks Setup

For the plugin to work, you will need to set up CCBill Webhooks. To do so:

1. Log in to the CCBill Admin.

2. Select the subaccount to be used with WooCommerce from the top Client Account dropdown.

3. Open the Account Info mega menu and navigate to Sub Account Admin.

4. Select Webhooks from the navigation pane.

5. Under Webhook URL, enter the base URL for your WooCommerce store, followed by:

/?wc-api=WC_Gateway_CCBill

For example, if your WooCommerce store is located at http://www.test.com, the Approval URL would be:

http://www.test.com/?wc-api=WC_Gateway_CCBill

NewSaleSuccess and NewSaleFailure are REQUIRED Webhook notifications for the CCBill WooCommerce plugin.

6. Select Satellite Locations and click Update to commit the changes you have made.

Creating a New Payment Form

The payment form is the CCBill form that will be displayed to customers after they choose to check out using CCBill. The payment form accepts customer payment information, processes the payment, and returns the customer to your website where a confirmation message is displayed.

CCBill provides two types of billing forms. FlexForms is our newest (and recommended) system, but standard forms are still supported. Please choose a form type and proceed according to the section for Option 1 or Option 2, according to your selection.

Option 1: Creating a New FlexForms Payment Form

To create a FlexForm form for use with WooCommerce:

1. Ensure All is selected in the top Client Account drop-down menu. FlexForms are not specific to sub accounts, and cannot be managed when a sub account is selected.

2. Navigate to the FlexForms Systems tab in the top menu bar and select FlexForms Payment Links. All existing forms will be displayed in a table.

Create an Approval URL

1. Click the URLs Library button in the upper-right to create a new URL. The Saved URLs Editor dialog displays.

2. Use the fields under Add New to create a new URL with the following properties.

  • URL Name. Enter a meaningful name for this URL (e.g. Payment Success).
  • URL. Under URL, enter the base URL for your WooCommerce store, followed by:
/?wc-api=WC_Gateway_CCBill&Action=CheckoutSuccess

For example, if your WooCommerce store is located at http://www.test.com, the Approval URL would be:

http://www.test.com/?wc-api=WC_Gateway_CCBill&Action=CheckoutSuccess

3. Click Save to commit your changes. Your new URL displays under Existing List.

A list of existing FlexForm URLs.

4. Click the plus (+) symbol under Name/Value Pairs in the SANDBOX column.

5. Under Your Parameter (key), enter: wc_orderid

6. Under Use this method, select: Merchant Pass-through Parameter

7. In the third column, enter: wc_orderid

8. Under Action, click the Add button to save this parameter. Your saved parameters display under Currently Defined Name/Value Pairs.

Add Name Value Pairs CCBill FlexForms.

9. Close the Name/Value Parameters editor to return to the Saved URLs Editor. Your new URL displays in the Existing List.

10. Click Promote under the Actions column. Your URL is now live.

11. Close the Saved URLs editor to return to the main FlexForms menu.

Create a New FlexForm

1. Click the Add New button in the upper left to create a new form.

2. The New Form dialog is displayed:

  • Payment Flow Name. At the top, enter a name for the new payment flow (this will be different than the form name, as a single form can be used in multiple flows).
  • Form Name. Under Form Name, enter a name for the form.
  • Dynamic Pricing. Under Pricing, check the box to enable dynamic pricing.
  • Layout. Select your desired layout, and save the form.
  • Edit the Flow. Click the arrow button to the left of your new flow to view the details. Under the green Approve arrow, click the square to modify the action.
  • Approval URL. In the left menu, select A URL > Select a Saved URL and select the URL your created earlier (e.g. Payment Success).
  • Redirect Time. Select a redirect time of 1 second using the slider at the bottom and save the form.

3. Promote to Live. Click the Promote to Live button to enable your new form to accept payments.

4. Note the Flex ID. Make note of the Flex ID; this value will be entered into the form name when completing the configuration in WooCommerce.

Continue to the Background Post for WooCommerce section of this document.

Option 2: Creating a New Standard Payment Form

To create a billing form for use with WooCommerce:

1. Sign into the Admin Portal, and navigate to the Form Admin. All existing forms will be displayed in a table.

2. Click Create New Form in the left menu to create your new form.

3. Select the appropriate option under Billing Type. (In most cases, this will be Credit Card.)

4. Select Standard under Form Type, unless you intend to customize your form.

Steps to create new standard form in the CCBill admin.

5. Choose a layout and click Submit at the bottom of the page.

Your new form has been created and is visible in the table under View All Forms. In this example, our new form is named 201cc.

A list of avilable from in the CCBill Admin.

Be sure to note the name of your new form, as it will be required in the WooCommerce configuration section.

Configuring the New Standard Billing Form

1. Click the title of the newly-created form to edit it.

2. Select Basic from the left menu.

3. Set the following options:

FIELD NAMEVALUE
Site NameEnter the URL of your WooCommerce store.
Approval URLhttp://www.yourwoocommercestore.com/?wc-api=WC_Gateway_CCBill&Action=CheckoutSuccess
Denial URLhttp://www.yourwoocommercestore.com/?wc-api=WC_Gateway_CCBill&Action=CheckoutFailure
Redirect TimeSelect an approval redirect time of 3 seconds, and a denial redirect time of None.

Background Post for WooCommerce

While still in the Sub Account Admin section, select Advanced from the left menu. Notice the top section titled Background Post Information. We will be modifying the Approval Post URL and Denial Post URL fields.

Approval Post URLhttp://www.yourwoocommercestore.com/?wc-api=WC_Gateway_CCBill&Action=Approval_Post
Denial Post URLhttp://www.yourwoocommercestore.com/?wc-api=WC_Gateway_CCBill&Action=Denial_Post

Your CCBill account is now configured. In your CCBill Admin interface, navigate to Sub Account Admin and ensure the information displayed is correct.

Configuration - WooCommerce

General Options

In your WordPress admin interface, navigate to WooCommerce and select General from the top menu.

CCBill Options

In your WordPress admin interface, navigate to WooCommerce and select Checkout from the top menu, then select CCBill from the top submenu.

OPTIONDESCRIPTION
Enable CCBillCheck the top box to enable payments with CCBill standard.
TitleUnder Title, enter CCBill.
DescriptionEnter a descriptive message to your customers. “Pay with your credit card via CCBill,” for example.
Client Account NumberEnter your CCBill client account number.
Client SubAccount NumberEnter your CCBill client sub-account number.
Form NameEnter the name of the form created during CCBill account configuration, or FlexForm ID if using FlexForms.
Is Flex FormSelect “Yes” if using FlexForms.
CurrencySelect the billing currency. Ensure this selection matches the selection made in the General section of the WooCommerce administration menu.
SaltEnter your salt/encryption key obtained during CCBill configuration.
Enter CCBill Account information in WooCommerce plugin.


Under Currency Options, select the default currency you want displayed to your buyers. CCBill currently supports the following currencies:

  • US Dollar (USD)
  • Euro (EUR)
  • Australian Dollar (AUD)
  • Canadian Dollar (CAD)
  • Great Britain Pounds Sterling (GBP)
  • Japanese Yen (JPY)

Click Save changes at the bottom of the CCBill configuration section.

You are now ready to process payments via CCBill! Please conduct a few test transactions (using test data provided by CCBill) to ensure proper operation before enabling live billing mode in your CCBill account.

iThemes Security Plugin

If you use these features on a WordPress installation and iThemes Security plugin, you may encounter issues receiving posts from CCBill. Follow these steps to resolve the issue:

1. Log into the WordPress website.

2. Click on Security Settings.

3. Click on Banned Users.

4. Uncheck the Enable HackRepair.com's blacklist feature.