# Submit validation try

Submit a validation try with amount.<br>

This endpoint generates a [Card on file validation result received](https://developers.pismo.io/events/docs/cardsonfile-verification-1) event with `PENDING` status. If the verification/validation fails, a [Card excluded](https://developers.pismo.io/events/docs/cardsonfile-exclusion-1) 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.


# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Card issuing - Cards on file",
    "version": "2.0.0",
    "description": "Tokenize cards and manage digital wallets",
    "contact": {
      "name": "API Support",
      "url": "https://developers.pismo.io/support"
    },
    "license": {
      "name": "Copyright Pismo"
    }
  },
  "servers": [
    {
      "url": "https://gw-pci.pismolabs.io",
      "description": "Sandbox PCI API server for testing"
    },
    {
      "url": "https://sandbox.pismolabs.io",
      "description": "Sandbox API server for testing"
    }
  ],
  "tags": [
    {
      "name": "Validation",
      "description": "Cards on file validations"
    }
  ],
  "components": {
    "parameters": {
      "authPath": {
        "name": "Authorization",
        "in": "header",
        "schema": {
          "type": "string"
        },
        "required": true,
        "description": "Account access token. An account token is embedded with an account ID. Tokens can expire quickly, which can result in an <b>Unauthorized</b> message.\n"
      },
      "uuidPath": {
        "name": "uuid",
        "in": "path",
        "schema": {
          "type": "string"
        },
        "description": "Card UUID (token) to validate.",
        "required": true
      },
      "validationIDpath": {
        "name": "validationid",
        "in": "path",
        "schema": {
          "type": "string"
        },
        "description": "Validation UUID. This is the `uuid` field returned from [Create card validation](https://developers.pismo.io/pismo-docs/reference/create-a-new-validation-for-a-given-card)",
        "required": true
      }
    },
    "schemas": {
      "CardsOnFileErrorResponse": {
        "properties": {
          "error_code": {
            "type": "string",
            "description": "Error code"
          },
          "message": {
            "type": "string",
            "description": "Error message"
          }
        }
      },
      "TryRequestModel": {
        "type": "object",
        "required": [
          "amount"
        ],
        "properties": {
          "amount": {
            "type": "number",
            "description": "Amount to be tried (1.00 - 5.00).",
            "minimum": 1,
            "maximum": 5
          },
          "date": {
            "type": "string",
            "description": "Submission date. Format = dd/mm/yyyy. If not passed, the current datetime is used."
          }
        },
        "example": {
          "amount": 1.27,
          "date": "25/09/2021"
        }
      }
    },
    "responses": {
      "204NoContent": {
        "description": "No Content"
      },
      "400BadRequest": {
        "description": "Bad Request",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/CardsOnFileErrorResponse"
            }
          }
        }
      },
      "500InternalServer": {
        "description": "Internal server error",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/CardsOnFileErrorResponse"
            }
          }
        }
      }
    }
  },
  "paths": {
    "/cardsonfile/v2/cardsonfile/cards/{uuid}/validations/{validationid}/tries": {
      "post": {
        "summary": "Submit validation try",
        "description": "Submit a validation try with amount.<br>\n\nThis endpoint generates a [Card on file validation result received](https://developers.pismo.io/events/docs/cardsonfile-verification-1) event with `PENDING` status. If the verification/validation fails, a [Card excluded](https://developers.pismo.io/events/docs/cardsonfile-exclusion-1) event is generated and the card is deleted from the customer's wallet.\n\n**Note**: This is a PCI endpoint, use the https://gw-pci.pismolabs.io environment.\n",
        "operationId": "submit-a-validation-try",
        "tags": [
          "Validation"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/uuidPath"
          },
          {
            "$ref": "#/components/parameters/validationIDpath"
          },
          {
            "$ref": "#/components/parameters/authPath"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TryRequestModel"
              }
            }
          }
        },
        "responses": {
          "204": {
            "$ref": "#/components/responses/204NoContent"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServer"
          }
        }
      }
    }
  }
}
```