Set a New PIN

Set a new PIN on the card
Set a New PIN
 last updated: 
March 31, 2022

To stay in PCI compliance, you need to tokenize the card to set a new pin. We have partnered with VGS to bring this functionality to you.

There are two steps involved in setting a new pin:
Step 1: Create a PIN Token
Step 2: Set a New PIN

Step 1: Create a PIN Token

ENDPOINT

  1. POST /v1/card/:id/pintoken

RESPONSE

  1. {
  2.     "id": "crd-8df1a028-447d-479f-8b85-8187d3eb9582",
  3.     "pinToken": "card-pin-test-6c3d8280-0698-4257-be33-fda6e3a657c6"
  4. }

Step 2: Set a New PIN 

ENDPOINT

  1. POST https://tntbevlgikb.sandbox.verygoodproxy.com/v1/card/:id/pin

Note: In LIVE mode, replace sandbox with live in the URL. Please create a ticket and solid tech support will share the LIVE vault id to include at the start of the URL.

REQUEST

  1. {
  2.     "pin": "3322",
  3.     "expiryMonth": "12",
  4.     "expiryYear": "2022",
  5.     "last4": "5275"
  6. }

RESPONSE

  1. {
  2.    "id": "crd-290d30c2-8284-490f-b2ab-6186a4275624"
  3. }