Event Types

card.pin_updated

Occurs when a card's PIN is set, changed, unblocked, or blocked due to excessive incorrect PIN attempts.

postWebhookcard.pin_updated

Payload

event_type'card.pin_updated' required

The type of event that occurred.

card_tokenstring uuid required

The token of the card whose PIN or PIN status was updated

pin_status'OK' | 'BLOCKED' required

The card's PIN status after the update

status_reason'PIN_SET' | 'PIN_CHANGED' | 'PIN_UNBLOCKED' | 'EXCESSIVE_PIN_ATTEMPTS' required

The reason for the PIN update:

  • PIN_SET - The PIN was set for the first time; pin_status is OK
  • PIN_CHANGED - The PIN was changed, including when changing a blocked PIN; pin_status is OK
  • PIN_UNBLOCKED - The PIN was unblocked without changing it; pin_status is OK
  • EXCESSIVE_PIN_ATTEMPTS - The PIN was blocked due to excessive incorrect PIN attempts; pin_status is BLOCKED

Example payload

{
  "card_token": "4df9a19c-9e1e-40d1-b27a-05e01152ee07",
  "pin_status": "OK",
  "status_reason": "PIN_SET"
}

Response

Return a 200 status to indicate that the data was received successfully

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.