Referência
Gere um QRCode Pix e um código copia-e-cola para o seu cliente
Estrutura
Uma cobrança via QRCode Pix é representada em nossa API pela seguinte estrutura:
{
"id": "pix_charabc123456789",
"amount": 4000,
"status": "PAID",
"devMode": true,
"method": "PIX",
"brCode": "...",
"brCodeBase64": "...",
"platformFee": 80,
"description": "Pagamento PIX com AbacatePay",
"createdAt": "2024-12-06T18:56:15.538Z",
"updatedAt": "2024-12-06T18:56:15.538Z"
"expiresAt": "2024-12-06T18:56:15.538Z"
}
Atributos:
{
"id": "abc123uA0M0xwg5R4mSyr0n2PjHQXY"
}
id
: string.
Identificador único da cobrança.
{
"amount": 4000
}
amount
: number.
Valor da cobrança em centavos (ex: 4000 = R$ 40,00)
{
"status": "PAID"
}
status
: string.
Status da cobrança. Pode ser PENDING
, EXPIRED
, CANCELLED
, PAID
, REFUNDED
.
Status | Descrição |
---|---|
PENDING | A cobrança está com o pagamento pendente |
EXPIRED | O tempo limite de pagamento foi excedido |
CANCELLED | A cobrança foi cancelada por você |
PAID | A cobrança foi paga com sucesso pelo cliente |
REFUNDED | O valor foi devolvido ao cliente |
{
"devMode": true
}
devMode
: boolean.
Indica se a cobrança está em ambiente de testes (true
) ou produção (false
).
{
"method": "PIX"
}
method
: string.
Método de pagamento.
{
"brCode": "..."
}
brCode
: string.
Código PIX (copia-e-cola) para pagamento.
{
"brCodeBase64": "..."
}
brCodeBase64
: string.
Código PIX no formato Base64 (útil para exibição em imagens).
{
"platformFee": 80
}
platformFee
: number.
Taxa da plataforma em centavos. Exemplo: 80
significa R$ 0,80.
{
"description": "Pagamento PIX com AbacatePay"
}
description
: string.
Descrição da cobrança.
{
"createdAt": "2024-12-06T18:56:15.538Z"
}
createdAt
: date-time.
Data e hora da criação da cobrança.
{
"updatedAt": "2024-12-06T18:56:15.538Z"
}
updatedAt
: date-time.
Última atualização da cobrança.
{
"expiresAt": "2024-12-06T18:56:15.538Z"
}
expiresAt
: date-time.
Data e hora de expiração do QRCode.