Receba pagamentos com QR Code Pix estático

O QR Code Pix estático permite receber múltiplos pagamentos usando a mesma chave Pix. Ele só expira quando uma data de expiração é definida.

Esse formato pode ser utilizado em cenários em que o mesmo QR Code fica disponível para diferentes pagadores, como em um estabelecimento comercial.

1. Crie o QR Code estático

Tenha em mãos a chave Pix que receberá os pagamentos e envie a requisição:

POST /v3/pix/qrCodes/static

{
  "addressKey": "b6295ee1-f054-47d1-9e90-ee57b74f60d9",
  "description": "Churrasco",
  "value": 50.00,
  "format": "ALL",
  "expirationDate": "2023-05-17 14:20:50",
  "expirationSeconds": null
}

Consulte o endpoint: Criar QR Code estático.

A resposta disponibiliza o id do QR Code e o payload com os dados do QR Code em Base64.

Não é necessário criar previamente uma cobrança ou definir o cliente. Quando o pagamento for realizado, os dados do pagador serão importados e uma cobrança será criada automaticamente.

2. Identifique o pagamento

Acompanhe os eventos do Webhook para cobranças.

Quando receber um evento de pagamento recebido, o campo pixQrCodeId identificará o QR Code estático utilizado.

3. Consulte as cobranças geradas

Utilize o pixQrCodeId para listar as cobranças criadas a partir do QR Code:

GET /v3/payments?pixQrCodeId=9bea9bcd226b45c7980065f598be54d5

Consulte o endpoint: Listar cobranças.

Próximos passos

• Configure o Webhook para cobranças
• Consulte as cobranças geradas pelo QR Code