Checkout hospedado e links de pagamento

Checkout hospedado

Toda cobrança tem checkout_url: uma página nossa, rápida no celular, com QR Code, Copia e Cola, nome e CNPJ do recebedor e confirmação automática (a página atualiza sozinha quando o Pix cai). Redirecione o cliente para ela ou envie o link por WhatsApp/e-mail.

• Informe return_url (https) na criação para mostrar "Voltar para a loja" depois do pagamento.
• O endereço contém um token aleatório: trate-o como segredo da cobrança.
• O QR é gerado no nosso servidor, sem scripts de terceiros — uma defesa contra malware que troca o QR em lojas comprometidas.

Links de pagamento

Um link é uma página reutilizável (um produto, uma doação, uma inscrição). Cada pagamento gera uma cobrança nova, que aparece em Cobranças com payment_link_id e dispara os eventos de sempre.

curl -X POST "https://api.exemplo.com.br/v1/payment_links" \
  -H "Authorization: Bearer $PIX_API_KEY" -H "Idempotency-Key: $(uuidgen)" -H "Content-Type: application/json" \
  -d '{"title": "Camiseta Aurora — M", "amount": "59.90", "max_payments": 100}'

• Valor fixo (amount) ou livre entre min_amount e max_amount.
• Opcionais: max_payments, expires_at, return_url, charge_expires_in.
• Desative com POST /v1/payment_links/{id}/deactivate. Links também podem ser criados pelo painel.