Skip to content
  • There are no suggestions because the search field is empty.

Configure CPM for Usio Platform

Once you have associated your payment platform to your external Usio account, you can configure this platform so that it will manage payment activities according to your business processes.

The CPM Payment Platform is where you will configure your settings for the integration to the payment platform. 

  • From the CPM Payment Platform, select the payment platform you want to configure or manage
  • You will want to complete setup on the API Engine, Accounting, Payment Requests, Refund Requests and Subscription Invoicing FastTabs

The API Engine FastTab
The API Engine FastTab instructs CPM as to what API configuration should be used for sending and receiving information from your connected Usio account. These values should be automatically populated as part of the payment platform setup, but if for any reason this is not the case, fill in the fields as follows:

  • App Code: enter CPM in this field.
  • API Engine Execution Module: enter USIO in this field.

The Accounting FastTab
The Accounting FastTab allows you to configure the Business Central accounts to which certain Usio transactions will post.

Field Description Example Value
Clearing G/L Account No. Select the G/L account to which you want to record unpaid Usio activity. As activity is performed in Usio, an outstanding balance of unpaid payments is accumulated. A balance sheet asset account representing
your Usio balance
Fee G/L Account No. If you are using the World Pay backend payment processor and have enabled the Request Convenience Fee setting, select the G/L account number to which you want to record these fees. An expense G/L account
Payout Bal. Account Type Indicate whether the balancing account to which Usio payouts are processed will be a Business Central G/L account or bank account record. Typically, a bank account record is used, but you should select whichever option reflects your desired processes. Bank Account
Bal. Account No. Select the Business Central G/L account or bank account (depending on the selected payout balancing account type) to which processed payouts will be recorded. CPM
automatically detects payout transactions in Usio and will post the corresponding activity to your specific balancing account.
A valid bank or G/L account
Payout Processing Days Field

The fields present the number of working days it takes for Usio to process payouts for various transaction types (ACH payments, credit card payments, and returns). These values are used to set the posting dates for payout batch activities that CPM retrieves from Usio. When a payout batch is created for an activity type, the related processing days value is applied to the batch date to determine its posting date. For example, if CPM created a new payout batch for ACH activity on 5/1 and our Usio platform’s ACH payout processing days value was 3, that batch’s posting date would be 5/4.

By default, the values in these fields will be set to Usio’s standard payout processing times. These settings can be changed if you have established different processing times with Usio.

 
Request Convenience Fee If you are using the World Pay backend payment processor, select this option to include convenience fees as part of the payment information you retrieve from Usio.
The TSYS processor does not charge convenience fees; leave this field unchecked if you are using TSYS.
 

The Payment Requests FastTab
The Payment Requests FastTab allows you to configure the manner in which CPM processes and manages payment request activities.

Field Description Example Value
Payment Request No. Series Select the number series that you want to use to assign numbers to CPM payment request records. It is recommended that you create a new number series for CPM payment requests. SENP_PMT_REQUEST
Default Payment Method Select the payment method code that will be assigned to payment customer ledger entries that are created from payment platform activity. When payments are retrieved
from Usio, CPM will attempt to create new payment entries in the related customers’ ledgers. The payment platform’s default payment method will be assigned as the payment method for these customer ledger entries. You can create a new payment method for the payment platform or use an existing one, but regardless of this decision it is recommended that you assign a payment method with a blank balancing account number.
USIO
Authorization Validity Enter the number of days for which a payment request for a credit card authorization will remain valid. When a payment request is created, CPM will apply this period to the record’s creation date to calculate an expiration date. If the authorized amount is not captured prior to this expiration date, the payment request expires and a new one must be created. 7 days
Capture Method

Select the method by which credit card payments for sales orders are processed. Because sales orders are open documents, CPM provides additional flexibility as to how credit card activity is handled.

  • Blank: CPM will handle sales order payments according to the external payment platform’s default settings.
  • Immediate: CPM will automatically capture sales order payments.
  • Delay: CPM will create a payment request authorizing the sales order payment. This authorization will remain open until it is captured at a later date or expires.
Delay
Authorization Behavior

If the payment platform is configured to delay the capture of sales order payments, you must select the method by which authorized payments are captured.

  • Manual: authorized payments must be manually captured by a user.
  • Capture on Invoice: authorized payments are automatically captured when the sales order is invoiced.

It is not possible to define authorization behavior if the payment platform is configured to immediately capture sales order payments.
Capture on Invoice
Reauthorization on Partial Capture

If the payment platform is configured to delay the capture of sales order payments, you must select the method by which an authorized payment is handled when a partial capture of the authorization amount is executed.

  • Manual: if an authorized payment amount is partially captured, the user must manually record a new payment request record for the remaining amount of the authorization.
  • Auto: if an authorized payment amount is partially captured, CPM will automatically create a new payment request record for the remaining amount of the authorization.

It is not possible to define reauthorization behavior if the payment platform is configured
to immediately capture sales order payments.
Auto

The Refund Requests FastTab
If you want to issue refunds against captured sales order payments, you can configure this process on the Refund Requests FastTab.

Field Description Example Value
Refund Request No. Series Select the number series that you want to use to assign numbers to refund requests. It is recommended that you create a new number series for CPM refund requests. SENDP_RFD_REQUEST

 

Next: CPM Customer Mapping