Brazil PIX
Production
https://api.paypaga.com
Production
https://api.paypaga.com
POST
/v2/transactions/pay-in
Required Fields
| Field | Description | Validation |
|---|---|---|
| first_name | First name | Length >= 2 <= 50, RegEx ^\p{L}(?:[ '-]\p{L}+)$ |
| last_name | Last name | Length >= 2 <= 50, RegEx ^\p{L}(?:[ '-]\p{L}+)$ |
| document_number | CPF (Cadastro de Pessoa Física) | RegEx ^(\d{3}.?\d{3}.?\d{3}-?\d{2}|\d{11})$ Must be valid CPF |
Expiry
Response Fields
| Field | Description |
|---|---|
| qr_code_content | Base64-encoded PIX QR code image (BR Code) the customer scans with their banking app to complete the payment. |
| reference | The PIX "Copia e Cola" code: the same BR Code payload as plain text, which the customer can paste directly into their bank app's PIX screen instead of scanning the QR code. |
QR Code
Payment Instructions
Important
Payments must be made exclusively by the account holder or an authorized user.
Third-party payments are not allowed and may result in account cancellation or suspension.
Importante
Los pagos deben ser realizados exclusivamente por el titular de la cuenta o un usuario autorizado.
No se permiten pagos de terceros y pueden resultar en la cancelación o suspensión de la cuenta.
Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.paypaga.com/v2/transactions/pay-in' \
--header 'Content-Type: application/json' \
--data-raw '{
"amount": 1000,
"country": "BR",
"currency": "BRL",
"customer_ip": "120.29.48.92",
"fields": {
"document_number": "241.390.720-32",
"first_name": "João",
"last_name": "Silva"
},
"merchant_customer_id": "customer@email.com",
"merchant_order_reference": "ORDER-2026-0002",
"merchant_transaction_reference": "TRX-2026-0002",
"payment_method": "pix",
"return_urls": {
"failure_url": "https://merchant.com/payment-failure",
"success_url": "https://merchant.com/payment-success"
}
}'Response Response Example
201 - Brazil PIX
{
"expires_at": "2026-06-09T14:13:05.143073869Z",
"instructions": {
"qr_code_content": "iVBORw0KGgoAAAANSUhE...giuGGL4IYtghu2/gXRjZ6j+5wP3QAAAABJRU5ErkJggg==",
"reference": "00020101021226880014br.gov.bcb.pix2566qrcode-h.fitbank.com.br/QR/cob/9BA5CDA69AB1CBAA0EE61D1F2910AB030FD5204000053039865802BR5925ORKESTRA TECNOLOGIA EM PA6014Belo Horizonte61083031002062070503***63043A5B"
},
"payment_method_reference": "129930",
"transaction_id": "20260205-1127-4678-8883-5e4868d33e4e"
}Modified at 2026-09-15 13:41:08