Sign in

v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB
Validation

Create card validation

Create a new invoice validation for a given tokenized card. A random transacation amount between 1.00 and 5.00 (later chargebacked) is created for the cardholder to approve, which requires logging 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.<br>

This endpoint generates a Card on file validation result received event. If the validation fails, it generates an Card excluded event.

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

post/cardsonfile/v2/cardsonfile/cards/{uuid}/validations

Path parameters

uuidstring required

Card UUID (token) to validate.

Headers

Authorizationstring required

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

Request body

type'INVOICE'

Validation type, currently only INVOICE.

expiration_hoursnumber

When validation expires since creation in hours - 96 maximum. Default is 96.

remaining_triesnumber

Maximum card validation tries - 3 tries maximum. Default is 3.

Example request

{
  "type": "INVOICE",
  "expiration_hours": 96,
  "remaining_tries": 3
}

Response

Created

type'INVOICE'

Validation type, currently, only INVOICE.

expiration_hoursnumber

Validation expiration since creation in hours. Maximum is 96

remaining_triesnumber

Maximum card validation tries. Maximum is 3.

uuidstring

Unique validation ID

status'IN_PROGRESS' | 'SUCCESS' | 'FAILED'

Validation status enum - IN_PROGRESS, SUCCESS, or FAILED

inclusion_datestring

Validation creation date in ISO 8601 format, i.e., 2019-09-04T19:09:53.881Z

expiration_datestring

Date validation expires if not validated yet in ISO 8601 format, i.e., 2019-09-08T19:09:53.881Z

activation_datestring

When validated date in ISO 8601 format, i.e., 2019-09-08T19:09:53.881Z

cancellation_datestring

Validation cancelled date, by expiration or out of remaining tries, in ISO 8601 format, i.e., 2019-09-08T19:09:53.881Z

refunded_atstring

When charge refunded in in ISO 8601 format, i.e., 2019-09-08T19:09:53.881Z

refund_idstring

Refund ID

Example response

{
  "uuid": "93ae5a79-cf47-11e9-814f-6c2b59562ec2",
  "type": "INVOICE",
  "status": "IN_PROGRESS",
  "expiration_hours": 96,
  "inclusion_date": "2019-09-04T19:09:53.881Z",
  "expiration_date": "2019-09-08T19:09:53.881Z",
  "activation_date": "2019-09-04T19:09:53.881Z",
  "cancellation_date": "2192-09-08T19:09:53.881Z",
  "remaining_tries": 3,
  "refunded_at": null,
  "refund_id": null
}