v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB

PCI

Get card password

Gets card Personal Identification Number (PIN) used for authenticating purchases with Pinpads.

Notes:

This endpoint requires 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.

get/pcicards/v2/pcicards/password/{cardId}

Path parameters

cardIdstring required

Pismo card ID

Response

Response for get password request

org_idstring

Organization ID

card_idinteger

ID of card to create relationship for

correlation_idstring

The Correlation identifier field is used to link related API requests and events. The CID can help the Pismo engineering team track everything related to a call. If not passed, a random one is generated. You can find the CID in the response header.

account_idinteger

Account ID

pinstring

Card Primary Identification Number (PIN) - 4 or 6 digits

panstring

Primary Account Number (PAN) encrypted with AES/GCM/NoPadding algorithm. The ciphertext (PAN encryption result) is REQUIRED to be base64 encoded.

password_updatedboolean

Has password been updated?

Example response

{
  "org_id": "TN-cc8f8b89-233a-4582-9f36-63ee85278d6d",
  "card_id": 6743052,
  "correlation_id": "c737895c-8159-4c0c-a92a-a4f8600bff37",
  "account_id": 6912345,
  "pin": "7654",
  "pan": "/5yGTkBSoqGY+Ug5yJuHUSGk54VRMNoY0G5Ni2HSa64="
}