Loading...
 

Weebly Logo


The goal of this document is to provide installation and configuration instructions for the CCBill Weebly billing module.
This document assumes that the reader has a working knowledge of Weebly and has already created a Weebly-powered website.

Overview

The CCBill Weebly billing module enables easy integration of your CCBill account within the Weebly e-commerce platform. Installation involves the following steps:

  • Installing the CCBill payment module for Weebly.
  • Configuring your CCBill account for use with Weebly.
  • Configuring the module with your CCBill account information.

Installation

The CCBill Weebly module is installed by adding a small code snippet to your Weebly site.

In the Weebly website editor, select Settings from the top menu, then select SEO from the side menu. Add the following code to the Footer Code section:

<script>
(function(b,i,d,s){d=document;s=d.createElement('script');
s.async=1;s.src=b; window.CCBillScriptId=i;
d.getElementsByTagName('head')[0].appendChild(s);
})('https://integration.ccbill.com/js/ccbill_weebly.js','ccbill_V4adfj89h2nagba');
</script>

as shown on the image below:

Weebly Module Footer Code
Scroll down to the Navigation section and uncheck the box marked Group Excess Pages:

Weebly Group Excess Pages
Click the Publish button in the upper-right to add the script to your website. The module is now installed.

Creating a New FlexForms Payment Form

To set up FlexForms for use with Weebly:
  1. Ensure All is selected in the top Client Account dropdown 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 Weebly store, followed by:

    /AjaxMethods.php?Command=ConfirmPayment&Action=failure&OrderId=%%OrderId%%
    For example, if your Weebly store is located at http://test.weebly.com, the Approval URL would be:

    http://test.weebly.com/AjaxMethods.php?Command=ConfirmPayment&Action=failure&OrderId=%%OrderId%%

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

    (Click to Enlarge)
    (Click to Enlarge)

  4. Add Name/Value Pairs.
    • Click the plus (+) symbol under Name/Value Pairs in the SANDBOX column.
    • Under Your Parameter (key), enter: zc_orderid
    • Under Use this method, select: Merchant Pass-through Parameter
    • In the third column, enter: zc_orderid
    • Under Action, click the Add button to save this parameter. Your saved parameters display under Currently Defined Name/Value Pairs.

    (Click to Enlarge)
    (Click to Enlarge)

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

  5. Promote to Live.
    • Click Promote under the Actions column. Your URL is now live.
    • 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 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 Weebly.
Continue to the Background Post for Weebly section of this document.

Background Post for Weebly

In your CCBill admin interface select a sub account the purchases will be made on and navigate to Account Info -> Sub Account Admin and 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 URL http://integration.ccbill.com/AjaxMethods.php?Command=ConfirmPayment&Action=success&OrderId=%%OrderId%%
Denial Post URL http://integration.ccbill.com/AjaxMethods.php?Command=ConfirmPayment&Action=failure&OrderId=%%OrderId%%

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

Configuration - Weebly

General Options

 Important

In order to configure your CCBill account, you must have your browser configured to allow all cookies from *.weebly.com. Cookie blockers and certain private browsing modes will interfere with the authentication process
To configure the CCBill Weebly module, first sign into your Weebly admin panel at https://secure.weebly.com/login.

Select the site you wish to configure from the Sites menu in the upper-left.
Once selected, click on the URL under the site name. You will arrive at your site and are now authenticated.

Weebly Admin
To configure your CCBill settings, visit your Weebly site URL followed by #CCBillAdmin.

For example, if your Weebly site URL is http://test.weebly.com, your CCBill Admin URL will be: http://test.weebly.com#CCBillAdmin

The CCBill Configuration panel displays:

Weebly CCBill Panel
Enter your CCBill account information and click the Save button. A success message displays when your information has been saved.

CCBill Options

Client Account Number Enter your CCBill client account number.
Client SubAccount Number Enter your CCBill client sub-account number.
Form Name Enter the name of the form created during CCBill account configuration, or FlexForm ID if using FlexForms.
Is FlexForm Select “Yes”.
Currency Select the billing currency. Ensure this selection matches the selection made in the Localization -> Currencies section of the Weebly administration menu.
Salt Enter your salt / encryption key obtained during CCBill configuration.

Click Update at the bottom of the CCBill configuration section.

Confirmation

You are now ready to process payments via CCBill!

Products you create in the Weebly e-commerce section will now interact with the CCBill shopping cart and checkout process.

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.