PUT/
Creates or updates a personal identification number (PIN) for an existing card. Although cardholders might choose a four-, five-, or six-digit PIN if they set their PIN at an automated teller machine, they can only set a four-digit PIN using the Marqeta Set PIN widget or the create or update PIN endpoint (PUT /pins). Cardholders can update their PIN through the API regardless of its length, but the new PIN value they choose must contain four digits.
If you want to manage a card’s PIN, first create a new control token for the card by sending a POST request to /pins/controltoken, and then use that token to update the PIN. You must create a card before you can manage a PIN.
Unless PIN reveal functionality has been enabled for your program, you cannot retrieve a PIN that has previously been created. If the PIN has been forgotten, you must either update the card’s PIN or create a new card and PIN.
If you have enabled PIN reveal functionality for your program, you can send a POST request to the /pins/reveal endpoint to retrieve an existing PIN. See Reveal PIN on this page for details.
Warning
Sending a request to this endpoint requires PCI DSS compliance. You must comply with PCI DSS data security requirements if you want to store, transmit, or process sensitive card data such as the cardholder’s primary account number (PAN), personal identification number (PIN), and card expiration date.
Sending a request to this endpoint requires PCI DSS compliance. You must comply with PCI DSS data security requirements if you want to store, transmit, or process sensitive card data such as the cardholder’s primary account number (PAN), personal identification number (PIN), and card expiration date.
Request body
Sample request body
JSON