Skip to main content

SagePay Gateway


SagePay Gateway

SagePay provides payment gateway services that provides online credit card payment processing. 

This feature is in Limited Availability. If you want to have access to the feature, submit a request at Zuora Global Support

This gateway requires adding Zuora EU or US Cloud Data Center IP addresses to the whitelist for each of your gateway merchant accounts, depending on which data center that your tenant is located at. Therefore, before start using this gateway on Zuora EU or US Cloud Data Center, you must contact with the gateway to add Zuora EU or US Clould Data Center IP addresses to the gateway's whitelist for both the Sandbox and Production environments so that both environments can work properly.
For more information about the Zuora EU or US Cloud Data Center IP addresses, see Outbound IP Addresses Whitelisting.

Supported Payment Operations

The following payment operations are available through SagePay:

  • Payment Method creation (authorization and authorization reversal)
  • Payment
  • Payment void
  • Payment refund
  • Non-referenced refund

3D Secure transactions through SagePay are not supported in this version of the integration. If a SagePay merchant account is setup with the option to use 3D Secure authentication and the credit card account and card issuer are enrolled in the 3D Secure scheme, any request to create a credit card payment method or a request for a payment transaction will fail.

Supported Payment Methods

SagePay supports the following payment methods:

  • Credit Cards (Visa, MasterCard, Discover, American Express, JCB, and Diners Club)

Configure the SagePay Gateway

  1. Navigate to Payments Settings > Setup Payment Gateway
  2. Select SagePay from the Gateway Type drop-down menu.
  3. Click create gateway.
  4. Specify the configuration field values and click save gateway information.

Register Zuora's outbound IP addresses with SagePay. These Zuroa IP addresses are used as part of a verification process for SagePay to ensure that transactions are from a recognized source. See IP Address Registration for more information.

Common Configuration Fields 

There are some common fields you must complete for every gateway configuration. Zuora recommends reviewing Setting Up Payment Gateways for information on these fields: 

  • Type
  • Default
  • Active
  • Name
  • Use Gateway Test Environment
  • Vendor Name

The vendor name is used to authenticate the request. This field requires the SagePay vendor name supplied by SagePay when the merchant account was created.

  • Cards Accepted

Sagepay supports the following credit cards: Visa, MasterCard, American Express, and Discover.

  • Default Authorization Amount 
  • Verify new payment method (required)
  • Verify updated payment method (optional)

Additional Gateway Information

Vendor Name

When a merchant account is set up with SagePay, a vendor name is assigned. The vendor name is a mixture of alphanumeric characters without spaces or special characters. The vendor name is sent in the transaction registration post and is used by SagePay to identify the account through which the transaction will be processed. Without this value, SagePay cannot identify the correct account and therefore cannot process transactions. 

IP Address Registration

When making a request to SagePay, SagePay not only requires the Vendor Name but also that the originating IP address is recognized by SagePay. Thus, the Zuora IP addresses need to be registered with SagePay before hand so that SagePay accepts the request as coming from a recognized source.

For information on Zuora outbound IP addresses, see Outbound IP Addresses from Zuora.

To register an IP address in SagePay:

  1. Access the SagePay merchant account through Sign in to MySagePay.
  2. Navigate to the merchant account and click the Settings tab.
  3. Click Valid IPs in the left navigation pane.
  4. Click Add and complete the IP information.

Disabling 3D Secure Authentication Settings

Because the integration with SagePay does not support 3D Secure authentication, we recommend disabling this function when you use Zuora's Billing and Payment Platform. Otherwise, payment creation and payment transactions fail.

To disable 3-D Secure settings:

  1. Access the SagePay merchant account through Sign in to MySagePay.
  2. Navigate to the merchant account and click the Settings tab.
  3. Click 3D Secure in the left navigation panel.
  4. In the pane that appears, make sure the setting for 3d Secure checking is off. If the setting is on, click Turn off.

Additional SagePay Merchant Account Settings

The following merchant account settings need to be enabled by SagePay Support, as they are not enabled by default, and are not configurable through the MySagePay site:

  • Support for Non-referenced refunds (SagePay API DIRECTREFUND)
  • Support for Additional Card Types (American Express, Discover)
  • Configuration of the merchant account to the desired currency

To enable these settings, make your request through