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.

This endpoint uses AES256 with the GCM mode. AES-256 GCM is an authenticated encryption mode that uses the Advanced Encryption Standard (AES) with a 256-bit key in Galois/Counter Mode (GCM) to provide both confidentiality and integrity for data. In AES, an initialization vector (IV) is a fixed-size, non-secret randomized number used alongside the secret key to jumpstart the encryption process. The caller is responsible for generating the IV. The Additional Authenticated Data (AAD) parameter used is the organization/tenant ID. AAD, in AES-GCM, is unencrypted data that is authenticated alongside the ciphertext to ensure the message's integrity and authenticity.

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.

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

Pismo card ID

Body Params

Request body

Update a card's PAN/PIN object. For cards with status UNNUMBERED.

pan
object
required

PAN update object

pin
object

PIN update object. If passed, either pinblock or pin_length is REQUIRED.

Headers
integer
required

Pismo customer ID

Responses
202

Accepted

400

Bad Request

401

Access token is missing or invalid

403

You don't have permission to access this resource

404

The specified resource was not found

406

Not accepetable

500

Internal server error

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here!