{
  "generated_from": "hookdeck/webhook-registry",
  "registry_commit": "a24c8d9784c9e9fe937c63f76adbce108201378f",
  "registry_committed_at": "2026-11-19T08:56:09Z",
  "disclaimer": "Independent reference. Not affiliated with Stripe.",
  "vendor": "stripe",
  "event": "invoice.payment_failed",
  "resource": "invoice",
  "url": "https://hookdeck.com/webhooks/stripe/events/invoice#invoice.payment_failed",
  "description": "Invoice payment fails",
  "trigger": null,
  "listed_in": "https://docs.stripe.com/api/events/types.md",
  "confidence": "documented",
  "schema_source": "official schema",
  "identified_by": "type field in the body",
  "payload": {
    "provenance": "vendor-source",
    "value_realism": "doc-example-values",
    "field_count": 190,
    "key_fields": [
      {
        "path": "data.object.id",
        "type": "string",
        "example": "in_1Pgc6tB7WZ01zgkWu9fdqL6I"
      },
      {
        "path": "data.object.status",
        "type": "string",
        "example": "draft"
      },
      {
        "path": "data.object.amount_due",
        "type": "integer",
        "example": "1000"
      },
      {
        "path": "data.object.customer",
        "type": "string",
        "example": "cus_QXg1o8vcGmoR32"
      },
      {
        "path": "data.object.created",
        "type": "integer",
        "example": "1234567890"
      }
    ],
    "delivery": {
      "title": "From Stripe docs",
      "content_type": "application/json",
      "headers": []
    },
    "body": {
      "api_version": "2026-10-28.endive",
      "created": 1234567890,
      "data": {
        "object": {
          "account_country": "US",
          "account_name": null,
          "account_tax_ids": null,
          "amount_due": 1000,
          "amount_paid": 0,
          "amount_paid_off_stripe": 0,
          "amount_remaining": 1000,
          "amount_shipping": 0,
          "application": null,
          "attempt_count": 0,
          "attempted": false,
          "auto_advance": false,
          "automatic_tax": {
            "enabled": false,
            "liability": {
              "type": "account"
            },
            "status": null,
            "disabled_reason": null,
            "provider": null
          },
          "billing_reason": "manual",
          "collection_method": "charge_automatically",
          "created": 1234567890,
          "currency": "usd",
          "custom_fields": null,
          "customer": "cus_QXg1o8vcGmoR32",
          "customer_address": {
            "city": null,
            "country": null,
            "line1": null,
            "line2": null,
            "postal_code": null,
            "state": null
          },
          "customer_email": null,
          "customer_name": null,
          "customer_phone": null,
          "customer_shipping": {},
          "customer_tax_exempt": "none",
          "customer_tax_ids": [],
          "default_payment_method": null,
          "default_source": null,
          "default_tax_rates": [],
          "description": null,
          "discounts": [],
          "due_date": 1234567890,
          "effective_at": 1234567890,
          "ending_balance": null,
          "footer": null,
          "from_invoice": {
            "action": "action",
            "invoice": "invoice"
          },
          "hosted_invoice_url": null,
          "id": "in_1Pgc6tB7WZ01zgkWu9fdqL6I",
          "invoice_pdf": null,
          "issuer": {
            "type": "self"
          },
          "last_finalization_error": {
            "type": "idempotency_error"
          },
          "latest_revision": null,
          "lines": {
            "data": [
              {
                "amount": 1000,
                "currency": "usd",
                "description": "My First Invoice Item (created for API docs)",
                "discount_amounts": [],
                "discountable": true,
                "discounts": [],
                "id": "il_1Pgc6sB7WZ01zgkWFnxLrLCq",
                "invoice": "in_1Pgc6tB7WZ01zgkWu9fdqL6I",
                "livemode": false,
                "metadata": {},
                "object": "line_item",
                "period": {
                  "end": 1721954054,
                  "start": 1721954054
                },
                "quantity": 1,
                "subscription": null,
                "pretax_credit_amounts": null,
                "taxes": null,
                "parent": {
                  "invoice_item_details": {
                    "invoice_item": "invoice_item",
                    "proration": true,
                    "proration_details": {
                      "credited_items": {
                        "invoice": "invoice",
                        "invoice_line_items": [
                          "invoice_line_items"
                        ]
                      }
                    },
                    "subscription": null
                  },
                  "subscription_item_details": {
                    "invoice_item": null,
                    "proration": true,
                    "proration_details": {
                      "credited_items": {
                        "invoice": "invoice",
                        "invoice_line_items": [
                          "invoice_line_items"
                        ]
                      }
                    },
                    "subscription": "subscription",
                    "subscription_item": "subscription_item"
                  },
                  "type": "invoice_item_details"
                },
                "pricing": {
                  "type": "price_details",
                  "unit_amount_decimal": null
                },
                "subtotal": 2060319484,
                "quantity_decimal": null
              }
            ],
            "has_more": false,
            "object": "list",
            "url": "/v1/invoices/in_1Pgc6tB7WZ01zgkWu9fdqL6I/lines"
          },
          "livemode": false,
          "metadata": {},
          "next_payment_attempt": 1234567890,
          "number": null,
          "object": "invoice",
          "on_behalf_of": null,
          "payment_settings": {
            "default_mandate": null,
            "payment_method_options": {
              "acss_debit": {},
              "bancontact": {
                "preferred_language": "fr"
              },
              "card": {
                "request_three_d_secure": null
              },
              "customer_balance": {
                "funding_type": null
              },
              "konbini": {},
              "sepa_debit": {},
              "us_bank_account": {},
              "payto": {},
              "pix": {
                "amount_includes_iof": null
              },
              "upi": {},
              "billie": {}
            },
            "payment_method_types": null
          },
          "period_end": 1234567890,
          "period_start": 1234567890,
          "post_payment_credit_notes_amount": 0,
          "pre_payment_credit_notes_amount": 0,
          "receipt_number": null,
          "rendering": {
            "amount_tax_display": null,
            "pdf": {
              "page_size": null
            },
            "template": null,
            "template_version": null
          },
          "shipping_cost": {
            "amount_subtotal": 1555417355,
            "amount_tax": 1424534716,
            "amount_total": 1117121693,
            "shipping_rate": null
          },
          "shipping_details": {},
          "starting_balance": 0,
          "statement_descriptor": null,
          "status": "draft",
          "status_transitions": {
            "finalized_at": null,
            "marked_uncollectible_at": null,
            "paid_at": null,
            "voided_at": null
          },
          "subscription": null,
          "subtotal": 1000,
          "subtotal_excluding_tax": 1000,
          "test_clock": null,
          "total": 1000,
          "total_discount_amounts": [],
          "total_excluding_tax": 1000,
          "webhooks_delivered_at": 1234567890,
          "automatically_finalizes_at": null,
          "total_pretax_credit_amounts": null,
          "total_taxes": null,
          "amount_overpaid": 149300825,
          "parent": {
            "quote_details": {
              "quote": "quote"
            },
            "subscription_details": {
              "metadata": null,
              "subscription": "subscription"
            },
            "type": "quote_details"
          },
          "customer_account": null
        }
      },
      "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
      "livemode": false,
      "object": "event",
      "pending_webhooks": 0,
      "request": {
        "id": null,
        "idempotency_key": null
      },
      "type": "invoice.payment_failed"
    }
  }
}