This article will guide you in integrating your Zomentum account with ConnectBooster/BNG Payments. The integration will enable you to collect payments from the end customer while approving the quote. 

 

Prerequisite:

  • You would need a BNG Payments account

Note: All Connectbooster customers will have a BNG payment account too.

 

Integration Overview:

  1. The integration will enable collecting payment from the end customer while approving the quote

  2. Only Credit card payments can be processed 

  3. Payments in USD and CAD are supported

Setting up Integration

  1. Obtain API Security key from BNG Gateway account. 

    1. You can generate or find your API Security Key in the BNG Gateway portal by navigating to Options > Settings > Security Keys

    2. More information on creating the API security key can found here:

    3. Note: Zomentum only needs API permissions while creating the security key

  2. Obtain Tokenization key from BNG Gateway account.

  3. Authenticate via a "tokenization key" that you can generate in your merchant control panel under the "Security Keys" settings page. Select a public key, and then "Tokenization" for the key permissions.

    Step 1: Login with your BNG Payment credentials




    Step 2: Scroll down and select “Settings”


    Step 3: Select “Security Keys”


    Step 4: Scroll down to “Public Security Keys” and click on “Add a new public key”


    Step 5: Enter Key name, Username associated with key, and select “Tokenization” in Key permission. 


    A new description will appear in the Public Security Keys as shown below. 


    Step 6: Copy the code

    Step 7: Open the Zomentum Dashboard and click on Settings -> Integrations

    Step 8: Scroll down to the Payment Gateway section and click Connect

    Step 9: Enter the copied Tokenization Key and add your API Key


    You will successfully connect to ConnectBooster now. 

    1. In Zomentum, Navigate to Settings -> Integrations

    2. Scroll down to the Payment Gateway section and click on "Connect" under Connectbooster

    3. On the right drawer enter the API security key and hit save

Enabling payments on documents

Once you have enabled the integration you can now go to the documents and enable payments to start collecting payments. 

  1. To enable payments go to any document you want to collect the payment. 

  2. Click on the Payments tab on the right-hand side. 

  3. Enable the Payments Gateway toggle. 

  4. Choose the amount you want to collect on the particular document

    • Select "Grand total" if you want to collect the total amount mentioned on the Document

    • Select 2nd option if you want to collect certain percentage of the total amount

    • Select 3rd option (Custom amount) to enter the amount you want to collect on the docume

  5. The payment is mandatory by default and the Client has to make the payment before approving the quote. You have an option to make the payment optional aswell by clicking the "Make payment optional" checkbox. 

  6. Lastly select the payee. Payee can only be a signee or an approver of the document.

  7. Once payment is enabled, send the document and the client will view the option to make the payment while approving the document. Below is a gif on how the Client will be able to make the payment




Invoice Reconciliation: Find transactions and check the status in BNG Gateway 


After the client does the needful, the payment transaction enters the BNG Gateway. And the opportunity/document moves to the PSA. 


On our platform, the client can check the transaction status in their BNG Gateway. Post confirmation, they can create the invoice in the PSA.  


To check status, we offer several custom-defined fields that you can choose in the client's BNG gateway to identify the transactions with their quotes and opportunities quickly. 


Follow the steps to find transactions and check the status before creating the invoice in the PSA. 


Step 1: Log in to your BNG Gateway account and click on Transaction. 



Step 2: Scroll down. Search transactions by entering the relevant fields and hit submit. For example, enter start and end date to select a period of transactions. 



Step 3: You’ll be directed to the transaction report page that hosts all your transactions made to date. 





Step 4: To introduce custom fields and find transactions, click on “Configure.”



Step 5: Select or deselect checkboxes and “Save Changes” to specify columns, identify transactions, and check the status of those transactions. 




Step 6: You’ll now be able to view transactions matching the specified merchant-defined fields. Appropriate column headers will appear accordingly.  



Below is the list of custom merchant-defined fields that you can select:


  1. MDF 1 - DB ID - Currently, it is Quote doc ID

  2. MDF 2 - Opp. ID

  3. MDF 3 - Document Number

  4. MDF 4 - Document URL

  5. MDF 5 - Opportunity Title

  6. MDF 6 - Document Title

  7. MDF 9 - Manual/….

  8. MDF 10 - Zomentum - codebase

  9. MDF 11 - Set this field to the email of the contact who is making the payment.

  10. MDF 12 - Set this field to the ID of the company that is making the payment. 

  11. MDF 13 - Same as MDF 11

  12. MDF 14 - Same as MDF 12

  13. MDF 15 - Zomentum

  14. MDF 16 - Provider Identifier