Adyen · Schema

Card

Card schema from Adyen API

PaymentsFinancial-ServicesFintech

Properties

Name Type Description
authentication object 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.
bin string The bank identification number (BIN) of the card number.
brand string The brand of the payment instrument. Possible values: **visa**, **mc**.
brandVariant string The brand variant of the payment instrument. >Contact your Adyen Implementation Manager to get the values that are relevant to your integration. Examples: **visadebit**, **mcprepaid**.
cardholderName string The name of the cardholder. Maximum length: 26 characters.
configuration object Settings required when creating a physical card. Reach out to your Adyen contact to get the values that you can send in this object.
cvc string The CVC2 value of the card. > The CVC2 is not sent by default. This is only returned in the `POST` response for single-use virtual cards.
deliveryContact object The delivery contact (name and address) for physical card delivery.
expiration object The expiration date of the card.
formFactor string The form factor of the card. Possible values: **virtual**, **physical**.
lastFour string Last last four digits of the card number.
number string The primary account number (PAN) of the card. > The PAN is masked by default and returned only for single-use virtual cards.
View JSON Schema on GitHub

JSON Schema

notification-webhooks-card-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/adyen/refs/heads/main/json-schema/notification-webhooks-card-schema.json",
  "title": "Card",
  "description": "Card schema from Adyen API",
  "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 payment instrument.\nPossible values: **visa**, **mc**.",
      "type": "string"
    },
    "brandVariant": {
      "description": "The brand variant of the payment instrument.\n>Contact your Adyen Implementation Manager to get the values that are relevant to your integration. Examples: **visadebit**, **mcprepaid**.",
      "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 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": {
      "description": "The delivery contact (name and address) for physical card delivery.",
      "$ref": "#/components/schemas/Contact"
    },
    "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.",
      "type": "string"
    }
  },
  "required": [
    "formFactor",
    "cardholderName",
    "brand",
    "brandVariant",
    "number"
  ],
  "type": "object"
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/notification-webhooks-card"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.