Adyen · JSON Structure

Recurring Card Structure

Card schema from Adyen API

Type: object Properties: 8
PaymentsFinancial ServicesFintech

Card is a JSON Structure definition published by Adyen, describing 8 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

cvc expiryMonth expiryYear holderName issueNumber number startMonth startYear

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/adyen/refs/heads/main/json-structure/recurring-card-structure.json",
  "description": "Card schema from Adyen API",
  "type": "object",
  "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 \u2013 length: 3 digits\n* CID \u2013 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"
    }
  },
  "name": "Card"
}