home

Zuora Payments

Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableZuora AIRelease NotesBasicsEntitlementsSupport and policies
Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableZuora AIRelease NotesBasicsEntitlementsSupport and policies

Welcome to Zuora Product Documentation

Explore our rich library of product information

Show Contents

thumbnailZuora Payments

Configuring mandate consent for Paystack Direct Debit

Processing Paystack Direct Debit payments

Process a Paystack Direct Debit payment from the Zuora UI, through the Zuora REST API, or through a payment run. Each method requires an active EFT Debit Order mandate on the payment method.

Before you process the payment, confirm the following:

  • The payment method is a Paystack Direct Debit payment method associated with a Paystack gateway instance.
  • The EFT Debit Order mandate associated with the payment method is active at Paystack.
Important: Zuora can process a Paystack Direct Debit payment only when the associated mandate is active. If the mandate is closed, suspended, expired, or otherwise unavailable at Paystack, you cannot process a payment with that payment method.

Paystack Direct Debit payments use the active mandate created when the payment method was saved. Zuora sends the stored Paystack mandate code with the payment request, regardless of which method you use to initiate the payment.

  1. Process the payment using one of the following methods:

    • To process the payment from the Zuora UI:

      1. Open the customer account.
      2. Select the active Paystack Direct Debit payment method.
      3. Enter the payment amount and currency.
      4. Submit the payment.

    • To process the payment through the Zuora REST API, call the payment operation and specify the active Paystack Direct Debit payment method. For more information, see Create a payment.

    • To collect outstanding invoice balances for customer accounts that use an active Paystack Direct Debit payment method, use a payment run. The payment run must use a payment gateway configuration that supports Paystack Direct Debit. For more information, see Payment Runs.

    Zuora sends the payment request to Paystack using the active mandate associated with the payment method. For a payment run, Zuora uses the active mandate associated with each payment method that the payment run selects.

  2. Review the payment and transaction logs.

    The logs record the gateway response and the mandate status returned by Paystack.

Zuora records the payment and the gateway response. When the mandate is unavailable at Paystack, the payment is not processed and the gateway response identifies the mandate status.

If the payment failed because of a mandate issue, resolve the mandate in Paystack, and then update or replace the payment method in Zuora.

Last updated: August 21, 2026