Buvei
API ReferenceCards

Update Card PIN

Rotate the PIN for a PIN-enabled card.

POST/open-api/v1/cards/{cardId}/pin

Available only when the card's BIN has supportPin: true. The new PIN must be 4 digits and cannot be all identical digits.

Path parameters

cardIdstringpathrequired

Body

newPinstringbodyrequired

4 digits. All-identical PINs like 7777 or 0000 are rejected.

Response

successboolean
cardIdstring
messagestring
Request
{
  "newPin": "5678"
}
Response
{
  "code": 0,
  "message": "SUCCESS",
  "data": {
    "success": true,
    "cardId": "cid_1234567890",
    "message": "PIN updated successfully"
  }
}