Pay In - PIX
Developing
Develop Env
https://api.v2.stg.paypaga.com
Develop Env
https://api.v2.stg.paypaga.com
POST
https://api.v2.stg.paypaga.com
Fields validation
| field | validation |
|---|---|
| first_name | required, min length 2, max length 50, regexp ^\p{L}*(?:[ '-]\p{L}+)*$ |
| last_name | required, min length 2, max length 50, regexp ^\p{L}*(?:[ '-]\p{L}+)*$ |
| cpf_number | required, regexp ^(\d{3}\.?\d{3}\.?\d{3}-?\d{2}|\d{11})$, must be valid Brazilian CPF |
Request
Header Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.v2.stg.paypaga.com/payment' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
"transaction_id": "20251029-1517-41fc-ae26-f66a768bab2b",
"transaction_total": 100.03,
"payment_method_code": "BNKTR",
"currency": "BRL",
"merchant_transaction_reference": "abc4561698162696828",
"transaction_fields": [
{
"name": "first_name",
"value": "Barão"
},
{
"name": "last_name",
"value": "Praça"
},
{
"name": "cpf_number",
"value": "241.390.720-32"
}
]
}'Response Response Example
200 - Success
{
"transaction_id": "20251029-1517-41fc-ae26-f66a768bab2b",
"transaction_payment_mode": "ASYNCHRONOUS",
"payment_method_reference": "129930",
"message": "Transaction Successfully",
"version": "0.1",
"next_steps_detail_instructions": [
{
"type": "label",
"key": "payment_method",
"label": "Payment Method",
"description": "pix"
},
{
"type": "label",
"key": "main_instructions",
"label": "Instruções",
"description": "Escaneie o código QR ou copie o PIX Copia-Cola para prosseguir com o pagamento. Você tem 4 dias para poder completar seu pagamento."
},
{
"type": "qr_link",
"key": "qr_content",
"label": "QR",
"description": "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"
},
{
"type": "copy_link",
"key": "text_sequence",
"label": "Copia Cola",
"description": "00020101021226880014br.gov.bcb.pix2566qrcode-h.fitbank.com.br/QR/cob/9BA5CDA69AB1CBAA0EE61D1F2910AB030FD5204000053039865802BR5925ORKESTRA TECNOLOGIA EM PA6014Belo Horizonte61083031002062070503***63043A5B"
}
]
}