Skip to main content

Update a card’s PIN

PUT 
/v1/card/cards/:id/pin

Encrypt an ISO 9564-1 Format 2 PIN block under the same secret your sessionId wraps. No Idempotency-Key: the body carries the whole desired state, so repeating it converges. A timeout answers PIN_WRITE_UNCONFIRMED rather than a generic outage — read the PIN back before writing again. NOT rate-limited per card: throttling a partner’s ability to change a compromised PIN is the wrong failure to protect against.

Request​

Responses​

Success