Welcome to Zuora Product Documentation

Explore our rich library of product information

Set up a custom payment gateway

Learn how to configure a custom payment gateway in Zuora, including selecting the gateway type and completing necessary settings.

You have set up a web server outside of Zuora as the payment hub to process requests and responses between the custom payment gateway and the external payment gateway.

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: 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/

      • 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.

    • PAY-custom-pg.png
    • The following fields are related to Level 2 and Level 3 data processing: 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.

      • 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

Configure and manage your custom payment method type through the “Custom Payment Method Types” API operations .