CCBill WooCommerce Module

Confirm with CCBill Merchant Support that Dynamic Pricing is enabled for each sub-account used with WooCommerce.

To verify that Dynamic Pricing is active:

1. Log in to the CCBill Admin Portal.

2. Click Account Info and select Feature Summary.

3. Select the sub-account you want to review from the list.

4. Confirm that Dynamic Pricing is marked as Enabled in the Billing Tools section.

A Salt or Encryption Key is a random string used to strengthen encryption and protect sensitive data during payment processing. To generate a Salt, contact CCBill Merchant Support and request a Salt for each sub-account used for WooCommerce processing.

Once the Salt is created, you can view it in the Admin Portal:

1. Select the sub-account you want to review from the sub-account dropdown.

2. In the left-hand menu, click Advanced.

3. Locate the Encryption key field in the Upgrade Security Setup Information section.

You will need to copy this key and paste it into the WooCommerce dashboard during the WooCommerce configuration step.

Since this account will be used for Dynamic Pricing transactions rather than managing user accounts, User Management should be disabled for each sub-account used with WooCommerce.

In the Admin Portal:

1. Select the relevant sub-account from the sub-account dropdown.

2. Select User Management from the left-hand menu.

3. Click Turn Off User Management in the top section.

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

Webhooks allow your WooCommerce store to receive notifications from CCBill when key payment and subscription events occur. These include successful payments, renewals, and cancellations.

When using FlexForms, Webhooks must be configured for each sub-account used with WooCommerce.

To enable Webhooks in the CCBill Admin portal:

1. Select the appropriate sub-account from the sub-account dropdown.

2. Select Webhooks from the left-hand menu.

You can now start adding the required Webhooks: Approval, Cancellation, and Renewal.

Approval Webhook

The Approval webhook notifies WooCommerce when a payment is successfully processed. This webhook must be added to each sub-account used with WooCommerce.

1. Under Webhook URL, enter your WooCommerce store's base URL followed by:

/?wc-api=WC_Gateway_CCBill&Action=Approval_Post

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

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

2. Set Webhook Format to URL ENCODED.

3. Select the NewSaleSuccess and NewSaleFailure event triggers.

4. Click Update at the bottom of the page to save your changes.

Cancellation Webhook

The Cancellation webhook notifies WooCommerce when a subscription is cancelled. To add a Cancellation webhook:

1. Click Add in the Add Webhook field.

2. Under Webhook URL, enter your WooCommerce store's base URL followed by:

/?wc-api=WC_Gateway_CCBill&Action=Cancel_Post

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

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

3. Set Webhook Format to URL ENCODED.

4. Check the Cancellation and Expiration event triggers.

5. Click Update to save your changes.

Renewal (Rebill) Webhook

The Renewal webhook updates WooCommerce when a subscription renews successfully or fails to renew.

1. Click Add in the Add Webhook field.

2. Under Webhook URL, enter your WooCommerce store's base URL followed by:

/?wc-api=WC_Gateway_CCBill&Action=Rebill_Post

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=Rebill_Post

3. Set Webhook Format to URL ENCODED.

4. Check the RenewalSuccess and RenewalFailure event triggers.

5. Click Update to commit the changes you have made.

Datalink services are required for subscription verification and cancellation when using FlexForms.

To configure Datalink access in the Admin Portal:

1. Open the Account Info menu and select Data Link Services Suite.

2. Click View Users.

3. Click the number in the Number of Users column.

4. From the list, select the user account you plan to use with WooCommerce.

5. In the Subsystem section, select all available services.

6. Add the IP address or IP range from which Datalink requests will be sent:

• If your server runs on a single server, add its public IP address.
• If your site is load-balanced or uses multiple servers, use Enter IP Range to add the full range.

7. Select Add To Valid IPs.

8. Click Store User to save your changes.

Before creating a FlexForm, you must define the URL CCBill will redirect customers to after a successful checkout.

In the Admin Portal:

1. Select All in the Client Account dropdown menu.

2. Select FlexForms Systems and then FlexForms Payment Links.

3. Click URLs Library in the upper-right corner. The Saved URLs Editor prompt opens.

4. Under URL Name, enter a meaningful name for this URL (e.g., Payment Success).

5. In the URL field, 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

6. Click Save in the Actions column to commit your changes.

7. Your new URL displays in the Existing List. Click +Add under Name/Value Pairs in the SANDBOX column.

8. Under Your Parameter (key), enter wc_orderid.

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

10. In the third column, enter wc_orderid.

11. Under Action, click the Add button to save this parameter.

Close the Name/Value Parameters editor to return to the Saved URLs Editor.

12. Click Promote under the Actions column. When prompted, confirm you want to set the URL to Live.

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

To create a FlexForm for your WooCommerce store:

1. Click the Add New button in the main FlexForms menu.

2. Enter a name for the new payment flow.

3. Under Form Name, enter a name for the form.

4. Check the box to enable Dynamic Pricing.

5. Select your desired Layout, Color Theme, and Save the form.

6. Under the green Approve arrow, click the square to modify the action.

7. Select A URL in the left-hand menu.

8. Click Select a Saved URL and select the URL you created earlier from the dropdown (e.g., Payment Success).

9. Set a 1-second redirect time using the slider at the bottom, then Save the form.

10. Make note of the Flex ID; this value will be entered into the form name when configuring WooCommerce.

11. Click the Promote to Live button.

Your new form is now live and ready to accept payments. The only thing left is to configure the settings in your WooCommerce plugin to accept payments from the form.

Configure the following options for the Advanced (token-based) integration:

Configure the following options for the FlexForms integration: