Skip to content
Support Portal
Request Demo
  • There are no suggestions because the search field is empty.

Entering CPM for Usio Credentials

Once you have your Usio credentials, you can link them to your CPM platform in Business Central:

  1. Choose the icon, enter CPM Payment Platforms, and then choose the related link.
  2. Open the payment platform that you want to link to your Usio account.
  3. In the Merchant ID field, enter your unique merchant ID or the default value for sandbox access. If you enter the sandbox access value, the Payment Platform Mode field will automatically update to Test.
  4. Choose the icon, enter API Sets, and then choose the related link.
  5. On the API Sets page, select the Usio API set, then choose the API Credentials action in the ribbon.
You must create two API credential records to support payment and checkout activities. To create an API credential for payments:
  1. From the API Credentials page, choose the New action in the ribbon to create a new API credential record.
  2. In the Description field, enter a description to identify the API credential.
  3. In the API Endpoint URL field, enter a URL of https://payments.usiopay.com. This is the standard URL that is used by Usio for API calls for payments.
  4. On the Basic Auth. FastTab, enter your login and password values in the corresponding fields.
  5. On the API Key FastTab, enter your API key in the API Key field

To create an API credential for checkouts:

  1. From the API Credentials page, choose the New action in the ribbon to create a new API credential record.
  2. In the Function Code field, enter or use the AssistButton to assign the SUBMITTOKENPAYMENT function to the API credential.
  3. In the Description field, enter a description to identify the API credential.
  4. In the API Endpoint URL field, enter a URL of https://checkout.usiopay.com. This is the standard URL that is used by Usio for API calls for checkouts.
  5. On the Basic Auth. FastTab, enter your login and password values in the corresponding fields.
  6. On the API Key FastTab, enter your API key in the API Key field.
    1. Note: if you are creating multiple Usio payment platforms with different merchant IDs, you must set up a set of credentials for each one. In addition, you must enter the relevant platform’s code in the Usage Code field on the API credential records.

Usio Payment Processors
Usio currently has compatibility with two backend payment processors, TSYS and World Pay, that support different payment settlement methods:

  • TSYS: uses a gross settlement process. The full amount of a payment is paid out to the merchant, and Usio sends an invoice to the merchant for any associated transaction fees on a periodic basis. For example, if you recorded a payment for $1,000 that had a transaction fee of $28, Usio would deposit $1,000 into your bank account, then 
    send you an invoice for the $28 (as well as other fees incurred during the period).
  • World Pay: uses a net settlement and convenience fee process. The net amount of the payment minus the transaction fee (referred to as a “convenience fee”) is paid out to the merchant. For example, if you recorded a payment for $1,000 that had a transactional fee of $28, Usio would deposit $972 into your bank account. 

As part of your onboarding process with Usio, you will be assigned one of these processors; the determination as to which processor you will use is based on factors such as the merchant types you need to support and what sort of settlement method you want to use.


While CPM for Usio will support both of the processors, some of the configuration settings will be dependent on which processor you are using. For this reason, it is recommended that you obtain this information from Usio before continuing with the setup process.

Next: Configuring you Payment Platform