Skip to navigation

Change Card PIN

View as Markdown

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 use status: "success" (not success: true like the VTU endpoints).

Authentication

AuthorizationBearer

Access token from Generate Access Token (valid 15 minutes).

Path parameters

cardIdstringRequired
The card ID.

Request

This endpoint expects an object.
oldPinstringOptional
newPinstringOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error