# Payment instrument revoked

Webhook sent when a payment instrument is revoked.

Endpoint: POST PaymentInstrumentRevoked
Version: 2.0.0
Security: signatureAuth

## Security:

  - `signatureAuth` (unknown)
    apiKey in header Signature

## Header parameters:

  - `solidgate-event-id` (string, required)
    Unique event identifier, equal to `event_id` in the body. Stays the same across redeliveries, use it to deduplicate events.

  - `solidgate-event-type` (string, required)
    Event type, equal to `event_type` in the body. Use it to route the event before parsing the body.

  - `solidgate-event-occurred-at` (string, required)
    Date and time when the event occurred, equal to `occurred_at` in the body. Use it to order events chronologically.

  - `solidgate-attempt` (integer, required)
    Delivery attempt for this event. `0` on the first delivery, greater than `0` when the event is redelivered, so you can tell a retry from a first delivery without a lookup.

## Request fields (application/json):

  - `event_id` (string, required)
    Unique event identifier. Stays the same across redeliveries, use it to deduplicate events.
    Example: c3d4e5f6-a7b8-9012-cdef-123456789012

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

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

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

  - `data.payment_instrument` (object, required)
    Represents a payment instrument stored for the customer.

  - `data.payment_instrument.id` (string, required)
    Unique payment instrument identifier.
    Example: pi_01J1Z2X3Y4W5V6U7T8S9R0

  - `data.payment_instrument.customer_id` (string, required)
    Identifier of the customer who owns the payment instrument.
    Example: cust_01KMG2ABYPF6XS5DMJQ817C429

  - `data.payment_instrument.status` (string, required)
    Payment instrument status.
The list of enum values may be extended without notice.
    Enum: "ACTIVE", "REVOKED", "EXPIRED"

  - `data.payment_instrument.recurring_token` (string, required)
    Token used to charge the payment instrument for recurring payments.
    Example: baf2ff5c5a125aeabb4b80d7b983f66f3abf5dbb8d939df48b40755674eddceee78084eab5fa9c15a339c94f1ad2b30cf299

  - `data.payment_instrument.expired_at` (string)
    Date and time when the payment instrument expired.
    Example: 2027-01-01T10:00:00.000000Z

  - `data.payment_instrument.revocation_reason` (string)
    Reason why the payment instrument was revoked.
The list of enum values may be extended without notice.
    Enum: "MERCHANT_INITIATED", "SYSTEM_INITIATED"

  - `data.payment_instrument.created_at` (string, required)
    Date and time when the payment instrument was created.
    Example: 2024-01-01T10:00:00.000000Z

  - `data.payment_instrument.updated_at` (string, required)
    Date and time when the payment instrument was updated.
    Example: 2024-01-02T15:00:00.000000Z

  - `data.payment_instrument.payment_method` (string, required)
    Payment method.
The list of enum values may be extended without notice.
    Enum: "CARD", "APPLE_PAY", "GOOGLE_PAY", "PAYPAL", "MERCADOPAGO", "MBWAY", "PIX", "PIX_AUTOMATICO", "UPI", "UPI_QR", "GCASH", "ALIPAY", "WECHATPAY", "BLIK"

  - `data.payment_instrument.card_details` (object, required)
    Card details for a payment instrument.

  - `data.payment_instrument.card_details.last_four` (string, required)
    Last four digits of the card number.
    Example: 4242

  - `data.payment_instrument.card_details.bin` (string, required)
    Bank identification number of the card.
    Example: 424242

  - `data.payment_instrument.card_details.brand` (string, required)
    Card brand.
    Example: VISA

  - `data.payment_instrument.card_details.type` (string, required)
    Card type.
    Example: DEBIT

  - `data.payment_instrument.card_details.bank` (string, required)
    Issuing bank name.
    Example: Chase Bank

  - `data.payment_instrument.card_details.expiry_month` (string, required)
    Card expiration month in MM format.
    Example: 12

  - `data.payment_instrument.card_details.expiry_year` (string, required)
    Card expiration year in YYYY format.
    Example: 2030

  - `data.payment_instrument.payment_method` (string, required)
    Payment method.
    Enum: "CARD", "APPLE_PAY", "GOOGLE_PAY", "PAYPAL", "MERCADOPAGO", "MBWAY", "PIX", "PIX_AUTOMATICO", "UPI", "UPI_QR", "GCASH", "ALIPAY", "WECHATPAY", "BLIK"

  - `data.payment_instrument.paypal_details` (object, required)
    PayPal details for a payment instrument.

  - `data.payment_instrument.paypal_details.email` (string, required)
    PayPal account email.
    Example: customer@example.com

## Response 200:

  - `200` (unknown)
    OK