Sets a new 4-digit PIN on a physical card. Authorized for admins, holders of
the vendor_cards_manage permission, or the cardholder.
The pin parameter is required (missing → 412, from
params.require(:pin)). It must match
^\d\d\d\d$ and the card's vendor must support PIN updates; otherwise the
endpoint returns 422 with
{ "error_code": "vendor_cards/pin_not_supported" }. Vendor-side failures
return 500 with the vendor's message.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Unauthorized
Vendor card not found (or not visible to the caller).
Precondition Failed — pin parameter is missing (params.require(:pin)). Body: { "message": "param is missing or the value is empty or invalid: pin" }.
Unprocessable Entity — card does not support PIN updates or pin is not a 4-digit string. { "error_code": "vendor_cards/pin_not_supported" }.
Internal Server Error — the issuing vendor rejected the PIN change. Body carries the vendor message.