Criar Cobrança Pix
Aprenda como criar cobranças Pix via API REST da Alfasu Pay.
Crie cobranças Pix dinâmicas com QR Code e copia-e-cola. O pagador pode escanear o QR Code ou colar o código no app do banco.
Endpoint
POST /v1/pix/charges
Parâmetros
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| amount | integer | Sim | Valor em centavos (ex: 15000 = R$ 150,00) |
| description | string | Não | Descrição exibida ao pagador (máx. 140 caracteres) |
| expires_in | integer | Não | Tempo de expiração em segundos (padrão: 86400 = 24h) |
| payer.name | string | Não | Nome do pagador |
| payer.document | string | Não | CPF ou CNPJ do pagador (apenas números) |
| webhook_url | string | Não | URL para notificação de pagamento (sobrescreve a global) |
Exemplo de requisição
Exemplo de resposta
{
"id": "ch_abc123xyz",
"status": "pending",
"amount": 15000,
"description": "Pedido #1234",
"pix": {
"qr_code": "00020126580014br.gov.bcb.pix...",
"qr_code_url": "https://api.alfasupay.com.br/v1/pix/charges/ch_abc123xyz/qrcode",
"expires_at": "2025-03-16T10:00:00Z"
},
"created_at": "2025-03-15T10:00:00Z"
}
Status da cobrança
O status inicial é sempre pending. Após o pagamento, muda para paid. Cobranças não pagas expiram automaticamente.
Erros comuns
Bad Request — Parâmetros inválidos ou ausentes
Unprocessable Entity — Valor abaixo do mínimo ou documento inválido