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
QR Code
Payment Instructions
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",
"payment_method": "pix",
"merchant_order_reference": "ORDER-2026-0002",
"merchant_transaction_reference": "TRX-2026-0002",
"merchant_customer_id": "customer@email.com",
"customer_ip": "120.29.48.92",
"fields": {
"first_name": "João",
"last_name": "Silva",
"document_number": "241.390.720-32"
},
"return_urls": {
"success_url": "https://merchant.com/payment-success",
"failure_url": "https://merchant.com/payment-failure",
"cancel_url": "https://merchant.com/payment-cancelled"
}
}'Response Response Example
{
"transaction_id": "20260205-1127-4678-8883-5e4868d33e4e",
"payment_method_reference": 129930,
"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"
}
}Modified at 2026-06-09 10:56:40