Make a PIX payment using bank account details

post

https://gateway.prd.pppay.cloud/api/pix/manual_pay

Creates a PIX payment request using the destination account's bank details, without requiring a PIX key.

Use this endpoint when the recipient does not provide a PIX key but supplies the bank account details that will receive the credit, or when the integration requires a transfer to a specific account without using a PIX key.

The CPF/CNPJ provided must be valid.
All bank details must belong to the same account.
The system may reject inconsistent or non-existent bank details.
The account_type field supports the following values:
- CACC: Checking account
- SVGS: Savings account
- SLRY: Salary account
- TRAN: Transactional account

Body Params

merchant_transaction_id

float

required

Transaction id on the side of the merchant

amount

float

required

Decimal value of the amount being charged (in R$)

pix_message

string

Message sent along with the PIX payment.

first_name

string

required

First name of the one being charged. Highly recommended

last_name

string

required

Last name of the one being charged. Highly recommended

document_number

string

required

Document number for the one being charged. Usually CPF for people and CNPJ for companies.

string

required

Email address for the one being charged. Highly recommended

branch_code

string

required

Bank branch number.

account_number

string

required

Bank account number.

ispb

string

required

The ISPB is an 8-digit code assigned by the Central Bank of Brazil to each institution participating in the PIX system.

account_type

string

required

CACC → (Checking Account / Credit Account) – most common case

Responses

200

401Unauthorized

409Duplicate Transaction

422Validation Error

500Internal Server Error