card.pin_updated

webhook

card.pin_updated

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

Payload

event_type

const

enum

required

The type of event that occurred.

Allowed:

card_token

uuid

required

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

pin_status

string

enum

required

The card's PIN status after the update

Allowed:

status_reason

string

enum

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

Allowed:

Response

200

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