v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB

PCI

Append update PIN script

Append issuer script to update the card PIN that will be applied at the next authorization.

You must work with Pismo to pre-register a script and get its script ID. For information on generating a PINBlock and key ID, refer to the PIN/PINBlock tutorial guide.

For more information, refer to the Card scripts guide.

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

post/pcicards/v1/pcicards/{cardId}/scripts/pin-update

Path parameters

cardIdstring required

Pismo card ID

Headers

x-account-idstring required

Account ID

Request body

script_idstring required

Issuer script ID. Pismo configures a script according to your needs. Contact your Pismo representative to create a script. Once created, Pismo gives you the script ID.

pin_blockstring

New PIN encrypted as a PINblock using the Zone Pin Key (ZPK) key_id field that was pre-registered.

key_idstring

Generated key ID.

A Zone PIN Key (ZPK) identifier. The ZPK is a data encrypting or decrypting key for PIN transfer between parties. Ffor example, between issuers and processors or acquirers and networks or networks and processors, and so on.

In a sandbox environment, a fixed ZPK is used:

key_id: 7d14ca2e-1057-11ee-8cee-060f666de710

HSM key: 0404F2543B1C6E70AB61586E1304B6A7

For production, open a Jira ticket with type = Configuration. Request you need the key to use endpoints with PIN management such as PINBLOCK.

pinstring

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

Example request

{
  "script_id": "11a10bff-830b-4649-9660-1a01a5e1c192",
  "pin_block": "86FA0CED8BDD40D1",
  "key_id": "32a147ec-b2d9-4b0d-8c5b-557e6cf41e0e",
  "pin": "1234"
}

Response

Response for success append issuer scripts

card_script_idstring

ID of script added to card.

org_idstring

Organization ID

card_idinteger

ID of card to create relationship for

account_idinteger

Account ID

script_idstring

Issuer script ID. Pismo configures a script according to your needs. Contact your Pismo representative to create a script. Once created, Pismo gives you the script ID.

created_atstring

Card script creation date, format = yyyy-MM-dd'T'HH:mm:ss.SSS"

appliedboolean

Has script been applied?

Example response

{
  "card_script_id": "11a10bff-830b-4649-9660-1a01a5e1c192",
  "org_id": "TN-cc8f8b89-233a-4582-9f36-63ee85278d6d",
  "card_id": 6743052,
  "account_id": 6912345,
  "script_id": "11a10bff-830b-4649-9660-1a01a5e1c192",
  "created_at": "2021-10-16T14:09:04.549"
}