Change Card PIN
Currently unavailable. This endpoint returns an error by design: cardholders must use an ATM to change their PIN. Kept in this collection for completeness; do not build against it yet — ask us before relying on it.
Path: cardId (string, required).
Body (JSON): oldPin (string, required), newPin (string, required).
Always fails: after the presence check the endpoint returns 400 with the ATM message below. No success response exists today.
All errors from this folder use
{ "status": "error", "message": "..." }and are returned as HTTP 400 (including “Card not found” — there is no 404). Success bodies usestatus: "success"(notsuccess: truelike the VTU endpoints).
Authentication
AuthorizationBearer
Access token from Generate Access Token (valid 15 minutes).
Path parameters
cardId
The card ID.
Request
This endpoint expects an object.
oldPin
newPin
Errors
400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
