Links de pagamento são a forma mais simples de receber pagamentos com o Pagozz. Crie um link, compartilhe com seu cliente, e receba via PIX.
Ciclo de vida
Criar link → Compartilhar URL → Checkout → Pagar PIX → Webhook confirma
Merchant cria o link
Via API ou painel, definindo nome, valor e configurações.
Pagador abre o link
URL pública com formulário de checkout.
Pagador preenche dados
Email, CPF e campos extras configurados pelo merchant.
QR Code PIX gerado
Sistema calcula valor final (descontos/juros) e gera cobrança PIX.
Pagamento confirmado
Webhook notifica o merchant, saldo é atualizado.
Modos de valor
| Modo | Comportamento | Validação |
|---|
fixed | Valor definido pelo merchant | amount >= 100 (R$ 1,00) |
free | Pagador escolhe o valor | Pagador informa >= R$ 1,00 |
minimum | Pagador paga pelo menos o mínimo | min_amount >= 100 |
Vencimento e penalidades
Configure vencimento com descontos por antecipação e penalidades por atraso:
| Campo | Tipo | Descrição |
|---|
due_date | date | Data de vencimento |
early_discount_type | percentage | fixed | Tipo do desconto |
early_discount_value | integer | Valor (basis points ou centavos) |
early_discount_until | date | Data limite para desconto |
late_penalty_type | percentage | fixed | Tipo da multa (aplicada uma vez) |
late_penalty_value | integer | Valor da multa |
daily_interest_type | percentage | fixed | Tipo dos juros diários |
daily_interest_value | integer | Valor dos juros por dia |
Exemplo de cálculo
Link: R$ 100,00 | Vencimento: 15/02 | Desconto: 5% até 10/02
Multa: 2% | Juros: 0,1%/dia
05/02 → R$ 100 - 5% = R$ 95,00 (desconto)
12/02 → R$ 100 = R$ 100,00 (fora do prazo de desconto)
15/02 → R$ 100 = R$ 100,00 (no vencimento)
17/02 → R$ 100 + 2% + (0,1%x2) = R$ 102,20 (2 dias de atraso)
Fórmula
final_amount = original_amount - discount_amount + penalty_amount + interest_amount
net_amount = final_amount - fee
Campos do checkout
Personalize quais informações o pagador precisa fornecer:
| Campo | Padrão | Opções |
|---|
| Email | Obrigatório | Não configurável |
| CPF | Obrigatório | Não configurável |
| Nome completo | optional | disabled, optional, required |
| CNPJ | disabled | disabled, optional, required |
| Nome da empresa | disabled | disabled, optional, required |
| Telefone | optional | disabled, optional, required |
| Endereço | disabled | disabled, optional, required |
Pós-pagamento
| Campo | Descrição |
|---|
success_redirect_url | Redirect automático após pagamento confirmado |
callback_url | Exibe botão “Voltar à loja” no checkout |
Status do link
| Status | Descrição | Checkout |
|---|
active | Aceitando pagamentos | Formulário normal |
inactive | Desativado pelo merchant | Tela “Link desativado” |
Não é possível desativar um link que possui pagamentos em processamento.
Valores e taxas
Todos os valores são em centavos:
| Campo | Descrição |
|---|
original_amount | Valor original do link |
discount_amount | Desconto por antecipação |
penalty_amount | Multa por atraso |
interest_amount | Juros por atraso |
final_amount | Valor cobrado do pagador |
fee | Taxa Pagozz (R$ 0,99 por PIX) |
net_amount | Valor líquido para o merchant |
Segurança
- Auto-pagamento bloqueado: pagador não pode ser o próprio merchant
- Pagamento duplicado: se já existe transação em processamento do mesmo pagador para o mesmo link, retorna a transação existente
- Tokens criptografados: URLs usam JWE (A256GCM), sem expiração
