Update card on file

Updates a card on file - change the card name, status, or profile. You must pass the card uuid token as a body parameter to identify the card.

Fields that are not passed are not updated.

This endpoint generates a Card on file updated event. If the card status is being changed to SUSPENDED, it also generates a Card excluded event.

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…
Body Params
string
required

API-generated card token from registration. This is NOT a field you can change, but it must be passed to identify the card.

string

Card alias name. No limit.

string

Network card profile identifier or HEX color. A profile or HEX color determines a card's appearance in a mobile payment app or payment system. Issuers are responsible for configuring card profiles with the card network.

string

Any data object with key/value pairs. No limit on length.

string
enum

Card-on-file token status - ACTIVE or SUSPENDED.

Allowed:
Headers
string
required

Account token - an access token encoded with a Pismo account ID. Tokens can expire quickly, which can result in an 401 Unauthorized message.

Responses
200

SUCCESS

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