Welcome to Zuora Product Documentation

Explore our rich library of product information

PIX for EBANX payment gateway integration

Zuora supports one-time PIX payments through the EBANX payment gateway, enabling merchants to offer a local payment option in Brazil.

Zuora supports PIX through the EBANX payment gateway integration, so you can offer a local payment option for customers in Brazil.

Use standard PIX for one-time payments. When a customer pays with PIX, Zuora creates a PIX payment request and returns PIX-specific payment data that you can present in your checkout experience, such as a QR code and a copy-and-paste PIX code. The customer completes the payment in their banking app, and Zuora updates the payment status asynchronously after receiving the final status from EBANX.

Standard PIX does not create a reusable stored payment method and is intended for one-time, customer-present payment flows only. If you need recurring PIX payments, use PIX Automático for EBANX instead.For more detailed information, seePix Automática for EBANX Payment gateway integration.

Note that:

  • Standard PIX is available only for the Brazil region and supports BRL only.
  • Your customers must have a PIX-enabled bank account in Brazil.
  • Standard PIX is for one-time payments only and does not create a reusable payment method.
  • If you need a recurring PIX payment experience, use PIX Automático for EBANX instead.

Supported features

  • Initiate one-time PIX payments through EBANX for Brazil checkout flows.
  • Display PIX payment data to customers, including QR codes and copy-and-paste PIX codes.
  • Receive asynchronous payment status updates after payment initiation.
  • Use PIX as a distinct payment option in Zuora Payment Forms.

Not supported features for standard PIX

  • Create reusable payment methods from standard one-time PIX transactions.
  • Create PIX payment methods directly through the Zuora UI or generic API-only payment method creation flows.
  • Use standard PIX for recurring payment scenarios. For recurring payments, use PIX Automático for EBANX instead.

One-time payment flow

Zuora supports a one-time PIX payment flow through EBANX. When the customer selects PIX and submits the payment form, Zuora sends a payment request to EBANX and receives PIX-specific data for the customer action step. This data can be presented as a QR code or a copy-and-paste PIX code.

After the customer completes the payment in their banking app, EBANX sends the payment status to Zuora. Zuora then updates the payment to its final state. If the customer does not complete the payment before the PIX expires, the payment moves to a terminal failed or expired state and must be retried by creating a new PIX payment request.