Criar PIX
POST/v1/pix
Gera um QR Code para pagamento Pix e retorna o código para cópia e cola.
Gerar QR Code Pix
Parâmetros
Exemplo de requisição
{
"amount": 1,
"referenceCode": "123"
}Retorno (200)
Exemplo de resposta
{
"statusCode": "05",
"statusDescription": "Aguardando pagamento",
"pixTransactionId": "bec7361e36341a3bdad466b73e32d856abac0da6880d8aadd15b5f265478542cc",
"amount": 1,
"dueDate": "2026-03-20T11:09:57.2758708-03:00",
"qrCode": "11120101021226810014br.gov.bcb.pix2559api.rendimento.com.br/q/v2/1caeaeebvdfy2159afe08b369e4a405204000053039865802BR5914282492060111794414Santa Catarina61080000000062070503***630476AG"
}Dicionário de dados
Tabela de códigos de status Pix
| Código | Constante | Sigla | Descrição | Categoria |
|---|---|---|---|---|
0 | Confirmed | CON | Efetuada / Aprovada | Sucesso |
01 | New | NOV | Transação recém-criada | Pendência / Estado intermediário |
03 | PendingConfirmation | PPC | Pendente de confirmação | Pendência / Estado intermediário |
05 | AwaitingPayment | PEN | Aguardando resposta da instituição financeira | Pendência / Estado intermediário |
11 | AwaitingUser | AGU | Aguardando ação do usuário | Pendência / Estado intermediário |
14 | Retry | RET | Agendada para retentativa | Pendência / Estado intermediário |
06 | Denied | NEG | Negada pela instituição financeira | Negada / Encerrada sem sucesso |
04 | Undone | PPN | Desfeita (pendente não confirmado) | Negada / Encerrada sem sucesso |
09 | Expired | EXP | Expirada por prazo do NIT | Negada / Encerrada sem sucesso |
12 | Abandoned | ABA | Expirada por inatividade do usuário | Negada / Encerrada sem sucesso |
13 | Cancelled | CAN | Cancelada pelo usuário/comprador | Negada / Encerrada sem sucesso |
02 | Invalid | INV | Parâmetro incorreto na criação | Erro / Bloqueio |
07 | Error | ERR | Erro de comunicação com a autorizadora | Erro / Bloqueio |
08 | Blocked | BLQ | Bloqueada após múltiplas tentativas | Erro / Bloqueio |
10 | Reversed | EST | Estornada | Pós-pagamento |
Erros
As respostas de erro conhecidas estão abaixo. Os retornos observados em homologação estão identificados separadamente dos exemplos documentados; as respostas podem variar conforme o ambiente e a configuração.
Observado em homologação
Requisição com corpo JSON vazio ou identificador sintético. O retorno abaixo mostra a validação realizada em homologação.
[
{
"tag": "Amount",
"description": "Amount deve ser maior que zero"
}
]Campos da resposta de erro
A tabela reúne os campos presentes nos exemplos acima. Uma resposta HTTP sem corpo não inclui esses campos.