Skip to main content

​
Evento payment.intent.failed

Disparado quando uma tentativa de pagamento chega ao estado failed. data.object usa o mesmo shape de GET /v1/payment-intents/:id, com status: "failed" e last_payment_error preenchido quando houver erro público para exibir.

​
Exemplo de payload

{
  "id": "evt_456",
  "object": "event",
  "created_at": "2026-05-16T18:36:00Z",
  "data": {
    "object": {
      "id": "pi_456",
      "object": "payment_intent",
      "amount": 10528,
      "amount_capturable": 0,
      "amount_details": {
        "installment_interest": 528,
        "subtotal": 10000,
        "total": 10528
      },
      "amount_received": 0,
      "canceled_at": null,
      "cancellation_reason": null,
      "capture_method": "automatic",
      "client_secret": "pi_456_secret_def",
      "confirmation_method": "automatic",
      "created_at": "2026-05-16T18:35:58Z",
      "currency": "brl",
      "customer": "cus_123",
      "invoice": "inv_123",
      "last_payment_error": {
        "category": "issuer_declined",
        "code": "generic_decline",
        "message": "The card was declined."
      },
      "latest_charge": "ch_456",
      "livemode": true,
      "metadata": {},
      "next_action": null,
      "payment_method": "pm_123",
      "payment_method_options": {
        "credit_card": {
          "installments": {
            "amount_subtotal": 10000,
            "amount_total": 10528,
            "count": 3,
            "has_interest": true,
            "interest_amount": 528
          }
        }
      },
      "payment_method_types": ["credit_card"],
      "setup_future_usage": null,
      "status": "failed",
      "updated_at": "2026-05-16T18:36:00Z"
    }
  },
  "livemode": true,
  "organization": "org_123",
  "request": {
    "id": null
  },
  "type": "payment.intent.failed"
}

​
Campos

Veja payment.intent.succeeded para a descrição completa dos campos do payment_intent.