Card

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/adyen/refs/heads/main/json-schema/configuration-card-schema.json",
  "title": "Card",
  "description": "Card schema from Adyen API",
  "type": "object",
  "properties": {
    "authentication": {
      "description": "Contains the card user's password and mobile phone number. This is required when you issue cards that can be used to make online payments within the EEA and the UK, or can be added to digital wallets. Refer to [3D Secure and digital wallets](https://docs.adyen.com/issuing/3d-secure-and-wallets) for more information.",
      "$ref": "#/components/schemas/Authentication"
    },
    "bin": {
      "description": "The bank identification number (BIN) of the card number.",
      "type": "string"
    },
    "brand": {
      "description": "The brand of the physical or the virtual card.\nPossible values: **visa**, **mc**.",
      "type": "string"
    },
    "brandVariant": {
      "description": "The brand variant of the physical or the virtual card. For example, **visadebit** or **mcprepaid**.\n>Reach out to your Adyen contact to get the values relevant for your integration.",
      "type": "string"
    },
    "cardholderName": {
      "description": "The name of the cardholder.\n Maximum length: 26 characters.",
      "maxLength": 26,
      "type": "string"
    },
    "configuration": {
      "description": "Settings required when creating a physical or a virtual card. \n\nReach out to your Adyen contact to get the values that you can send in this object.",
      "$ref": "#/components/schemas/CardConfiguration"
    },
    "cvc": {
      "description": "The CVC2 value of the card.\n> The CVC2 is not sent by default. This is only returned in the `POST` response for single-use virtual cards.",
      "type": "string"
    },
    "deliveryContact": {
      "x-addedInVersion": "2",
      "description": "The delivery contact (name and address) for physical card delivery.",
      "$ref": "#/components/schemas/DeliveryContact"
    },
    "expiration": {
      "description": "The expiration date of the card.",
      "$ref": "#/components/schemas/Expiry"
    },
    "formFactor": {
      "description": "The form factor of the card.\nPossible values: **virtual**, **physical**.",
      "enum": [
        "physical",
        "unknown",
        "virtual"
      ],
      "type": "string"
    },
    "lastFour": {
      "description": "Last last four digits of the card number.",
      "type": "string"
    },
    "number": {
      "description": "The primary account number (PAN) of the card.\n> The PAN is masked by default and returned only for single-use virtual cards.",
      "readOnly": true,
      "type": "string"
    },
    "threeDSecure": {
      "description": "Allocates a specific product range for either a physical or a virtual card. Possible values: **fullySupported**, **secureCorporate**.\n>Reach out to your Adyen contact to get the values relevant for your integration.",
      "type": "string"
    }
  },
  "required": [
    "formFactor",
    "cardholderName",
    "brand",
    "brandVariant",
    "number"
  ]
}