Skip to main content

Set up a custom payment gateway

Zuora

Set up a custom payment gateway

  1. Last updated
  2. Save as PDF

Before you begin

Before you set up a custom payment gateway, make sure that you have completed the following tasks:

Procedure

To set up a custom payment gateway through the Zuora UI, follow these steps:

  1. Navigate to Settings > Payments > Setup Payment Gateway.
  2. Select UPC Token Gateway from the Gateway Type list and click create gateway.
  3. Complete the custom payment gateway settings.
    • When specifying the endpoint of the payment hub, note the following restrictions due to security reasons:
      • Only the https scheme is supported.
      • The host address in the endpoint must be a registered hostname, but not an IP address.
      • Only the default 443 https port is supported. You can skip specifying the port and the 443 port will be used.

      Here are examples of valid endpoints:
      https://abc.def/xyz

      https://abc.def:443/xyz 
      
Here is an example of an invalid endpoint:
      http://23.23.23.23/

    • For the credentials to access the payment hub, only basic authentication is supported for the time being.

      PAY-custom-pg.png

    • The following fields are related to Level 2 and Level 3 data processing:
      • Enable Level 2 Processing
      • Enable Level 3 Processing
      • ShipFrom Postal Code Custom Field API Name
      • ProductCode Custom Field API Name
      • CommodityCode Custom Field API Name

      If Level 2 and Level 3 data processing is enabled, additional information, such as the amount of sales tax and order and line items, is passed to the gateway when processing a credit card transaction. This information might result in lower interchange rates on eligible commercial, corporate, and purchasing cards.

      See Level 2 and Level 3 data processing on the custom payment gateway integration for more information.