🚀 VaultsPay API v1 is live. See what's new →
Payment CardsSet or Update Card PIN

Set or Update Card PIN

Used for physical cards only. Virtual cards don’t require a PIN.

POST{baseUrl}/pcs/api/v1/set-pin

Payload

AttributeTypeRequiredDescription
cardIdIntegerYesCard ID to set the PIN for.
pinString (4 digits)YesNew PIN.
confirmPinString (4 digits)YesMust match pin.
Request Example
{
  "cardId": 533,
  "pin": "2965",
  "confirmPin": "2965"
}

Response

FieldTypeDescription
messageStringConfirmation message.
pinUpdatedBooleantrue if PIN was updated.
200 — SUCCESS
{
  "data": {
    "message": "Card pin is set successfully!",
    "pinUpdated": true
  }
}