Verifone · Schema

card_req

card_req from Checkout API

PaymentsPOSTerminal ManagementeCommerceFinTechPayment ProcessingOmnichannel

Properties

Name Type Description
sca_compliance_level string Strong Customer Authentication (SCA) compliance level, possible values
* NONE: No SCA required.
* WALLET: Depend on the wallet SCA mechanism. For Google Pay this means that MasterCard will
threed_secure object
authorization_type string Card Authorization Type (PRE_AUTH, FINAL_AUTH). When capture now is set to true pre-authorization transactions cannot be done.
encrypted_card string Encrypted card details
card_encryption_key_alias string Public key alias
return_url string URL belonging to the Merchant website, where the Customer would be redirected after the Checkout has been completed. If this parameter is used, the customer will be redirected after spending 10 second
View JSON Schema on GitHub

JSON Schema

checkout-api-card_req.json Raw ↑
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/verifone/refs/heads/main/json-schema/checkout-api-card_req.json",
  "title": "card_req",
  "description": "card_req from Checkout API",
  "required": [
    "sca_compliance_level",
    "threed_secure"
  ],
  "type": "object",
  "properties": {
    "sca_compliance_level": {
      "type": "string",
      "description": "Strong Customer Authentication (SCA) compliance level, possible values </br>\n     * NONE: No SCA required. </br>\n     * WALLET: Depend on the wallet SCA mechanism. For Google Pay this means that MasterCard will shift liability, Visa will not. </br>\n     * FORCE_3DS: Do an additional 3DS step regardless of whether the wallet indicates the token is SCA-compliant.",
      "enum": [
        "NONE",
        "WALLET",
        "FORCE_3DS"
      ]
    },
    "threed_secure": {
      "$ref": "#/components/schemas/threed_secure"
    },
    "authorization_type": {
      "type": "string",
      "description": "Card Authorization Type (PRE_AUTH, FINAL_AUTH).  When capture now is set to true pre-authorization transactions cannot be done.",
      "default": "FINAL_AUTH"
    },
    "encrypted_card": {
      "maxLength": 4096,
      "type": "string",
      "description": "Encrypted card details"
    },
    "card_encryption_key_alias": {
      "type": "string",
      "description": "Public key alias"
    },
    "return_url": {
      "type": "string",
      "description": "URL belonging to the Merchant website, where the Customer would be redirected after the Checkout has been completed. If this parameter is used, the customer will be redirected after spending 10 seconds on the payment confirmation page provided by Verifone in case of HPP and PAYMENT LINK transactions. For IFRAME transaction the redirect is performed right after the checkout page without passing through the payment confirmation page.   <br /> <b>Note 1:</b> The return_url accepts only securely connected URLs i.e., via https protocol. <br /> <b>Note 2:</b> The time after which redirection happens can be customized using redirect_method."
    }
  }
}