Adyen · Schema

Card

PaymentsFinancial ServicesFintech

Properties

Name Type Description
cvc string The [card verification code](https://docs.adyen.com/payments-fundamentals/payment-glossary#card-security-code-cvc-cvv-cid) (1-20 characters). Depending on the card brand, it is known also as: * CVV2/C
expiryMonth string The card expiry month. Format: 2 digits, zero-padded for single digits. For example: * 03 = March * 11 = November
expiryYear string The card expiry year. Format: 4 digits. For example: 2020
holderName string The name of the cardholder, as printed on the card.
issueNumber string The issue number of the card (for some UK debit cards only).
number string The card number (4-19 characters). Do not use any separators. When this value is returned in a response, only the last 4 digits of the card number are returned.
startMonth string The month component of the start date (for some UK debit cards only).
startYear string The year component of the start date (for some UK debit cards only).
View JSON Schema on GitHub

JSON Schema

adyen-card-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/Card",
  "title": "Card",
  "properties": {
    "cvc": {
      "description": "The [card verification code](https://docs.adyen.com/payments-fundamentals/payment-glossary#card-security-code-cvc-cvv-cid) (1-20 characters). Depending on the card brand, it is known also as:\n* CVV2/CVC2  length: 3 digits\n* CID  length: 4 digits\n> If you are using [Client-Side Encryption](https://docs.adyen.com/classic-integration/cse-integration-ecommerce), the CVC code is present in the encrypted data. You must never post the card details to the server.\n> This field must be always present in a [one-click payment request](https://docs.adyen.com/classic-integration/recurring-payments).\n> When this value is returned in a response, it is always empty because it is not stored.",
      "maxLength": 20,
      "minLength": 1,
      "type": "string"
    },
    "expiryMonth": {
      "description": "The card expiry month.\nFormat: 2 digits, zero-padded for single digits. For example:\n* 03 = March\n* 11 = November",
      "maxLength": 2,
      "minLength": 1,
      "type": "string"
    },
    "expiryYear": {
      "description": "The card expiry year.\nFormat: 4 digits. For example: 2020",
      "maxLength": 4,
      "minLength": 4,
      "type": "string"
    },
    "holderName": {
      "description": "The name of the cardholder, as printed on the card.",
      "maxLength": 50,
      "minLength": 1,
      "type": "string"
    },
    "issueNumber": {
      "description": "The issue number of the card (for some UK debit cards only).",
      "maxLength": 2,
      "minLength": 1,
      "type": "string"
    },
    "number": {
      "description": "The card number (4-19 characters). Do not use any separators.\nWhen this value is returned in a response, only the last 4 digits of the card number are returned.",
      "maxLength": 19,
      "minLength": 4,
      "type": "string"
    },
    "startMonth": {
      "description": "The month component of the start date (for some UK debit cards only).",
      "maxLength": 2,
      "minLength": 1,
      "type": "string"
    },
    "startYear": {
      "description": "The year component of the start date (for some UK debit cards only).",
      "maxLength": 4,
      "minLength": 4,
      "type": "string"
    }
  },
  "type": "object"
}