v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB

Issuer PAN/PIN

Update nominal card PAN/PIN [beta]

Update a nominal UNNUMBERED card's Primary Account Number (PAN) and, optionally, Personal Identification Number (PIN).

UNNUMBERED cards are created without a Pismo platform-generated PAN and PIN.

Notes:

To set up encryption for this endpoint, contact your Pismo representative.
This endpoint takes an account token - an access token encoded with a Pismo account ID.
This is a PCI endpoint, use the https://gw-pci.pismolabs.io environment.
This endpoint generates a Card updated event with operation_type = PAN_UPDATE.

For more information, refer to Issuer-defined PAN/PIN.

put/pcicards/v1/pcicards/cards/{cardId}/pan

Path parameters

cardIdstring required

Pismo card ID

Headers

x-customer-idinteger required

Pismo customer ID

Request body

Example request

{
  "pan": {
    "bin": "87634277",
    "data": "/5yGTkBSoqGY+Ug5yJuHUSGk54VRMNoY0G5Ni2HSa64=",
    "key_id": "5c09cda4-8153-11ed-a1eb-0242ac120002",
    "iv": "ZZ3cUcotvQeaGciyLZb1wA=="
  },
  "pin": {
    "pinblock": "4E49BF480C44A36C",
    "pin_length": "4"
  }
}

Response

Accepted