Create card on file

Create a card on file - an existing card that has been tokenized and stored in a digital wallet. The token is then used for payment transactions to avoid exposing sensitive data like the card's PAN and CVV.

Unless indicated otherwise (skip_validation = true), this endpoint generates a validation - a random transacation amount between 1.00 and 5.00 (later chargebacked) is created for the cardholder to approve, which requires them to log into an online banking account. The cardholder has up to 3 tries and 96 hours to input the correct amount. If the validation fails, the card is deleted from the wallet.

The card can be a Pismo-issued card or an external card. The card is added to the customer's digital wallet.

This endpoint generates a Card on file created event and, if skip_validation = false, a Card on file validation result received 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
boolean

Flag to skip acquirer and anti-fraud validation. Default is false.

string
required

Card alias name. No limit.

string
required

Card Verification Code (CVV) (the three numbers behind the card).

string
required

Card expiration date (mmyy)

string
required

Cardholder printed name. No limit.

string
required
length between 12 and 19

Primary Account Number (PAN) to store

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.

boolean

Default card flag. Default is false.

string

Cardholder government document number. This can be from any document that identifies the cardholder such as a Tax ID, State ID, or driver's license.

string

Card ID

boolean

Is this the issuer's card flag. Default is false.

string

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

boolean

Is card verified flag. Default is false.

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

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