home

Zuora Payments

Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies
Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies

Welcome to Zuora Product Documentation

Explore our rich library of product information

Show Contents

thumbnailZuora Payments

Paystack payment gateway integration

Set up and configure a Paystack payment gateway instance

Learn how to set up and configure a Paystack payment gateway instance in your Zuora tenant, including prerequisites and step-by-step instructions.

  • Make sure you have requested support for Paystack payment gateway integrations through the Specialized Payment Connections service.
  • Contact Support and raise a ticket to enable this payment gateway for your tenant.
  • Enable the Paystack payment gateway integration for your tenant. For more information, see Enable payment gateway integrations for your tenant.

This payment gateway integration can be requested through the Specialized Payment Connections service at an additional cost.

Set up and configure a Paystack payment gateway instance by using the information in this article. erform the following steps to set up and configure a Paystack payment gateway instance in the Zuora tenant:

  1. Click your username in the upper right and navigate to Settings > Payments > Setup Payment Gateway.
  2. On the Payment Gateways page, click the Configure Gateway Instance tab and scroll to the bottom.
  3. On the Configure Gateway Instance tab, select the payment gateway from the Gateway Type drop-down.
  4. From the Gateway Type list, select Paystack.
  5. Click Create Gateway.
  6. In the New Gateway page, specify values for the configuration fields.

    See below for more information on the fields. Note that not all the configuration fields support the vertical line character "|". For password fields, if your gateway assigns a password containing this character, Zuora will display a validation error. To resolve this issue, contact your gateway provider to request a new password without the unsupported character.

  7. Under Basic Information, in the Name field, enter a name for the gateway instance.
  8. Enable the Use Gateway test Environment checkbox to use the payment gateway's test service URL when setting up the payment gateway integration.
  9. Under Credentials, in the Secret Key field, enter the secret key issued by the Paystack payment gateway.
  10. Under Rules, for the Cards Accepted field, select the cards you want to accept. Make sure your gateway's merchant account is also configured to support the same cards you have configured in Zuora. If you submit a transaction for a card type that is not enabled in your merchant account, it will result in an error stating that CardType is not supported or that you are not signed up for that tender type.
  11. In the Default Authorization Amount field, specify the minimum default amount used to authorize or validate a payment. The default value of this field is 1.
  12. Enable the Verify new payment method checkbox to verify the payment methods when creating them. By default, this checkbox is selected. For tokenized payment methods, you must validate them in Zuora so that payments made with these payment methods are successful.
  13. Enable the Verify updated payment method checkbox to verify the payment methods when updating them. By default, this checkbox is selected. For tokenized payment methods, you must validate them in Zuora so that payments made with these payment methods are successful.
  14. Click Save Gateway Information.

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

Last updated: December 5, 2025