Sign in

v1

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

List card validations

Get all validations for a card currently outstanding.

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

get/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.

Response

Ok

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
  }
]