This document is broken down into a 5 part setup process, which should take less than 10 minutes. Once complete, you will be able to utilize ConnectWise Sell with the same BNG Gateway/ConnectBooster back-end you are using today.
One of the major benefits to this allows your clients to pay directly from their Quote acceptance page!
This includes paying by credit card, and electronic check if you currently accept these today through your ConnectBooster interface. Additionally, any payment methods clients use can be automatically saved, and then later used within ConnectBooster without re-entry.
Part 1: Creating A New BNG Gateway User
While this step is not 100% required, we highly recommend doing so. Creating a dedicated BNG Gateway user account for any new integration gives greater flexibility with reconciliation reports, and email notifications.
Login to your Gateway and Navigate to Options --> Settings
Under General Options --> select User Accounts
Click the link to Add A New User
Complete the Required User Profile Fields.
*Optional: If you would like to have a copy of transaction receipts sent to the email of this user profile, check the below notification preferences as shown.
This can be extra useful if you have a workflow or need to immediately know when quote payments are received. Note: this transaction receipt email will ONLY be for transactions done via this user account. Leaving the "Access Other User's Transactions" box UN-CHECKED is important, so you are not flooded with standard ConnectBooster transactions (which could get overwhelming).
Set User Permissions as Shown
Click "Create User" to finalize user setup.
Part 2: API Security Key Creation
The next two parts will consist of generating "Security Keys" that you will copy/paste later into Order Porter.
Navigate to Options --> Settings
Security Options section --> Security Keys
1. Enter a description for the new key
2. Assign the User you created in Part 1 above
3. Tick the "API" box for gateway API access
4. Complete the Key creation using the button
Copy the newly created API Key and paste it to the software you are integrating, or document for later retrieval.
Part 3: Tokenization Security Key
Navigate to the Public Security Key section.
Select "Add a New Public Key"
1. Enter a Key Name
2. Select the user previously created in Part 1.
3. Tokenization needs to be selected on the drop-down.
4. Complete key creation using the button
Part 4: ConnectWise Sell Configuration Steps
Login to your Sell instance as an Administrator.
Navigate to Settings + Document Branding + Order Porter Setup. Click on "ConnectBooster / BNG Payments"
Here you will need to:
1. Activate the option
2. Enter the BNG Gateway Private Key - (API)
3. Enter the BNG Gateway Tokenization Key - (Public)
4. Save your settings
API Key: known as "Private"
Tokenization Key: known as "Public"
Copy and paste the respective keys into the correct fields. Save your changes.
Select Test connection to verify the setup is correct.
You should see:
Congratulations! You have configure Sell to utilize payment processing from the BNG Gateway. Don't forget to "Upload Metadata" for these changes to fully take effect.
Part 5: Order Porter Template Setup
At this point you need to ensure the proper template is used when Quotes are delivered to clients.
In our example, we have "Quosal Accordion CB_11_18_19" selected on the Publish and Deliver step.
Please verify your quote acceptance templates have the "Pay Now" option, for credit card and ACH (if available).
If missing this template, you likely need to download the latest Sell Accordion 2019 Order Porter template. This can be done using the "Content Vault", under the Community Resources tab.
Search for "Accordion", or simply "2019". These Order Porter templates support payment processing with ConnectBooster.
Ensure that the "Payment Processing" option has ConnectBooster selected for your Order Porter Settings. This can be accessed on the "Publish Settings" during the Quote Setup step.
If you are having difficulty with the template from here, we suggest contacting ConnectWise Sell support.
From the client's perspective, selecting "Pay Now" on the quote acceptance page now displays the payment method form options.
Electronic Check (ACH) and Credit Card:
Note: transactions made will need to be manually received within your accounting system. This process does not change today.