{"id":159,"date":"2020-08-10T18:43:43","date_gmt":"2020-08-10T18:43:43","guid":{"rendered":""},"modified":"2023-04-20T08:09:43","modified_gmt":"2023-04-20T08:09:43","slug":"ccbill-ubersmith-integration","status":"publish","type":"post","link":"https:\/\/ccbill.com\/doc\/ccbill-ubersmith-integration","title":{"rendered":"Configuring CCBill for\u00a0Ubersmith"},"content":{"rendered":"\n<div id=\"articleHeader\">&nbsp;<\/div>\n\n\n\n<p>The goal of this document is to provide configuration instructions on how to setup CCBill payment processing for use with Ubersmith. This document assumes that the reader has a working knowledge of Ubersmith and has admin access to the CCBill Admin and Ubersmith portal.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Requirements<\/strong><\/h3>\n\n\n\n<p>Please note that you will need the following to set up CCBill for Ubersmith:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>A CCBill Data Link (API) User<\/strong><\/li>\n\n\n\n<li><strong>Your Ubersmith's IP range\/address<\/strong><\/li>\n\n\n\n<li><strong>A CCBill subaccount for use with Ubersmith<\/strong><\/li>\n\n\n\n<li><strong>Your Webhook URL which you will find in the&nbsp;<em>Payment Processing<\/em>&nbsp;section of the Ubersmith portal<\/strong><\/li>\n<\/ul>\n\n\n\n<p>If you lack any of these, this document will instruct you on how to proceed.<\/p>\n\n\n\n<p>First, log in to both your CCBill Admin and Ubersmith portal accounts. You will need information from both portals, so just stay login during the configuration process.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"Configuring_your_CCBill_Account\"><strong>Configuring your CCBill&nbsp;Account<\/strong><\/h2>\n\n\n\n<p>Before billing clients with CCBill, it\u2019s necessary to configure a few things in your CCBill account. Please ensure that CCBill settings are correct or the payment gateway will&nbsp;<strong>NOT<\/strong>&nbsp;work.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"Create_a_Subaccount_for_Billing_Ubersmith_Clients\"><strong>Create a Subaccount for Billing Ubersmith&nbsp;Clients<\/strong><\/h3>\n\n\n\n<p>In order to set up CCBill you need to:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Log in to the&nbsp;<a href=\"https:\/\/admin.ccbill.com\/loginMM.cgi\" target=\"_blank\" rel=\"noreferrer noopener\">CCBill Admin Portal<\/a>.<\/li>\n\n\n\n<li>Click&nbsp;<strong>Account Info<\/strong>&nbsp;&gt;&nbsp;<strong>Account Setup<\/strong>.<\/li>\n\n\n\n<li>Follow the on-screen instructions to set up the website. (Find detailed instructions&nbsp;<a href=\"https:\/\/ccbill.com\/doc\/ccbill-account-setup\" target=\"_blank\" rel=\"noreferrer noopener\">here<\/a>.)<\/li>\n\n\n\n<li>Each page of the wizard permits the establishment of specific options when creating a new subaccount. Click&nbsp;<strong>Next&nbsp;<\/strong>to proceed to the next step and choose a new subaccount number.<\/li>\n\n\n\n<li>The&nbsp;<strong>New Subaccount #field<\/strong>&nbsp;displays the next available subaccount number. Several successive pages of the #Create Subaccount wizard will follow.<\/li>\n\n\n\n<li>Click&nbsp;<strong>Prev&nbsp;<\/strong>to return to the previous wizard page.<\/li>\n\n\n\n<li>You don't need to download the index page.<\/li>\n<\/ol>\n\n\n\n<p>Once you have created a subaccount, you can proceed with the configuration.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"Disable_User_Management\"><strong>Disable User&nbsp;Management<\/strong><\/h3>\n\n\n\n<p>Since this account will be used for Dynamic Pricing transactions (not managing user subscriptions),&nbsp;<strong>User Management must be disabled<\/strong>.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-large\"><img decoding=\"async\" width=\"750\" height=\"319\" src=\"https:\/\/ccbill.com\/doc\/wp-content\/uploads\/2021\/05\/disable-user-management.png\" alt=\"Disabling CCBill user management.\" class=\"wp-image-3253\" srcset=\"https:\/\/ccbill.com\/doc\/wp-content\/uploads\/2021\/05\/disable-user-management.png 750w, https:\/\/ccbill.com\/doc\/wp-content\/uploads\/2021\/05\/disable-user-management-300x128.png 300w\" sizes=\"(max-width: 750px) 100vw, 750px\" \/><\/figure><\/div>\n\n\n<ul class=\"wp-block-list\">\n<li>On the&nbsp;<strong>Account Info<\/strong>&nbsp;mega menu, click&nbsp;<strong>Sub Account Admin<\/strong>&nbsp;&gt;&nbsp;<strong>User Management<\/strong>.<\/li>\n\n\n\n<li>Select&nbsp;<strong>Turn off User Management<\/strong>&nbsp;in the top section.<\/li>\n\n\n\n<li>Select&nbsp;<strong>Do Not Collect Usernames and Passwords<\/strong>&nbsp;in the&nbsp;<strong>Username Settings<\/strong>&nbsp;section.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"Set_up_Webhooks\"><strong>Set Up&nbsp;Webhooks<\/strong><\/h3>\n\n\n\n<p>To set up webhooks, please navigate to your Ubersmith portal account.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Click&nbsp;<strong>Setings<\/strong>.<\/li>\n\n\n\n<li>Then select the&nbsp;<strong>Payment Processing Options<\/strong>&nbsp;link in the&nbsp;<em>Billing &amp; Payment<\/em>&nbsp;section.<\/li>\n\n\n\n<li>Select CCBill from the&nbsp;<strong>Credit Card Gateway<\/strong>&nbsp;drop-down. This will display all information and options associated to setting up CCBill as your payment gateway.<\/li>\n\n\n\n<li>The second line in the CCBill options section will read your organization's Webhook URL.&nbsp;<strong>Copy the Webhook URL<\/strong>. For further details, see image below.<\/li>\n<\/ol>\n\n\n\n<p><strong>Disclaimer<\/strong>: The image below is an example. Your Webhook URL will be different.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-large\"><img decoding=\"async\" width=\"750\" height=\"568\" src=\"https:\/\/ccbill.com\/doc\/wp-content\/uploads\/2021\/05\/set-up-webhooks.jpg\" alt=\"Setting up CCBill webhooks.\" class=\"wp-image-3256\" srcset=\"https:\/\/ccbill.com\/doc\/wp-content\/uploads\/2021\/05\/set-up-webhooks.jpg 750w, https:\/\/ccbill.com\/doc\/wp-content\/uploads\/2021\/05\/set-up-webhooks-300x227.jpg 300w\" sizes=\"(max-width: 750px) 100vw, 750px\" \/><\/figure><\/div>\n\n\n<p>After you have copied your Webhook URL, navigate back to the CCBill Admin.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Click&nbsp;<strong>Account Info<\/strong>&nbsp;&gt;&nbsp;<strong>Sub Account Admin<\/strong>.<\/li>\n\n\n\n<li>Select the subaccount intended for use with Ubersmith.<\/li>\n\n\n\n<li>Click&nbsp;<strong>Webhooks<\/strong>&nbsp;from the left navigation pane.<\/li>\n\n\n\n<li>Paste the URL from Ubersmith in the Webhooks URL field.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"Set_up_Data_Link\"><strong>Set Up Data&nbsp;Link<\/strong><\/h3>\n\n\n\n<p>For this integration to work, you will need to set up a <a href=\"https:\/\/ccbill.com\/doc\/datalink-user\" target=\"_blank\" rel=\"noreferrer noopener\">Data Link user<\/a>. Clients who do not have access to Data Link need to contact&nbsp;<a href=\"https:\/\/ccbill.com\/contact\" target=\"_blank\" rel=\"noreferrer noopener\">CCBill Merchant Support<\/a>&nbsp;and file a request. Before you start setting up a Data Link user, you also need your Ubersmith server's IP address.<\/p>\n\n\n\n<p>In order to set up Data Link:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Hover over&nbsp;<strong>Account Info<\/strong>.<\/li>\n\n\n\n<li>Click&nbsp;<strong>Datalink Services Suite<\/strong>.<\/li>\n\n\n\n<li>Select&nbsp;<strong>Add User<\/strong>&nbsp;from the navigation pane on the left.<\/li>\n\n\n\n<li><strong>Account<\/strong>. Make sure you select the Ubersmith subaccount.<\/li>\n\n\n\n<li>Enter a&nbsp;<strong>Username<\/strong>&nbsp;and&nbsp;<strong>Password<\/strong>. (Password must be 6 to 8 alphanumeric characters, with at least one number and one letter.)&nbsp;<strong>Make sure to note these, as you will need to enter it in Ubersmith.<\/strong><\/li>\n\n\n\n<li>Subsystem. You will need to activate the&nbsp;<strong>Data Link Extract<\/strong>&nbsp;and&nbsp;<strong>SMS chargeByPreviousTransactionId<\/strong>&nbsp;subsystems.<\/li>\n\n\n\n<li><strong>Valid IPs<\/strong>. Enter your Ubersmith's IP range or a fixed IP address.<\/li>\n\n\n\n<li>Click&nbsp;<strong>Store User<\/strong>.<\/li>\n<\/ol>\n\n\n\n<p>To learn more about Datalink, follow these links:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/ccbill.com\/doc\/data-link-system\" target=\"_blank\" rel=\"noreferrer noopener\">Datalink<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/ccbill.com\/doc\/member-management-solutions\" target=\"_blank\" rel=\"noreferrer noopener\">Member Management Solutions<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/ccbill.com\/doc\/data-link-extract-system-user-guide\" target=\"_blank\" rel=\"noreferrer noopener\">Datalink Extract System User's Guide<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/ccbill.com\/doc\/data-link-extract-system-user-guide\" target=\"_blank\" rel=\"noreferrer noopener\">Common Datalink Errors<\/a><\/li>\n<\/ul>\n\n\n\n<p>If you need help in setting up Datalink, please contact Merchant Support.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"Enable_Dynamic_Pricing\"><strong>Enable Dynamic&nbsp;Pricing<\/strong><\/h3>\n\n\n\n<p>Please work with your CCBill Support representative to activate Dynamic Pricing for your account. You can verify that Dynamic Pricing is active at&nbsp;<strong>Account Info<\/strong>&nbsp;&gt;&nbsp;<strong>Manage the Sub Accounts<\/strong>&nbsp;&gt;&nbsp;<strong>Feature Summary<\/strong>&nbsp;in the Admin Portal. <\/p>\n\n\n\n<p>Your Dynamic Pricing status appears at the bottom of the&nbsp;<strong>Billing Tools<\/strong>&nbsp;section.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-large\"><img decoding=\"async\" width=\"750\" height=\"635\" src=\"https:\/\/ccbill.com\/doc\/wp-content\/uploads\/2021\/05\/enable-dynamic-pricing.png\" alt=\"Enabling Dynamic pricing.\" class=\"wp-image-3262\" srcset=\"https:\/\/ccbill.com\/doc\/wp-content\/uploads\/2021\/05\/enable-dynamic-pricing.png 750w, https:\/\/ccbill.com\/doc\/wp-content\/uploads\/2021\/05\/enable-dynamic-pricing-300x254.png 300w\" sizes=\"(max-width: 750px) 100vw, 750px\" \/><\/figure><\/div>\n\n\n<h3 class=\"wp-block-heading\" id=\"Create_a_Salt_Encryption_Key\"><strong>Create a Salt \/ Encryption&nbsp;Key<\/strong><\/h3>\n\n\n\n<p>A \"salt\" is a string of random data used to make your encryption more secure. You must contact CCBill Merchant Support to generate your <a href=\"https:\/\/ccbill.com\/doc\/encryption-key-salt\" target=\"_blank\" rel=\"noreferrer noopener\">Salt\/Encryption key<\/a>. Once set, it will be visible under the\u00a0<strong>Advanced<\/strong>\u00a0section of the\u00a0<strong>Sub Account Admin<\/strong>\u00a0menu. It will appear in the\u00a0<strong>Encryption Key<\/strong>\u00a0field of the\u00a0<strong>Upgrade Security Setup Information\u00a0<\/strong>section.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full\"><img decoding=\"async\" width=\"750\" height=\"343\" src=\"https:\/\/ccbill.com\/doc\/wp-content\/uploads\/2021\/05\/create-encyption-key.png\" alt=\"Create an encryption key.\" class=\"wp-image-3263\" srcset=\"https:\/\/ccbill.com\/doc\/wp-content\/uploads\/2021\/05\/create-encyption-key.png 750w, https:\/\/ccbill.com\/doc\/wp-content\/uploads\/2021\/05\/create-encyption-key-300x137.png 300w\" sizes=\"(max-width: 750px) 100vw, 750px\" \/><\/figure><\/div>\n\n\n<h2 class=\"wp-block-heading\" id=\"Creating_a_New_Payment_Form\"><strong>Creating a New Payment&nbsp;Form<\/strong><\/h2>\n\n\n\n<p>The payment form is the CCBill form that will be displayed to your clients if they opt to pay with a credit card. The payment form accepts customer payment information, processes the payment, and sends the client to a designated URL after the payment has been processed.<\/p>\n\n\n\n<p>Below you will find additional instructions on how to create a FlexForm. If you need a more in-depth user guide, please refer to our&nbsp;<a href=\"https:\/\/ccbill.com\/doc\/flexforms-overview\" target=\"_blank\" rel=\"noreferrer noopener\">FlexForms User Guide<\/a>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"Creating_a_Payment_Flow_and_FlexForm\"><strong>Creating a Payment Flow and&nbsp;FlexForm<\/strong><\/h3>\n\n\n\n<p>To create a FlexForm for use with Ubersmith:<\/p>\n\n\n\n<p>1. Ensure&nbsp;<strong>All<\/strong>&nbsp;is selected in the top&nbsp;<strong>Client Account<\/strong>&nbsp;drop-down menu. FlexForms are not specific to sub-accounts, and cannot be managed when a sub-account is selected.<\/p>\n\n\n\n<p>2. Navigate to the&nbsp;<strong>FlexForms Systems<\/strong>&nbsp;tab in the top menu bar and select&nbsp;<strong>FlexForms Payment Links<\/strong>.<\/p>\n\n\n\n<p>3. Click the&nbsp;<strong>Add New<\/strong>&nbsp;button in the upper-left to create a new payment flow. You are now essentially editing the first tile of the Payment Flow. In this case, you will be creating a FlexForm payment form for your Ubersmith clients.<\/p>\n\n\n\n<p>4. Enter a <strong>Name<\/strong> for your Payment Flow in the top field.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-large\"><img decoding=\"async\" width=\"750\" height=\"363\" src=\"https:\/\/ccbill.com\/doc\/wp-content\/uploads\/2021\/05\/flex-forms-payment-form.jpg\" alt=\"FlexForms payment form.\" class=\"wp-image-3267\" srcset=\"https:\/\/ccbill.com\/doc\/wp-content\/uploads\/2021\/05\/flex-forms-payment-form.jpg 750w, https:\/\/ccbill.com\/doc\/wp-content\/uploads\/2021\/05\/flex-forms-payment-form-300x145.jpg 300w\" sizes=\"(max-width: 750px) 100vw, 750px\" \/><\/figure><\/div>\n\n\n<p>5. There are three (3)&nbsp;<em>Redirect To<\/em>&nbsp;options:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>New Form<\/strong>. Create a new FlexForm.&nbsp;<strong><em>If you do not have a payment form, choose this option.<\/em><\/strong><\/li>\n\n\n\n<li><strong>Existing Form<\/strong>. Use a previously made Form.<\/li>\n\n\n\n<li><strong>URL<\/strong><\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"Creating_a_FlexForm\"><strong>Creating a&nbsp;FlexForm<\/strong><\/h3>\n\n\n\n<p>1. Select&nbsp;<strong>New Form<\/strong>, as we will assume that you have not set up a FlexForm yet.<\/p>\n\n\n\n<p>2. Set basic Form settings:<\/p>\n\n\n\n<figure class=\"wp-block-table aligncenter is-style-stripes\"><table class=\"has-fixed-layout\"><thead><tr><th class=\"has-text-align-center\" data-align=\"center\">Setting<\/th><th class=\"has-text-align-center\" data-align=\"center\">Description<\/th><\/tr><\/thead><tbody><tr><td class=\"has-text-align-center\" data-align=\"center\">Enter a <strong>Form Name<\/strong><\/td><td class=\"has-text-align-center\" data-align=\"center\">This will be the name of your Form.<\/td><\/tr><tr><td class=\"has-text-align-center\" data-align=\"center\"><strong>Pricing<\/strong><\/td><td class=\"has-text-align-center\" data-align=\"center\">You needn't assign any Price Points to this form. Prices will be dynamically inserted.<\/td><\/tr><tr><td class=\"has-text-align-center\" data-align=\"center\">Check the <strong>Dynamic Prices <\/strong>checkbox<\/td><td class=\"has-text-align-center\" data-align=\"center\">Prices <strong>MUST<\/strong> be dynamically inserted for this integration to work.<\/td><\/tr><tr><td class=\"has-text-align-center\" data-align=\"center\">Select a <strong>Layout<\/strong><\/td><td class=\"has-text-align-center\" data-align=\"center\">Centered, Right Justified, or Left Justified.<\/td><\/tr><tr><td class=\"has-text-align-center\" data-align=\"center\">Select a <strong>Color Theme<\/strong><\/td><td class=\"has-text-align-center\" data-align=\"center\">Select a predetermined Color Theme.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>All of these settings and many other can be modified in the&nbsp;<strong>FlexForms Editor<\/strong>&nbsp;at every moment. Pop up the <em>Editor <\/em>by clicking the&nbsp;<strong>Forms Library<\/strong>&nbsp;button in the upper-right corner of the screen. <\/p>\n\n\n\n<p>There you can create new forms as well, by clicking the&nbsp;<strong>Create New Form<\/strong>&nbsp;button.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"Payment_Flow_Map\"><strong>Payment Flow&nbsp;Map<\/strong><\/h2>\n\n\n\n<p>After you have created your Primary Tile FlexForm, you will see a graphic representation of the Flow.<\/p>\n\n\n\n<p>Edit your Primary Tile by clicking on it. Beside your Primary Tile are&nbsp;<strong>Redirect Tiles<\/strong>, which are automatically made, and their default state is&nbsp;<strong>No Redirect<\/strong>. So, if a customer is declined or approved when making a transaction, they will see the default approval or decline message.<\/p>\n\n\n\n<p>Click on a&nbsp;<strong>Redirect Tile<\/strong>&nbsp;if you want to modify it.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"Approval_and_Deny_Path\"><strong>Approval and Deny&nbsp;Path<\/strong><\/h3>\n\n\n\n<p>The Approval path is the route customers take when their transaction is approved. The&nbsp;<strong>Approval Tile<\/strong>&nbsp;is always below the Primary and Deny Tile.<\/p>\n\n\n\n<p>The Deny Path is the route customers take when they are declined on a transaction. They will be redirected to the deny path to try again. The&nbsp;<strong>Deny Tile<\/strong>&nbsp;is always to the right of the&nbsp;<strong>Primary Tile<\/strong>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"Promote_a_FlexForm_to_Live\"><strong>Promote a FlexForm to&nbsp;Live<\/strong><\/h3>\n\n\n\n<p>Promoting a FlexForm to Live will enable your form and payment flow for Live transactions. When making changes to a Live FlexForm, you needn't update the code on your website when you're done. To promote a FlexForm to Live:<\/p>\n\n\n\n<p>1. Open the&nbsp;<strong>Forms Library<\/strong>.<\/p>\n\n\n\n<p>2. Select a FlexForm from the scrollable area on the left.<\/p>\n\n\n\n<p>3. Click&nbsp;<strong>Promote to Live?<\/strong><\/p>\n\n\n\n<p>4. Click&nbsp;<strong>Yes (Promote to Live)<\/strong>&nbsp;to confirm your choice.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"Collect_your_FlexForm_URL_and_Widget_Code\"><strong>Collect your FlexForm URL and Widget&nbsp;Code<\/strong><\/h3>\n\n\n\n<p>Once you have created your FlexForm and promoted it to the Live environment, you can collect the URL and widget code. To do so, select the&nbsp;<strong>Widget Code<\/strong>&nbsp;link in the payment flow of your newly created FlexForm. This will display the necessary information.<\/p>\n\n\n\n<p><strong>Make sure to copy the URL and Widget Code for Live payment processing.<\/strong>&nbsp;See image below for additional information.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-large\"><img decoding=\"async\" width=\"750\" height=\"493\" src=\"https:\/\/ccbill.com\/doc\/wp-content\/uploads\/2021\/05\/flexforms-url-widget.jpg\" alt=\"\" class=\"wp-image-3266\" srcset=\"https:\/\/ccbill.com\/doc\/wp-content\/uploads\/2021\/05\/flexforms-url-widget.jpg 750w, https:\/\/ccbill.com\/doc\/wp-content\/uploads\/2021\/05\/flexforms-url-widget-300x197.jpg 300w\" sizes=\"(max-width: 750px) 100vw, 750px\" \/><\/figure><\/div>\n\n\n<p>You will need to paste these into corresponding fields in Ubersmith.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"Setting_Up_CCBill_as_a_Payment_Gateway_for_Ubersmith\"><strong>Setting Up CCBill as a Payment Gateway for&nbsp;Ubersmith<\/strong><\/h2>\n\n\n\n<p>Your merchant account is a critical aspect of your Ubersmith setup. Without a merchant account configured, you cannot accept credit card payments directly, and you cannot easily set up recurring billing for your clients with CCBill.<\/p>\n\n\n\n<p>To setup Ubersmith to communicate with CCBill payment processing servers:<\/p>\n\n\n\n<p>1. Log in to your Ubersmith portal.<\/p>\n\n\n\n<p>2. Find and select the&nbsp;<strong>Settings<\/strong>&nbsp;link. (<em><strong>Setup &amp; Admin<\/strong>&nbsp;in older versions of Ubersmith.<\/em>)<\/p>\n\n\n\n<p>3. Navigate to the&nbsp;<strong>Payment Processing Options<\/strong>&nbsp;link under the&nbsp;<strong>Billing &amp; Payment<\/strong>&nbsp;section. (<em><strong>Client Manager<\/strong>&nbsp;in older versions of UBS<\/em>.)<\/p>\n\n\n\n<p>4. Open the&nbsp;<strong>Credit Card Gateway<\/strong>&nbsp;drop-down menu and select&nbsp;<strong>CCBill<\/strong>.<\/p>\n\n\n\n<p>5. This will prompt open the fields you need to fill in to be able to process payments with CCBill.<\/p>\n\n\n\n<h2 class=\"has-text-align-center wp-block-heading\" id=\"CCBill_Options\"><strong>CCBill&nbsp;Options<\/strong><\/h2>\n\n\n\n<figure id=\"wpfancytable2\" class=\"wp-block-table is-style-stripes\"><table class=\"has-fixed-layout\"><thead><tr><th class=\"has-text-align-left\" data-align=\"left\"><em>Option<\/em><\/th><th class=\"has-text-align-left\" data-align=\"left\"><em>Description<\/em><\/th><\/tr><\/thead><tbody><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>Client Account Number<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">Enter your CCBill client account number.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>Client Subaccount Number<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">Enter your CCBill client sub-account number.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>API Username<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">Enter your CCBill Data Link username.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>API Password<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">Enter your CCBill Data Link password.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>CCBill Salt Key<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">Enter your salt \/ encryption key obtained during CCBill configuration.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>Currency<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">Select billing currency. CCBill currently supports the following currencies: US Dollar, Euro, Australian Dollar, Canadian Dollar, Great Britain Pounds Sterling and Japanese Yen.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>Mode<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">This option allows you to place your communications with CCBill in&nbsp;<em><strong>Sandbox<\/strong><\/em>&nbsp;or&nbsp;<strong><em>Live<\/em><\/strong>&nbsp;mode. Before you go live with your Ubersmith setup, it's a good idea to try a few transactions in Sandbox mode. When you are satisfied with the results, you can change this option to Live.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>Payment System<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">Select whether your clients will initiate the payment form through an URL or Widget.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>Invoice Payment URL<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">FlexForms URL that opens the payment form.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>Invoice Widget Code<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">FlexForms widget code that opens the payment form. When setting up the Invoice Widget Code, it is required to put in '##parameters##' within the code. (See example below.)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Please see example below:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;div class=&quot;ccbillWidgetContainer&quot;&gt;&lt;script type=&quot;text\/javascript&quot; class=&quot;CCBillWidget36efa1df-TEST-cffe6cfc4fe1_4640&quot; src=&quot;https:\/\/images.ccbill.com\/flexforms\/ccbill-widget-live.js&quot;&gt;##parameters##&lt;\/script&gt;&lt;\/div&gt;Some users do not store and accept CVV2 data due to PCI and MasterCard or Visa regulations. If that is true for your use case, then select No.<\/code><\/pre>\n\n\n<div class=\"notice-note\">\n<div class=\"notice-text\"><p><strong>CVV2<\/strong><\/p>\n<p>Some users do not store and accept CVV2 data due to PCI and MasterCard or Visa regulations. If that is true for your use case, then select <strong>No<\/strong>. <\/p>\n<\/div>\n<\/div>\n\n\n\n<p>When you are finished, click&nbsp;<strong>Update<\/strong>&nbsp;at the bottom of the page to save your CCBill configuration.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"Confirmation\"><strong>Confirmation<\/strong><\/h2>\n\n\n\n<p>You are now ready to process payments via CCBill!<\/p>\n\n\n\n<p>Please conduct a few test transactions using the Sandbox mode to ensure proper operation before enabling live billing mode.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Support Options and Additional&nbsp;Resources<\/strong><\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Ubersmith<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Information Link: <a target=\"_blank\" href=\"https:\/\/www.ubersmith.com\/\" rel=\"noreferrer noopener\">https:\/\/www.ubersmith.com\/<\/a><\/li>\n\n\n\n<li>Ubersmith Documentation: <a target=\"_blank\" href=\"https:\/\/docs.ubersmith.com\/\" rel=\"noreferrer noopener\">https:\/\/docs.ubersmith.com\/<\/a><\/li>\n\n\n\n<li>General Inquires: <a target=\"_blank\" href=\"https:\/\/www.ubersmith.com\/#Contact\" rel=\"noreferrer noopener\">https:\/\/www.ubersmith.com\/#Contact<\/a><\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">CCBill Payment Processing<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Call Support: 800.510.2859<\/li>\n\n\n\n<li>Hours: 24\/7<\/li>\n\n\n\n<li>email: <a href=\"mailto:merchantsupport@ccbill.com\" target=\"_blank\" rel=\"noreferrer noopener\">merchantsupport@ccbill.com<\/a><\/li>\n\n\n\n<li>Live Chat: <a target=\"_blank\" href=\"https:\/\/lc.chat\/now\/1041032\/47\" rel=\"noreferrer noopener\">Click Here!<\/a><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>&nbsp; The goal of this document is to provide configuration instructions on how to setup...<\/p>\n","protected":false},"author":4,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"kk_blocks_editor_width":"","_kiokenblocks_attr":"","_kiokenblocks_dimensions":"","footnotes":""},"categories":[30],"tags":[],"class_list":["post-159","post","type-post","status-publish","format-standard","hentry","category-integration-modules"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v25.0 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>CCBill Merchant Knowledge Base | Configuring CCBill for Ubersmith<\/title>\n<meta name=\"description\" content=\"How to setup CCBill for use with Ubersmith\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/ccbill.com\/doc\/ccbill-ubersmith-integration\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"CCBill Merchant Knowledge Base | Configuring CCBill for Ubersmith\" \/>\n<meta property=\"og:description\" content=\"How to setup CCBill for use with Ubersmith\" \/>\n<meta property=\"og:url\" content=\"https:\/\/ccbill.com\/doc\/ccbill-ubersmith-integration\" \/>\n<meta property=\"og:site_name\" content=\"CCBill Doc\" \/>\n<meta property=\"article:published_time\" content=\"2020-08-10T18:43:43+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2023-04-20T08:09:43+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/ccbill.com\/doc\/wp-content\/uploads\/2021\/05\/disable-user-management.png\" \/>\n<meta name=\"author\" content=\"Vladimir Kaplarevic\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Vladimir Kaplarevic\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"10 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/ccbill.com\/doc\/ccbill-ubersmith-integration\",\"url\":\"https:\/\/ccbill.com\/doc\/ccbill-ubersmith-integration\",\"name\":\"CCBill Merchant Knowledge Base | Configuring CCBill for Ubersmith\",\"isPartOf\":{\"@id\":\"https:\/\/ccbill.com\/doc\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/ccbill.com\/doc\/ccbill-ubersmith-integration#primaryimage\"},\"image\":{\"@id\":\"https:\/\/ccbill.com\/doc\/ccbill-ubersmith-integration#primaryimage\"},\"thumbnailUrl\":\"https:\/\/ccbill.com\/doc\/wp-content\/uploads\/2021\/05\/disable-user-management.png\",\"datePublished\":\"2020-08-10T18:43:43+00:00\",\"dateModified\":\"2023-04-20T08:09:43+00:00\",\"author\":{\"@id\":\"https:\/\/ccbill.com\/doc\/#\/schema\/person\/2cc5b50e34ee63ed498ac333a25840ad\"},\"description\":\"How to setup CCBill for use with Ubersmith\",\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/ccbill.com\/doc\/ccbill-ubersmith-integration\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/ccbill.com\/doc\/ccbill-ubersmith-integration#primaryimage\",\"url\":\"https:\/\/ccbill.com\/doc\/wp-content\/uploads\/2021\/05\/disable-user-management.png\",\"contentUrl\":\"https:\/\/ccbill.com\/doc\/wp-content\/uploads\/2021\/05\/disable-user-management.png\",\"width\":750,\"height\":319,\"caption\":\"Disabling CCBill user management.\"},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/ccbill.com\/doc\/#website\",\"url\":\"https:\/\/ccbill.com\/doc\/\",\"name\":\"CCBill Doc\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/ccbill.com\/doc\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/ccbill.com\/doc\/#\/schema\/person\/2cc5b50e34ee63ed498ac333a25840ad\",\"name\":\"Vladimir Kaplarevic\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/ccbill.com\/doc\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/8d4609e99e6aecc69ce049e18d45f033?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/8d4609e99e6aecc69ce049e18d45f033?s=96&d=mm&r=g\",\"caption\":\"Vladimir Kaplarevic\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"CCBill Merchant Knowledge Base | Configuring CCBill for Ubersmith","description":"How to setup CCBill for use with Ubersmith","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/ccbill.com\/doc\/ccbill-ubersmith-integration","og_locale":"en_US","og_type":"article","og_title":"CCBill Merchant Knowledge Base | Configuring CCBill for Ubersmith","og_description":"How to setup CCBill for use with Ubersmith","og_url":"https:\/\/ccbill.com\/doc\/ccbill-ubersmith-integration","og_site_name":"CCBill Doc","article_published_time":"2020-08-10T18:43:43+00:00","article_modified_time":"2023-04-20T08:09:43+00:00","og_image":[{"url":"https:\/\/ccbill.com\/doc\/wp-content\/uploads\/2021\/05\/disable-user-management.png","type":"","width":"","height":""}],"author":"Vladimir Kaplarevic","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Vladimir Kaplarevic","Est. reading time":"10 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/ccbill.com\/doc\/ccbill-ubersmith-integration","url":"https:\/\/ccbill.com\/doc\/ccbill-ubersmith-integration","name":"CCBill Merchant Knowledge Base | Configuring CCBill for Ubersmith","isPartOf":{"@id":"https:\/\/ccbill.com\/doc\/#website"},"primaryImageOfPage":{"@id":"https:\/\/ccbill.com\/doc\/ccbill-ubersmith-integration#primaryimage"},"image":{"@id":"https:\/\/ccbill.com\/doc\/ccbill-ubersmith-integration#primaryimage"},"thumbnailUrl":"https:\/\/ccbill.com\/doc\/wp-content\/uploads\/2021\/05\/disable-user-management.png","datePublished":"2020-08-10T18:43:43+00:00","dateModified":"2023-04-20T08:09:43+00:00","author":{"@id":"https:\/\/ccbill.com\/doc\/#\/schema\/person\/2cc5b50e34ee63ed498ac333a25840ad"},"description":"How to setup CCBill for use with Ubersmith","inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/ccbill.com\/doc\/ccbill-ubersmith-integration"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/ccbill.com\/doc\/ccbill-ubersmith-integration#primaryimage","url":"https:\/\/ccbill.com\/doc\/wp-content\/uploads\/2021\/05\/disable-user-management.png","contentUrl":"https:\/\/ccbill.com\/doc\/wp-content\/uploads\/2021\/05\/disable-user-management.png","width":750,"height":319,"caption":"Disabling CCBill user management."},{"@type":"WebSite","@id":"https:\/\/ccbill.com\/doc\/#website","url":"https:\/\/ccbill.com\/doc\/","name":"CCBill Doc","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/ccbill.com\/doc\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/ccbill.com\/doc\/#\/schema\/person\/2cc5b50e34ee63ed498ac333a25840ad","name":"Vladimir Kaplarevic","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/ccbill.com\/doc\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/8d4609e99e6aecc69ce049e18d45f033?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/8d4609e99e6aecc69ce049e18d45f033?s=96&d=mm&r=g","caption":"Vladimir Kaplarevic"}}]}},"_links":{"self":[{"href":"https:\/\/ccbill.com\/doc\/wp-json\/wp\/v2\/posts\/159"}],"collection":[{"href":"https:\/\/ccbill.com\/doc\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ccbill.com\/doc\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ccbill.com\/doc\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/ccbill.com\/doc\/wp-json\/wp\/v2\/comments?post=159"}],"version-history":[{"count":15,"href":"https:\/\/ccbill.com\/doc\/wp-json\/wp\/v2\/posts\/159\/revisions"}],"predecessor-version":[{"id":8070,"href":"https:\/\/ccbill.com\/doc\/wp-json\/wp\/v2\/posts\/159\/revisions\/8070"}],"wp:attachment":[{"href":"https:\/\/ccbill.com\/doc\/wp-json\/wp\/v2\/media?parent=159"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ccbill.com\/doc\/wp-json\/wp\/v2\/categories?post=159"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ccbill.com\/doc\/wp-json\/wp\/v2\/tags?post=159"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}