Brazil PIX
Production
https://api.paypaga.com
Production
https://api.paypaga.com
POST
/v2/transactions/pay-out
Required Fields
| Field | Description | Validation |
|---|---|---|
| name | Full name of the beneficiary | Length >= 2 <= 60 |
| person_type | Indicates whether the beneficiary is an individual or a company | From options: individual, company |
| document_number | CPF or CNPJ of the beneficiary. CNPJ must be enabled for your account; contact support | RegEx ^(\d{3}\.?\d{3}\.?\d{3}-?\d{2}|\d{2}\.?\d{3}\.?\d{3}/?\d{4}-?\d{2})$ Must be a valid CPF or CNPJ |
| document_type | Identification type | From options: CPF or CNPJ |
| account_number | Registered PIX key to identify the beneficiary which can be one of the following: CPF, CNPJ, Email, Phone (must include prefix “+55”) | Must be valid PIX key |
Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.paypaga.com/v2/transactions/pay-out' \
--header 'Content-Type: application/json' \
--data-raw '{
"amount": 125.5,
"country": "BR",
"currency": "BRL",
"customer_ip": "120.29.48.92",
"fields": {
"account_number": "43000000000",
"document_number": "123.456.789-09",
"document_type": "CPF",
"name": "Rafael Beaty",
"person_type": "individual"
},
"merchant_customer_id": "customer@mail.com",
"merchant_order_reference": "ORDER-2026-0001",
"merchant_transaction_reference": "TRX-2026-0026",
"payment_method": "pix"
}'Response Response Example
202 - Generic response for all payment methods
{
"merchant_order_reference": "ORDER-2026-0001",
"merchant_transaction_reference": "TRX-2026-0026",
"transaction_id": "20240806-2010-4086-8342-c28f4979f834"
}Modified at 2026-10-15 15:50:10