Sign in

v1

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

Get card validation

Gets a specific validation for a card

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

get/cardsonfile/v2/cardsonfile/cards/{uuid}/validations/{validationid}

Path parameters

uuidstring required

Card UUID (token) to validate.

validationidstring required

Validation UUID. This is the uuid field returned from Create card validation

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": null,
  "cancellation_date": null,
  "remaining_tries": 3,
  "tries": [
    {
      "date": "2019-08-11T12:16:00.000Z",
      "amount": 1.27
    },
    {
      "date": "2019-08-15T16:04:38.481Z",
      "amount": 4.78
    }
  ]
}