Welcome to Zuora Product Documentation

Explore our rich library of product information

Configuration fields

This document provides guidance on configuring the Nuvei payment gateway in Zuora, including setting up basic information, credentials, rules, and testing environments.

Basic Information

  • Name: The name of this payment gateway in Zuora.
  • Use Gateway Test Environment: Determines whether transactions are sent to the test environment or live environment of the Nuvei payment gateway.

Credentials

  • Merchant Secret Key
  • Merchant ID
  • Merchant Site ID

Rules

  • Default Authorization Amount: The amount to use when performing an authorization when creating or updating a card.
  • Verify new payment method:

    Verify new payment method: Validates the payment method when it is created or updated. For the Nuvei gateway integration, create tokenized payment methods as CreditCard payment methods and pass the Nuvei token values in the tokens object. Do not use CreditCardReferenceTransaction, because the Nuvei gateway integration does not support CC Reference Transaction payment methods. If the token has already been validated by Nuvei and you only want to store the payment method in Zuora, set skipValidation to true in the API request.

  • Verify updated payment method: Triggers a credit card authorization when updating an existing card.

Test the configuration

For basic guidance on how to test payment gateway integrations within a sandbox environment, see Test payment gateway integration.

Accessing Your gateway's Test Environment

Some payment gateways provide separate credentials for merchants to access their testing environment, some gateways use the same credentials for testing as for the production (live) environment but direct test transactions to a different URL, and other gateways do a little of both. Moneris eSelectPLUS customers utilize a shared testing environment.

Accessing Test or Production (Live) Mode from Zuora

When configuring the Nuvei payment gateway in Zuora, you can indicate whether you would like to use the Nuvei test environment or the Nuvei production environment.

  • If Use Gateway Test Environment is selected, Zuora will direct payment transactions to the Nuvei test environment.
  • If Use Gateway Test Environment is not selected (disabled), Zuora will direct payment transactions to the Nuvei production (live) environment.

When using the Nuvei testing environment, you will need to use the testing credentials provided in the Nuvei documentation (see section below on Test Credit Cards and Testing Scenarios). Zuora ensures your payment transactions are routed to the right environment based on whether the Use Gateway Test Environment is selected.