Adyen · Schema

StoreDetail

StoreDetail schema from Adyen API

PaymentsFinancial-ServicesFintech

Properties

Name Type Description
address object The address of the physical store where the account holder will process payments from.
fullPhoneNumber string The phone number of the store provided as a single string. It will be handled as a landline phone. Examples: "0031 6 11 22 33 44", "+316/1122-3344", "(0031) 611223344"
logo string Store logo for payment method setup.
merchantAccount string The merchant account to which the store belongs.
merchantCategoryCode string The merchant category code (MCC) that classifies the business of the account holder.
merchantHouseNumber string Merchant house number for payment method setup.
phoneNumber object The phone number of the store.
shopperInteraction string The sales channel. Possible values: **Ecommerce**, **POS**.
splitConfigurationUUID string The unique reference for the split configuration, returned when you configure splits in your Customer Area. When this is provided, the `virtualAccount` is also required. Adyen uses the configuration a
status string The status of the store. Possible values: **Pending**, **Active**, **Inactive**, **InactiveWithModifications**, **Closed**.
store string Adyen-generated unique alphanumeric identifier (UUID) for the store, returned in the response when you create a store. Required when updating an existing store in an `/updateAccountHolder` request.
storeName string The name of the account holder's store. This value is shown in shopper statements. * Length: Between 3 to 22 characters * The following characters are *not* supported: **:;}{$#@!|<>%^*+=\\**
storeReference string Your unique identifier for the store. The Customer Area also uses this value for the store description. * Length: Between 3 to 128 characters * The following characters are *not* supported: **:;}{$#@!
virtualAccount string The account holder's `accountCode` where the split amount will be sent. Required when you provide the `splitConfigurationUUID`.
webAddress string URL of the ecommerce store.
View JSON Schema on GitHub

JSON Schema

accounts-store-detail-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/accounts-store-detail-schema.json",
  "title": "StoreDetail",
  "description": "StoreDetail schema from Adyen API",
  "type": "object",
  "properties": {
    "address": {
      "description": "The address of the physical store where the account holder will process payments from.",
      "$ref": "#/components/schemas/ViasAddress"
    },
    "fullPhoneNumber": {
      "description": "The phone number of the store provided as a single string.  It will be handled as a landline phone.\n\nExamples: \"0031 6 11 22 33 44\", \"+316/1122-3344\", \"(0031) 611223344\"",
      "type": "string"
    },
    "logo": {
      "x-addedInVersion": "5",
      "description": "Store logo for payment method setup.",
      "type": "string"
    },
    "merchantAccount": {
      "description": "The merchant account to which the store belongs.",
      "type": "string"
    },
    "merchantCategoryCode": {
      "description": "The merchant category code (MCC) that classifies the business of the account holder.",
      "type": "string"
    },
    "merchantHouseNumber": {
      "x-addedInVersion": "5",
      "description": "Merchant house number for payment method setup.",
      "type": "string"
    },
    "phoneNumber": {
      "description": "The phone number of the store.",
      "$ref": "#/components/schemas/ViasPhoneNumber"
    },
    "shopperInteraction": {
      "x-addedInVersion": "5",
      "description": "The sales channel. Possible values: **Ecommerce**, **POS**.",
      "enum": [
        "Ecommerce",
        "POS"
      ],
      "type": "string"
    },
    "splitConfigurationUUID": {
      "x-addedInVersion": "5",
      "description": "The unique reference for the split configuration, returned when you configure splits in your Customer Area. When this is provided, the `virtualAccount` is also required. Adyen uses the configuration and the `virtualAccount` to split funds between accounts in your platform.",
      "type": "string"
    },
    "status": {
      "description": "The status of the store. Possible values: **Pending**, **Active**, **Inactive**, **InactiveWithModifications**, **Closed**.",
      "enum": [
        "Active",
        "Closed",
        "Inactive",
        "InactiveWithModifications",
        "Pending"
      ],
      "type": "string"
    },
    "store": {
      "description": "Adyen-generated unique alphanumeric identifier (UUID) for the store, returned in the response when you create a store. Required when updating an existing store in an `/updateAccountHolder` request.",
      "type": "string"
    },
    "storeName": {
      "description": "The name of the account holder's store. This value is shown in shopper statements.\n\n* Length: Between 3 to 22 characters \n\n* The following characters are *not* supported: **:;}{$#@!|<>%^*+=\\\\**",
      "type": "string"
    },
    "storeReference": {
      "description": "Your unique identifier for the store. The Customer Area also uses this value for the store description.\n\n * Length: Between 3 to 128 characters\n\n* The following characters are *not* supported: **:;}{$#@!|<>%^*+=\\\\**",
      "type": "string"
    },
    "virtualAccount": {
      "x-addedInVersion": "5",
      "description": "The account holder's `accountCode` where the split amount will be sent. Required when you provide the `splitConfigurationUUID`.",
      "type": "string"
    },
    "webAddress": {
      "x-addedInVersion": "5",
      "description": "URL of the ecommerce store.",
      "type": "string"
    }
  },
  "required": [
    "merchantCategoryCode",
    "address",
    "merchantAccount"
  ]
}

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/accounts-store-detail"
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 email required.

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