Skip to content

Manage card pin

You can retrieve and update the PIN for cards you issue.

Get card PIN

The card PIN is encrypted using the same RSA encryption pattern as sensitive card details. To retrieve a card PIN, follow the steps in Retrieve sensitive card details, then use the Get card PIN endpoint.

Update card PIN

Use the Update card PIN endpoint to change a card's PIN:

curl --request PATCH \
     --url https://api.gravv.xyz/v1/cards/<card id>/pin \
     --header 'Api-Key: <Api Key>' \
     --header 'content-type: application/json' \
     --data '
{
  "card_pin": "934829"
}
'

You will receive a response similar to this:

{
  "data": {
    "message": "Card PIN updated successfully"
  },
  "error": null
}