Navegação da referência

Referência / Pix

Gerar cobrança Pix

Gera uma cobrança Pix e o respectivo QR Code.

POST/api/v1/baas/charge

Body

6 campos
amount
numberObrigatório

Valor da cobrança em centavos. O mínimo é R$ 5,00, portanto envie pelo menos 500.

description
stringOpcional

Descrição da cobrança.

payment_method
stringOpcional

Forma de pagamento. Nesta referência, somente Pix está disponível.

Valor fixo: pix

Padrão: pix

due_date
stringOpcional

Data de vencimento. O Swagger atual não declara um formato adicional.

payer_name
stringOpcional

Nome do pagador.

payer_document
stringOpcional

CPF ou CNPJ do pagador.

JSON · Exemplo de payload
{  "amount": 500,  "description": "Cobrança Pix",  "payment_method": "pix",  "due_date": "2026-07-10",  "payer_name": "João da Silva",  "payer_document": "12345678909"}

Resposta

200Não publicado

O Swagger de staging declara sucesso HTTP 200, mas não publica um response_model para esta operação.

Os campos da resposta de sucesso serão documentados quando o contrato for publicado no Swagger ou validado com credenciais de staging.

Status HTTP

200

Cobrança criada com sucesso.

400

Payload inválido para a operação.

401

Credenciais ausentes, inválidas ou revogadas.

403

A credencial não possui permissão para acessar o recurso.

422

Erro de validação nos dados enviados.

429

Limite de requisições excedido.

5xx

Erro interno da plataforma.