Get PIN as PINblock

Get the card PIN (Personal Identification Number) as a PINblock. PINblocks are 64-bit strings that encode a PIN ready for encryption and secure transmission in banking networks.

For more information, refer to the PIN/PINBlock tutorial.

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

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Pismo card ID

Query Params
string
required

A Zone PIN Key (ZPK) identifier. The ZPK is a data encrypting or decrypting key for PIN transfer between parties. For 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.

Responses

401

Access token is missing or invalid

403

You don't have permission to access this resource

404

The specified resource was not found

409

Card PIN must not be null

500

Internal server error

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json