v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB

PCI

Change card password

Update a card's password (PIN).

Note: This does not change the password recorded on an embossed card's chip. If the card is configured for offline password verification, you need to change the password on the physical card. To do that, you can use a card script.

This endpoint generates a Card password changed event.

Note: This is a PCI endpoint, use the https://gw-pci.pismolabs.io environment.

put/pcicards/v2/pcicards/card/{cardId}

Path parameters

cardIdstring required

Pismo card ID

Request body

pinstring required

New card Primary Identification Number (PIN)- 4 or 6 digits.

sync_offline_pinboolean

Synchronize the offline PIN with the current online PIN value?

If true, the platform generates a script with the new online PIN, sends the script in the response to the next authorization made with a chip (contact), and generates the Card issuer script notification received event.

Default is false.

Example request

{
  "pin": "1234",
  "sync_offline_pin": true
}

Response

Response for Update password request

string required

Response for card password update request

Example response

"[:correlationId] Card updated"