Pay Out by PIX to a Third Party
A third-party payout is a PIX to someone whose CPF/CNPJ differs from the account holder's: paying a supplier, an end customer or a seller. The recipient's CPF/CNPJ is the owner of the PIX key (or of the bank account or BR Code you pay), and it's compared with the holder of the account that creates the ticket. Whether the main account can do it depends on how your account is configured with Avenia, so this recipe has two paths. Ask your Avenia contact which one applies to you.
Path A: pay from the main account
When your account allows third-party payouts, it's a regular PIX payout. The access behind your API key needs the payOut permission, and if it has enforceAllowedBeneficiaries on, pay a registered beneficiary instead of an inline PIX key.
Quote
Ticket, with the beneficiary's PIX key (or a registered beneficiary or full bank details):
{
"quoteToken": "eyJ...",
"ticketBrlPixOutput": {
"pixKey": "supplier@example.com",
"pixMessage": "Invoice 1234"
}
}
{
"id": "012e4d72-a5cb-48ed-accb-2200071ebf47",
"expiration": "2026-10-25T18:51:03.172077281Z"
}
Confirm by reading the ticket or waiting for TICKET-COMPLETE. In sandbox the ticket reached PAID, with the beneficiary's tax ID in brazilianFiatReceiverInfo.taxId.