# Payment instrument expired

Webhook sent when a payment instrument expires.

Endpoint: POST PaymentInstrumentExpired
Version: 2.0.0
Security: signatureAuth

## Request fields (application/json):

  - `event_id` (string, required)
    Unique event identifier.
    Example: "9b40c5a1-3f7d-4e64-b8ee-21a10f9be7c5"

  - `event_type` (string, required)
    Event type.
    Enum: "PAYMENT_INSTRUMENT_EXPIRED"

  - `occurred_at` (string, required)
    Date and time when the event occurred.
    Example: "2026-04-03T16:20:11.000000Z"

  - `data` (object, required)
    Event payload containing the affected payment instrument record.

  - `data.payment_instrument` (object, required) — one of:
    Represents a payment instrument stored for the customer.
    - Card payment:
      - `id` (string, required)
        Unique payment instrument identifier.
        Example: "pi_01J1Z2X3Y4W5V6U7T8S9R0"
      - `customer_id` (string, required)
        Identifier of the customer who owns the payment instrument.
        Example: "cust_01KMG2ABYPF6XS5DMJQ817C429"
      - `status` (string, required)
        Payment instrument status.
        Enum: "ACTIVE", "REVOKED", "EXPIRED"
      - `recurring_token` (string, required)
        Token used to charge the payment instrument for recurring payments.
        Example: "baf2ff5c5a125aeabb4b80d7b983f66f3abf5dbb8d939df48b40755674eddceee78084eab5fa9c15a339c94f1ad2b30cf299"
      - `expired_at` (string)
        Date and time when the payment instrument expired.
        Example: "2027-01-01T10:00:00.000000Z"
      - `revocation_reason` (string)
        Reason why the payment instrument was revoked.
        Enum: "MERCHANT_INITIATED", "SYSTEM_INITIATED"
      - `created_at` (string, required)
        Date and time when the payment instrument was created.
        Example: "2024-01-01T10:00:00.000000Z"
      - `updated_at` (string, required)
        Date and time when the payment instrument was updated.
        Example: "2024-01-02T15:00:00.000000Z"
      - `payment_method` (string, required)
        Payment method.
        Example: "CARD"
      - `card_details` (object, required)
        Card details for a payment instrument.
      - `card_details.last_four` (string, required)
        Last four digits of the card number.
        Example: "4242"
      - `card_details.bin` (string, required)
        Bank identification number of the card.
        Example: "424242"
      - `card_details.brand` (string, required)
        Card brand.
        Example: "VISA"
      - `card_details.type` (string, required)
        Card type.
        Example: "DEBIT"
      - `card_details.bank` (string, required)
        Issuing bank name.
        Example: "Chase Bank"
      - `card_details.expiry_month` (string, required)
        Card expiration month in MM format.
        Example: "12"
      - `card_details.expiry_year` (string, required)
        Card expiration year in YYYY format.
        Example: "2030"
    - Alternative payment method:
      - `id` (string, required)
        Unique payment instrument identifier.
        Example: "pi_01J1Z2X3Y4W5V6U7T8S9R0"
      - `customer_id` (string, required)
        Identifier of the customer who owns the payment instrument.
        Example: "cust_01KMG2ABYPF6XS5DMJQ817C429"
      - `status` (string, required)
        Payment instrument status.
        Enum: same as `status` in "Card payment" (3 values)
      - `recurring_token` (string, required)
        Token used to charge the payment instrument for recurring payments.
        Example: "baf2ff5c5a125aeabb4b80d7b983f66f3abf5dbb8d939df48b40755674eddceee78084eab5fa9c15a339c94f1ad2b30cf299"
      - `expired_at` (string)
        Date and time when the payment instrument expired.
        Example: "2027-01-01T10:00:00.000000Z"
      - `revocation_reason` (string)
        Reason why the payment instrument was revoked.
        Enum: same as `revocation_reason` in "Card payment" (2 values)
      - `created_at` (string, required)
        Date and time when the payment instrument was created.
        Example: "2024-01-01T10:00:00.000000Z"
      - `updated_at` (string, required)
        Date and time when the payment instrument was updated.
        Example: "2024-01-02T15:00:00.000000Z"
      - `payment_method` (string, required)
        Payment method.
        Example: "PAYPAL"
      - `paypal_details` (object, required)
        PayPal details for a payment instrument.
      - `paypal_details.email` (string, required)
        PayPal account email.
        Example: "customer@example.com"