Adyen · JSON Structure

Configuration Card Info Structure

CardInfo schema from Adyen API

Type: object Properties: 8 Required: 4

PaymentsFinancial ServicesFintech

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

Properties

authentication brand brandVariant cardholderName configuration deliveryContact formFactor threeDSecure

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

JSON Structure

{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/adyen/refs/heads/main/json-structure/configuration-card-info-structure.json",
  "description": "CardInfo 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"
    },
    "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"
    },
    "deliveryContact": {
      "x-addedInVersion": "2",
      "description": "The delivery contact (name and address) for physical card delivery.",
      "$ref": "#/components/schemas/DeliveryContact"
    },
    "formFactor": {
      "description": "The form factor of the card.\nPossible values: **virtual**, **physical**.",
      "enum": [
        "physical",
        "unknown",
        "virtual"
      ],
      "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"
  ],
  "name": "CardInfo"
}