Skip to main content
Use this page for the write path that starts a Pix collection.

Happy path

  1. Create a transaction with method: "pix".
  2. Return the Pix QR code data to the buyer.
  3. Persist the Pagou transaction id and your external_ref.
  4. Wait for webhook delivery.
  5. Reconcile only when the payment state is uncertain.

Example request

Example response

Common error

Status 422
Fix: validate buyer data before calling Pagou. Do not treat pending as final. The payment is only settled after a terminal status such as paid.

What your frontend should receive

Return only the buyer-facing Pix data your frontend needs, such as:
  • transaction id
  • current status
  • pix.qr_code
  • pix.expiration_date

Next steps