PIX
Get in touch
Sign in
PIX
PIX simplifies real-time payments in Brazil with secure and instant account-to-account transfers
PIX API simplifies real-time payments in Brazil with secure and instant account-to-account transfers. PIX is a real-time payment system developed and managed by the Central Bank of Brazil. It ensures fast, safe, and efficient payments for merchants and customers.

Merchants can receive payments directly from customers' bank accounts using a QR code or a unique payment key, enhancing the checkout experience.
Payment type Wallet

Payment flow Redirect

Availability API

Countries Brazil (BR)

Currencies Brazilian Real (BRL)

Min amount 0.5 BRL

Max amount Bank dependent
Recurring Yes

Refund Yes

Partial refunds Yes

Multiple partial refunds Yes

Chargeback No

Principle of operation

  1. Selection at checkout: Customer selects PIX at checkout.
  2. Payment initiation: Merchant redirects the user to the PIX redirect URL.
  3. Authentication and authorization: Customer selects their bank for payment processing.
  4. Payment confirmation: Customer sees the payment details confirmation screen.
  5. Payment approval: Customer authenticates and approves the payment.
  6. Merchant notification: Solidgate notifies the merchant of the payment status update, which can be one of the Guide
    Efficiently manage and track alternative payments with real-time updates.
    statuses
    approved / declined / settle_pending

Init payment API request must be sent with the pix parameter to the payment_method field for smart PIX.
  1. Selection at checkout: Customer selects PIX at checkout.
  2. Payment initiation: Customer is redirected to the PIX payment page, which contains a QR code.
  3. Authentication and authorization: Customer scans the QR code using banking app or enters the payment key.
  4. Payment confirmation: Customer approves the payment, which may result in one of the Guide
    Efficiently manage and track alternative payments with real-time updates.
    statuses
    approved / declined / settle_pending
  5. Merchant notification: Solidgate sends a message to the merchant confirming the transaction's outcome upon receiving the payment result.

Init payment API request must be sent with the pix-qr parameter to the payment_method field.

Payment page example Payment page example Payment page example

For PIX refunds, a connector can process the refund using the same PIX information the customer provided for the original payment.

However, this is only possible on the same day the PIX payment is confirmed.

If this time frame has passed, the connector will email the customer to request their bank information or PIX key in order to issue the refund.

  • PIX key can be a CPF/CNPJ (Tax ID, Entity ID), an email address, a phone number, or a randomly generated key consisting of up to 32 characters.
Pix payments are real-time transfers that expire after 1 hour, and any unpaid transactions are automatically cancelled.

Looking for help? Contact us
Stay informed with Changelog