Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.chargefy.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Quando dispara

  • Boleto venceu sem ser compensado
  • PIX gerado expirou (janela de pagamento fechou)
Só dispara depois de checkout.session.completed ter sido emitido com payment_status: "unpaid". Cartão não passa por esse evento.

​
Ação esperada

  • Marcar pedido como falho
  • Notificar o comprador (email/SMS) que o pagamento não foi confirmado
  • data.payment_status permanece "unpaid"

​
Envelope

{
  "type": "checkout.session.async_payment_failed",
  "id": "evt_8h3K2pQ9mN4tR7vL",
  "created_at": "2026-05-13T03:00:00Z",
  "data": {
    "id": "id_111",
    "client_secret": "...",
    "url": "https://pay.chargefy.io/session/...",
    "status": "complete",
    "mode": "payment",
    "payment_status": "unpaid",
    "currency": "brl",
    "amount_total": 19990,
    "amount_subtotal": 19990,
    "amount_discount": 0,
    "amount_tax": 0,
    "organization_id": "id_222",
    "customer_id": "id_555",
    "customer_email": "nome@email.com",
    "customer_name": "Cliente",
    "customer_tax_id": "123.456.789-00",
    "success_url": "https://meusite.com/sucesso",
    "cancel_url": null,
    "allow_discount_codes": true,
    "require_billing_address": false,
    "no_fees_installments": false,
    "discount_id": null,
    "livemode": true,
    "payment_method_types": ["credit_card", "pix", "boleto"],
    "metadata": { "order_id": "ord_123" },
    "expires_at": "2026-05-04T18:31:00Z",
    "created_at": "2026-05-03T18:31:00Z",
    "line_items": [ /* ... */ ],
    "payment_data": {
      "payment_method": "boleto",
      "status": "failed",
      "pdf_url": "https://api.chargefy.io/boletos/abc123.pdf",
      "barcode": "23793.38128 60082.345678 90000.123456 7 89230000019990",
      "digitable_line": "23791234567890123456789012345678901234567890",
      "due_date": "2026-05-10T03:00:00Z"
    }
  }
}
data é o DTO completo de PublicCheckoutSession.