v1

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

Submit validation try

Submit a validation try with amount.<br>

This endpoint generates a Card on file validation result received event with PENDING status. If the verification/validation fails, a Card excluded event is generated and the card is deleted from the customer's wallet.

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

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

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.

Request body

amountnumber required

Amount to be tried (1.00 - 5.00).

datestring

Submission date. Format = dd/mm/yyyy. If not passed, the current datetime is used.

Example request

{
  "amount": 1.27,
  "date": "25/09/2021"
}

Response

No Content