{
  "generated_from": "hookdeck/webhook-registry",
  "registry_commit": "a24c8d9784c9e9fe937c63f76adbce108201378f",
  "registry_committed_at": "2026-11-19T08:56:09Z",
  "disclaimer": "Independent reference. Not affiliated with PayPal.",
  "vendor": "paypal",
  "event": "BILLING.SUBSCRIPTION.PAYMENT.FAILED",
  "resource": "subscription",
  "url": "https://hookdeck.com/webhooks/paypal/events#BILLING.SUBSCRIPTION.PAYMENT.FAILED",
  "description": "Subscription payment attempt fails",
  "trigger": null,
  "listed_in": "https://developer.paypal.com/api/rest/webhooks/event-names/#subscriptions",
  "confidence": "verified",
  "schema_source": "from a captured delivery",
  "identified_by": "event_type field in the body",
  "payload": {
    "provenance": "sample-repo",
    "value_realism": "real-shape-redacted-values",
    "field_count": 71,
    "key_fields": [
      {
        "path": "id",
        "type": "string",
        "example": "WH-77687562XN25889J2-8Y6T55435R66168T4"
      }
    ],
    "delivery": {
      "title": "Seen in a captured delivery",
      "content_type": "application/json",
      "headers": [
        "user-agent",
        "cal_poolstack",
        "client_pid",
        "content-type",
        "correlation-id",
        "paypal-auth-algo",
        "paypal-auth-version",
        "paypal-cert-url",
        "paypal-transmission-id",
        "paypal-transmission-time",
        "x-b3-spanid"
      ]
    },
    "body": {
      "id": "WH-77687562XN25889J2-8Y6T55435R66168T4",
      "create_time": "2019-01-01T01:20:54.000Z",
      "event_type": "BILLING.SUBSCRIPTION.PAYMENT.FAILED",
      "event_version": "1.0",
      "resource_type": "subscription",
      "resource_version": "2.0",
      "summary": "Subscription payment failed",
      "resource": {
        "id": "I-BW452GLLEP1G",
        "status": "ACTIVE",
        "status_update_time": "2018-12-10T21:20:49Z",
        "plan_id": "P-5ML4271244454362WXNWU5NQ",
        "start_time": "2018-11-01T00:00:00Z",
        "quantity": "20",
        "shipping_amount": {
          "currency_code": "USD",
          "value": "10.00"
        },
        "subscriber": {
          "name": {
            "given_name": "John",
            "surname": "Doe"
          },
          "email_address": "customer@example.com",
          "payer_id": "2J6QB8YJQSJRJ",
          "shipping_address": {
            "name": {
              "full_name": "John Doe"
            },
            "address": {
              "address_line_1": "1 Example Street",
              "address_line_2": "Suite 100",
              "admin_area_2": "San Jose",
              "admin_area_1": "CA",
              "postal_code": "95131",
              "country_code": "US"
            }
          }
        },
        "billing_info": {
          "outstanding_balance": {
            "currency_code": "USD",
            "value": "10.00"
          },
          "cycle_executions": [
            {
              "tenure_type": "TRIAL",
              "sequence": 1,
              "cycles_completed": 1,
              "cycles_remaining": 0,
              "current_pricing_scheme_version": 1
            },
            {
              "tenure_type": "REGULAR",
              "sequence": 2,
              "cycles_completed": 1,
              "cycles_remaining": 0,
              "current_pricing_scheme_version": 1
            }
          ],
          "last_payment": {
            "amount": {
              "currency_code": "USD",
              "value": "500.00"
            },
            "time": "2018-12-01T01:20:49Z"
          },
          "last_failed_payment": {
            "amount": {
              "currency_code": "USD",
              "value": "500.00"
            },
            "time": "2019-01-01T01:20:49Z",
            "reason_code": "PAYMENT_DENIED",
            "next_payment_retry_date": "2019-01-06T01:20:49Z"
          },
          "next_billing_time": "2019-01-01T00:20:49Z",
          "final_payment_time": "2020-01-01T00:20:49Z",
          "failed_payments_count": 2
        },
        "create_time": "2018-10-20T21:20:49Z",
        "update_time": "2018-12-10T21:20:49Z",
        "links": [
          {
            "href": "https://api.paypal.com/v1/billing/subscriptions/I-BW452GLLEP1G?fields=last_failed_payment",
            "rel": "self",
            "method": "GET"
          }
        ]
      },
      "links": [
        {
          "href": "https://api.paypal.com/v1/notifications/webhooks-events/WH-77687562XN25889J2-8Y6T55435R66168T4",
          "rel": "self",
          "method": "GET"
        },
        {
          "href": "https://api.paypal.com/v1/notifications/webhooks-events/WH-77687562XN25889J2-8Y6T55435R66168T4/resend",
          "rel": "resend",
          "method": "POST"
        },
        {
          "href": "https://api.paypal.com/v1/billing/subscriptions/I-BW452GLLEP1G",
          "rel": "subscription",
          "method": "GET"
        }
      ]
    }
  }
}