How to set up CCBill Flex form with the system?

Owned by Margarita Zavialova
Last updated: Apr 17, 2024 by Scrile Manager
3 min read

Setup in WebVideo admin backend side

  1. Before starting with CCbill configuration you need to find out 4 values: Flex form ID,Salt value, account id, and sub-account id from your CCBill account. Those values will be required for the next steps

  2. Salt value may contain special characters and before using it in our configuration you need to URL Encode it to make sure it is passed correctly in URL as a value.
    Here is how you can do that.

To get the Salt value, you need to write to CCBill technical support. They will provide a ready-made value or offer to come up with a new one.

Visit any online URL encoding service, for example https://www.url-encode-decode.com

After encoding:

  1. Login into admin backend of your WebVideo website and open Payment Engines page

  2. Add new Payment Engine or replace existing with following values from screenshot

    • Name: CCBill Flex form

    • Short name: CCBill

    • Description: Pay by Credit Card

    • URL: https://api.ccbill.com/wap-frontflex/flexforms/YOUR-FLEX-FORM-ID-VALUE?clientAccnum=123456&!salt=YOUR-SALT-VALUE&clientSubacc=1234&initialPrice=%package_ext_id%&initialPeriod=3&currencyCode=840&formDigest=MD5(%{initialPrice}%{initialPeriod}%{currencyCode}%{!salt})&language=English&customer_fname=%customer_first_name%&customer_lname=%customer_last_name%&address1=%customer_address%&city=%customer_city%&state=%customer_state%&zipcode=%customer_zip%&country=%customer_country%&email=%customer_email%&x_customerid=%customer_id%&x_packageid=%package_id%
      asd

      Replace bold values with your actual values for YOUR-FLEX-FORM-ID-VALUE, YOUR-SALT-VALUE, client account number 123456 and sub-account number 1234.

      If you want to change payment currency replace three‐digit currency code 840 in the configurational URL with a value of your choice:

    • Cancel URL: https://www.google.com/
      (put any URL it is unused here)

    • Required Params: leave empty

    • Callback Handler: org.softservice.web.CcBillCallbackPage

    • Screenshot of how it should be looking

  3. Click Add/Update button to save values

  4. Open Admin → Payment Packages section of WebVideo

  5. Set up Payment packages - this is a pricing options available for your customers.

    1. Choose Payment System using short name selection from previous step

    2. Select amount to charge the customer’s credit card in selected currency (USD by default).
      The PackageID must contain a decimal part, for example, 10.00 and not just 10.

    3. Insert amount to credit user (in credits or tokens). For example you can add 100 credits in WebVideo for the payment of 10.00 which mean a user will receive 100 credit by paying $10.

    4. Click Add button
      See screenshot:

       

  6. Repeat the same for each payment options

Now lets setup on the CCBill end

  1. In Account Info → Subaccount Admin → Advanced put following ca https://www.YOUR-WEBSITE-NAME.com/exec/ccbillcallback as an URL for processing postback from CCBill

  2. Please, make sure that created FlexForm supports Dynamic Prices:

- Click Primary button

- Modify existing or create a new one:

- Click the Pricing button. Make sure that this point is checked:

- Click 'View & Select Pricing' green button

- Uncheck all checkboxes in 'View / Modify Existing Prices' and click 'Ok' button 

- Click 'Save Property' button in FlexForm Editor

- Click 'Save' button in 'Redirect to an Existing Form / Select An Existing Form' window

- Click button 'Promote to Live' for your modified flex form.