SumUp · Schema
Card
__Required when payment type is `card`.__ Details of the payment card.
PaymentsPoint-of-SaleCard ReadersCheckoutFintechMobile PaymentsOnline Payments
Properties
| Name | Type | Description |
|---|---|---|
| name | string | Name of the cardholder as it appears on the payment card. |
| number | string | Number of the payment card (without spaces). |
| expiry_year | string | Year from the expiration time of the payment card. Accepted formats are `YY` and `YYYY`. |
| expiry_month | string | Month from the expiration time of the payment card. Accepted format is `MM`. |
| cvv | string | Three or four-digit card verification value (security code) of the payment card. |
| zip_code | string | Required five-digit ZIP code. Applicable only to merchant users in the USA. |
| type | object |
JSON Schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "Card",
"description": "__Required when payment type is `card`.__ Details of the payment card.",
"type": "object",
"properties": {
"name": {
"description": "Name of the cardholder as it appears on the payment card.",
"type": "string",
"example": "FIRSTNAME LASTNAME",
"writeOnly": true
},
"number": {
"description": "Number of the payment card (without spaces).",
"type": "string",
"example": "1234567890123456",
"writeOnly": true
},
"expiry_year": {
"description": "Year from the expiration time of the payment card. Accepted formats are `YY` and `YYYY`.",
"type": "string",
"example": "2023",
"maxLength": 4,
"minLength": 2,
"writeOnly": true
},
"expiry_month": {
"description": "Month from the expiration time of the payment card. Accepted format is `MM`.",
"type": "string",
"enum": [
"01",
"02",
"03",
"04",
"05",
"06",
"07",
"08",
"09",
"10",
"11",
"12"
],
"writeOnly": true
},
"cvv": {
"description": "Three or four-digit card verification value (security code) of the payment card.",
"type": "string",
"example": "123",
"maxLength": 4,
"minLength": 3,
"writeOnly": true
},
"zip_code": {
"description": "Required five-digit ZIP code. Applicable only to merchant users in the USA.",
"type": "string",
"example": "12345",
"maxLength": 5,
"minLength": 5,
"writeOnly": true
},
"type": {
"$ref": "#/components/schemas/CardType"
}
},
"required": [
"name",
"number",
"expiry_month",
"expiry_year",
"cvv",
"type"
]
}
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.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/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.