openapi: 3.1.0 info: version: '6' x-publicVersion: true title: Adyen Account acceptDispute Merchants API description: "This API is used for the classic integration. If you are just starting your implementation, refer to our [new integration guide](https://docs.adyen.com/marketplaces-and-platforms) instead.\n\nThe Account API provides endpoints for managing account-related entities on your platform. These related entities include account holders, accounts, bank accounts, shareholders, and verification-related documents. The management operations include actions such as creation, retrieval, updating, and deletion of them.\n\nFor more information, refer to our [documentation](https://docs.adyen.com/marketplaces-and-platforms/classic).\n## Authentication\nYour Adyen contact will provide your API credential and an API key. To connect to the API, add an `X-API-Key` header with the API key as the value, for example:\n\n ```\ncurl\n-H \"Content-Type: application/json\" \\\n-H \"X-API-Key: YOUR_API_KEY\" \\\n...\n```\n\nAlternatively, you can use the username and password to connect to the API using basic authentication. For example:\n\n```\ncurl\n-U \"ws@MarketPlace.YOUR_PLATFORM_ACCOUNT\":\"YOUR_WS_PASSWORD\" \\\n-H \"Content-Type: application/json\" \\\n...\n```\nWhen going live, you need to generate new web service user credentials to access the [live endpoints](https://docs.adyen.com/development-resources/live-endpoints).\n\n## Versioning\nThe Account API supports [versioning](https://docs.adyen.com/development-resources/versioning) using a version suffix in the endpoint URL. This suffix has the following format: \"vXX\", where XX is the version number.\n\nFor example:\n```\nhttps://cal-test.adyen.com/cal/services/Account/v6/createAccountHolder\n```" x-timestamp: '2023-05-30T15:27:20Z' termsOfService: https://www.adyen.com/legal/terms-and-conditions contact: name: Adyen Developer Experience team url: https://github.com/Adyen/adyen-openapi servers: - url: https://cal-test.adyen.com/cal/services/Account/v6 tags: - name: Merchants paths: /merchants: get: tags: - Merchants summary: Adyen Get a List of Merchant Accounts description: "Returns the list of merchant accounts that your API credential has access to. The list is grouped into pages as defined by the query parameters. \n\nTo make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions):\n* Management API—Account read" operationId: get-merchants x-sortIndex: 4 x-methodName: listMerchantAccounts security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The number of the page to fetch. name: pageNumber in: query required: false schema: format: int32 type: integer - description: The number of items to have on a page, maximum 100. The default is 10 items on a page. name: pageSize in: query required: false schema: format: int32 type: integer responses: '200': content: application/json: examples: success: $ref: '#/components/examples/get-merchants-success-200' schema: $ref: '#/components/schemas/ListMerchantResponse' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants400Example: summary: Default get-merchants 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants401Example: summary: Default get-merchants 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants403Example: summary: Default get-merchants 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants422Example: summary: Default get-merchants 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants500Example: summary: Default get-merchants 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK post: tags: - Merchants summary: Adyen Create a Merchant Account description: 'Creates a merchant account for the company account specified in the request. Use this endpoint if your integration requires it, such as Adyen for Platforms Manage. Your Adyen contact will set up your access. To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Accounts read and write' operationId: post-merchants x-sortIndex: 1 x-methodName: createMerchantAccount security: - BasicAuth: [] - ApiKeyAuth: [] requestBody: content: application/json: examples: post-merchants: $ref: '#/components/examples/post-merchants-post-merchants' schema: $ref: '#/components/schemas/CreateMerchantRequest' responses: '200': content: application/json: examples: post-merchants: $ref: '#/components/examples/post-merchants-post-merchants-200' schema: $ref: '#/components/schemas/CreateMerchantResponse' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants400Example: summary: Default post-merchants 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants401Example: summary: Default post-merchants 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants403Example: summary: Default post-merchants 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants422Example: summary: Default post-merchants 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants500Example: summary: Default post-merchants 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}: get: tags: - Merchants summary: Adyen Get a Merchant Account description: 'Returns the merchant account specified in the path. Your API credential must have access to the merchant account. To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Account read' operationId: get-merchants-merchantId x-sortIndex: 3 x-methodName: getMerchantAccount security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string responses: '200': content: application/json: examples: success: $ref: '#/components/examples/get-merchants-merchantId-success-200' schema: $ref: '#/components/schemas/Merchant' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId400Example: summary: Default get-merchants-merchantId 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId401Example: summary: Default get-merchants-merchantId 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId403Example: summary: Default get-merchants-merchantId 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId422Example: summary: Default get-merchants-merchantId 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId500Example: summary: Default get-merchants-merchantId 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/activate: post: tags: - Merchants summary: Adyen Request to Activate a Merchant Account description: 'Sends a request to activate the merchant account identified in the path. You get the result of the activation asynchronously through a [`merchant.updated`](https://docs.adyen.com/api-explorer/ManagementNotification/latest/post/merchant.updated) webhook. Once the merchant account is activated, you can start using it to accept payments and payouts. Use this endpoint if your integration requires it, such as Adyen for Platforms Manage. Your Adyen contact will set up your access. To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Accounts read and write' operationId: post-merchants-merchantId-activate x-sortIndex: 2 x-methodName: requestToActivateMerchantAccount security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/RequestActivationResponse' examples: post-merchants-merchantId-activate200Example: summary: Default post-merchants-merchantId-activate 200 response x-microcks-default: true value: companyId: '500123' merchantId: '500123' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-activate400Example: summary: Default post-merchants-merchantId-activate 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-activate401Example: summary: Default post-merchants-merchantId-activate 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-activate403Example: summary: Default post-merchants-merchantId-activate 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-activate422Example: summary: Default post-merchants-merchantId-activate 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-activate500Example: summary: Default post-merchants-merchantId-activate 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/apiCredentials: get: tags: - Merchants summary: Adyen Get a List of API Credentials description: 'Returns the list of [API credentials](https://docs.adyen.com/development-resources/api-credentials) for the merchant account. The list is grouped into pages as defined by the query parameters. To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—API credentials read and write' operationId: get-merchants-merchantId-apiCredentials x-sortIndex: 0 x-methodName: listApiCredentials security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The number of the page to fetch. name: pageNumber in: query required: false schema: format: int32 type: integer - description: The number of items to have on a page, maximum 100. The default is 10 items on a page. name: pageSize in: query required: false schema: format: int32 type: integer responses: '200': content: application/json: examples: success: $ref: '#/components/examples/get-merchants-merchantId-apiCredentials-success-200' schema: $ref: '#/components/schemas/ListMerchantApiCredentialsResponse' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-apiCredentials400Example: summary: Default get-merchants-merchantId-apiCredentials 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-apiCredentials401Example: summary: Default get-merchants-merchantId-apiCredentials 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-apiCredentials403Example: summary: Default get-merchants-merchantId-apiCredentials 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-apiCredentials422Example: summary: Default get-merchants-merchantId-apiCredentials 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-apiCredentials500Example: summary: Default get-merchants-merchantId-apiCredentials 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK post: tags: - Merchants summary: Adyen Create an API Credential description: 'Creates an [API credential](https://docs.adyen.com/development-resources/api-credentials) for the company account identified in the path. In the request, you can specify the roles and allowed origins for the new API credential. The response includes the: * [API key](https://docs.adyen.com/development-resources/api-authentication#api-key-authentication): used for API request authentication. * [Client key](https://docs.adyen.com/development-resources/client-side-authentication#how-it-works): public key used for client-side authentication. * [Username and password](https://docs.adyen.com/development-resources/api-authentication#using-basic-authentication): used for basic authentication. > Make sure you store the API key securely in your system. You won''t be able to retrieve it later. If your API key is lost or compromised, you need to [generate a new API key](https://docs.adyen.com/api-explorer/#/ManagementService/v1/post/merchants/{merchantId}/apiCredentials/{apiCredentialId}/generateApiKey). To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—API credentials read and write' operationId: post-merchants-merchantId-apiCredentials x-sortIndex: 0 x-methodName: createApiCredential security: - BasicAuth: [] - ApiKeyAuth: [] requestBody: content: application/json: examples: post-merchant-credential: $ref: '#/components/examples/post-merchants-merchantId-apiCredentials-post-merchant-credential' schema: $ref: '#/components/schemas/CreateMerchantApiCredentialRequest' parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string responses: '200': content: application/json: examples: post-merchant-credential: $ref: '#/components/examples/post-merchants-merchantId-apiCredentials-post-merchant-credential-200' schema: $ref: '#/components/schemas/CreateApiCredentialResponse' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-apiCredentials400Example: summary: Default post-merchants-merchantId-apiCredentials 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-apiCredentials401Example: summary: Default post-merchants-merchantId-apiCredentials 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-apiCredentials403Example: summary: Default post-merchants-merchantId-apiCredentials 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-apiCredentials422Example: summary: Default post-merchants-merchantId-apiCredentials 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-apiCredentials500Example: summary: Default post-merchants-merchantId-apiCredentials 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/apiCredentials/{apiCredentialId}: get: tags: - Merchants summary: Adyen Get an API Credential description: 'Returns the [API credential](https://docs.adyen.com/development-resources/api-credentials) identified in the path. To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—API credentials read and write' operationId: get-merchants-merchantId-apiCredentials-apiCredentialId x-sortIndex: 0 x-methodName: getApiCredential security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: Unique identifier of the API credential. name: apiCredentialId in: path required: true schema: type: string responses: '200': content: application/json: examples: success: $ref: '#/components/examples/get-merchants-merchantId-apiCredentials-apiCredentialId-success-200' schema: $ref: '#/components/schemas/ApiCredential' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-apiCredentials-apiCredentialId400Example: summary: Default get-merchants-merchantId-apiCredentials-apiCredentialId 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-apiCredentials-apiCredentialId401Example: summary: Default get-merchants-merchantId-apiCredentials-apiCredentialId 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-apiCredentials-apiCredentialId403Example: summary: Default get-merchants-merchantId-apiCredentials-apiCredentialId 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-apiCredentials-apiCredentialId422Example: summary: Default get-merchants-merchantId-apiCredentials-apiCredentialId 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-apiCredentials-apiCredentialId500Example: summary: Default get-merchants-merchantId-apiCredentials-apiCredentialId 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK patch: tags: - Merchants summary: Adyen Update an API Credential description: "Changes the API credential's roles, or allowed origins. The request has the new values for the fields you want to change. The response contains the full updated API credential, including the new values from the request. \n\nTo make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions):\n* Management API—API credentials read and write" operationId: patch-merchants-merchantId-apiCredentials-apiCredentialId x-sortIndex: 0 x-methodName: updateApiCredential security: - BasicAuth: [] - ApiKeyAuth: [] requestBody: content: application/json: examples: patch-merchant-credential: $ref: '#/components/examples/patch-merchants-merchantId-apiCredentials-apiCredentialId-patch-merchant-credential' schema: $ref: '#/components/schemas/UpdateMerchantApiCredentialRequest' parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: Unique identifier of the API credential. name: apiCredentialId in: path required: true schema: type: string responses: '200': content: application/json: examples: patch-merchant-credential: $ref: '#/components/examples/patch-merchants-merchantId-apiCredentials-apiCredentialId-patch-merchant-credential-200' schema: $ref: '#/components/schemas/ApiCredential' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-apiCredentials-apiCredentialId400Example: summary: Default patch-merchants-merchantId-apiCredentials-apiCredentialId 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-apiCredentials-apiCredentialId401Example: summary: Default patch-merchants-merchantId-apiCredentials-apiCredentialId 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-apiCredentials-apiCredentialId403Example: summary: Default patch-merchants-merchantId-apiCredentials-apiCredentialId 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-apiCredentials-apiCredentialId422Example: summary: Default patch-merchants-merchantId-apiCredentials-apiCredentialId 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-apiCredentials-apiCredentialId500Example: summary: Default patch-merchants-merchantId-apiCredentials-apiCredentialId 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/apiCredentials/{apiCredentialId}/allowedOrigins: get: tags: - Merchants summary: Adyen Get a List of Allowed Origins description: 'Returns the list of [allowed origins](https://docs.adyen.com/development-resources/client-side-authentication#allowed-origins) for the API credential identified in the path. To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—API credentials read and write' operationId: get-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins x-sortIndex: 0 x-methodName: listAllowedOrigins security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: Unique identifier of the API credential. name: apiCredentialId in: path required: true schema: type: string responses: '200': content: application/json: examples: get-allowed-origin: $ref: '#/components/examples/get-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-get-allowed-origin-200' schema: $ref: '#/components/schemas/AllowedOriginsResponse' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins400Example: summary: Default get-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins401Example: summary: Default get-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins403Example: summary: Default get-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins422Example: summary: Default get-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins500Example: summary: Default get-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK post: tags: - Merchants summary: Adyen Create an Allowed Origin description: 'Adds a new [allowed origin](https://docs.adyen.com/development-resources/client-side-authentication#allowed-origins) to the API credential''s list of allowed origins. To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—API credentials read and write' operationId: post-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins x-sortIndex: 0 x-methodName: createAllowedOrigin security: - BasicAuth: [] - ApiKeyAuth: [] requestBody: content: application/json: examples: add-allowed-origin: $ref: '#/components/examples/post-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-add-allowed-origin' schema: $ref: '#/components/schemas/AllowedOrigin' parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: Unique identifier of the API credential. name: apiCredentialId in: path required: true schema: type: string responses: '200': content: application/json: examples: add-allowed-origin: $ref: '#/components/examples/post-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-add-allowed-origin-200' schema: $ref: '#/components/schemas/AllowedOriginsResponse' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins400Example: summary: Default post-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins401Example: summary: Default post-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins403Example: summary: Default post-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins422Example: summary: Default post-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins500Example: summary: Default post-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/apiCredentials/{apiCredentialId}/allowedOrigins/{originId}: delete: tags: - Merchants summary: Adyen Delete an Allowed Origin description: 'Removes the [allowed origin](https://docs.adyen.com/development-resources/client-side-authentication#allowed-origins) identified in the path. As soon as an allowed origin is removed, we no longer accept client-side requests from that domain. To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—API credentials read and write' operationId: delete-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-originId x-sortIndex: 0 x-methodName: deleteAllowedOrigin security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: Unique identifier of the API credential. name: apiCredentialId in: path required: true schema: type: string - description: Unique identifier of the allowed origin. name: originId in: path required: true schema: type: string responses: '204': description: 'No Content - look at the actual response code for the status of the request. ' '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: delete-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-originId400Example: summary: Default delete-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-originId 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: delete-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-originId401Example: summary: Default delete-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-originId 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: delete-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-originId403Example: summary: Default delete-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-originId 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: delete-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-originId422Example: summary: Default delete-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-originId 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: delete-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-originId500Example: summary: Default delete-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-originId 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK get: tags: - Merchants summary: Adyen Get an Allowed Origin description: 'Returns the [allowed origin](https://docs.adyen.com/development-resources/client-side-authentication#allowed-origins) identified in the path. To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—API credentials read and write' operationId: get-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-originId x-sortIndex: 0 x-methodName: getAllowedOrigin security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: Unique identifier of the API credential. name: apiCredentialId in: path required: true schema: type: string - description: Unique identifier of the allowed origin. name: originId in: path required: true schema: type: string responses: '200': content: application/json: examples: get-allowed-origins: $ref: '#/components/examples/get-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-originId-get-allowed-origins-200' schema: $ref: '#/components/schemas/AllowedOrigin' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-originId400Example: summary: Default get-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-originId 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-originId401Example: summary: Default get-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-originId 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-originId403Example: summary: Default get-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-originId 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-originId422Example: summary: Default get-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-originId 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-originId500Example: summary: Default get-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-originId 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/apiCredentials/{apiCredentialId}/generateApiKey: post: tags: - Merchants summary: Adyen Generate New API Key description: 'Returns a new API key for the API credential. You can use the new API key a few minutes after generating it. The old API key stops working 24 hours after generating a new one. To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—API credentials read and write' operationId: post-merchants-merchantId-apiCredentials-apiCredentialId-generateApiKey x-sortIndex: 0 x-methodName: generateNewApiKey security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: Unique identifier of the API credential. name: apiCredentialId in: path required: true schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/GenerateApiKeyResponse' examples: post-merchants-merchantId-apiCredentials-apiCredentialId-generateApiKey200Example: summary: Default post-merchants-merchantId-apiCredentials-apiCredentialId-generateApiKey 200 response x-microcks-default: true value: apiKey: example_value description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-apiCredentials-apiCredentialId-generateApiKey400Example: summary: Default post-merchants-merchantId-apiCredentials-apiCredentialId-generateApiKey 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-apiCredentials-apiCredentialId-generateApiKey401Example: summary: Default post-merchants-merchantId-apiCredentials-apiCredentialId-generateApiKey 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-apiCredentials-apiCredentialId-generateApiKey403Example: summary: Default post-merchants-merchantId-apiCredentials-apiCredentialId-generateApiKey 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-apiCredentials-apiCredentialId-generateApiKey422Example: summary: Default post-merchants-merchantId-apiCredentials-apiCredentialId-generateApiKey 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-apiCredentials-apiCredentialId-generateApiKey500Example: summary: Default post-merchants-merchantId-apiCredentials-apiCredentialId-generateApiKey 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/apiCredentials/{apiCredentialId}/generateClientKey: post: tags: - Merchants summary: Adyen Generate New Client Key description: 'Returns a new [client key](https://docs.adyen.com/development-resources/client-side-authentication#how-it-works) for the API credential identified in the path. You can use the new client key a few minutes after generating it. The old client key stops working 24 hours after generating a new one. To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—API credentials read and write' operationId: post-merchants-merchantId-apiCredentials-apiCredentialId-generateClientKey x-sortIndex: 0 x-methodName: generateNewClientKey security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: Unique identifier of the API credential. name: apiCredentialId in: path required: true schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/GenerateClientKeyResponse' examples: post-merchants-merchantId-apiCredentials-apiCredentialId-generateClientKey200Example: summary: Default post-merchants-merchantId-apiCredentials-apiCredentialId-generateClientKey 200 response x-microcks-default: true value: clientKey: example_value description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-apiCredentials-apiCredentialId-generateClientKey400Example: summary: Default post-merchants-merchantId-apiCredentials-apiCredentialId-generateClientKey 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-apiCredentials-apiCredentialId-generateClientKey401Example: summary: Default post-merchants-merchantId-apiCredentials-apiCredentialId-generateClientKey 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-apiCredentials-apiCredentialId-generateClientKey403Example: summary: Default post-merchants-merchantId-apiCredentials-apiCredentialId-generateClientKey 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-apiCredentials-apiCredentialId-generateClientKey422Example: summary: Default post-merchants-merchantId-apiCredentials-apiCredentialId-generateClientKey 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-apiCredentials-apiCredentialId-generateClientKey500Example: summary: Default post-merchants-merchantId-apiCredentials-apiCredentialId-generateClientKey 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/billingEntities: get: tags: - Merchants summary: Adyen Get a List of Billing Entities description: 'Returns the billing entities of the merchant account identified in the path. A billing entity is a legal entity where we charge orders to. An order for terminal products must contain the ID of a billing entity. To make this request, your API credential must have one of the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Terminal ordering read * Management API—Terminal ordering read and write' operationId: get-merchants-merchantId-billingEntities x-sortIndex: 3 x-methodName: listBillingEntities security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The name of the billing entity. name: name in: query required: false schema: type: string responses: '200': content: application/json: examples: success: $ref: '#/components/examples/get-merchants-merchantId-billingEntities-success-200' schema: $ref: '#/components/schemas/BillingEntitiesResponse' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-billingEntities400Example: summary: Default get-merchants-merchantId-billingEntities 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-billingEntities401Example: summary: Default get-merchants-merchantId-billingEntities 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-billingEntities403Example: summary: Default get-merchants-merchantId-billingEntities 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-billingEntities422Example: summary: Default get-merchants-merchantId-billingEntities 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-billingEntities500Example: summary: Default get-merchants-merchantId-billingEntities 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/paymentMethodSettings: get: tags: - Merchants summary: Adyen Get All Payment Methods description: 'Returns details for all payment methods of the merchant account identified in the path. To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Payment methods read ' operationId: get-merchants-merchantId-paymentMethodSettings x-sortIndex: 2 x-methodName: getAllPaymentMethods security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The unique identifier of the store for which to return the payment methods. name: storeId in: query required: false schema: type: string - description: The unique identifier of the Business Line for which to return the payment methods. name: businessLineId in: query required: false schema: type: string - description: The number of items to have on a page, maximum 100. The default is 10 items on a page. name: pageSize in: query required: false schema: format: int32 type: integer - description: The number of the page to fetch. name: pageNumber in: query required: false schema: format: int32 type: integer responses: '200': content: application/json: schema: $ref: '#/components/schemas/PaymentMethodResponse' examples: get-merchants-merchantId-paymentMethodSettings200Example: summary: Default get-merchants-merchantId-paymentMethodSettings 200 response x-microcks-default: true value: _links: https://example.com/resource data: - example_value itemsTotal: 500 pagesTotal: 500 typesWithErrors: - afterpaytouch description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-paymentMethodSettings400Example: summary: Default get-merchants-merchantId-paymentMethodSettings 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-paymentMethodSettings401Example: summary: Default get-merchants-merchantId-paymentMethodSettings 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-paymentMethodSettings403Example: summary: Default get-merchants-merchantId-paymentMethodSettings 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-paymentMethodSettings422Example: summary: Default get-merchants-merchantId-paymentMethodSettings 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-paymentMethodSettings500Example: summary: Default get-merchants-merchantId-paymentMethodSettings 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK post: tags: - Merchants summary: Adyen Request a Payment Method description: 'Sends a request to add a new payment method to the merchant account identified in the path. To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Payment methods read and write ' operationId: post-merchants-merchantId-paymentMethodSettings x-sortIndex: 1 x-methodName: requestPaymentMethod security: - BasicAuth: [] - ApiKeyAuth: [] requestBody: content: application/json: examples: 01.add-payment-method-visa: $ref: '#/components/examples/post-merchants-merchantId-paymentMethodSettings-01.add-payment-method-visa' 02.add-payment-method-partner-model: $ref: '#/components/examples/post-merchants-merchantId-paymentMethodSettings-02.add-payment-method-partner-model' schema: $ref: '#/components/schemas/PaymentMethodSetupInfo' parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string responses: '200': content: application/json: examples: 01.add-payment-method-visa: $ref: '#/components/examples/post-merchants-merchantId-paymentMethodSettings-01.add-payment-method-visa-200' 02.add-payment-method-partner-model: $ref: '#/components/examples/post-merchants-merchantId-paymentMethodSettings-02.add-payment-method-partner-model-200' schema: $ref: '#/components/schemas/PaymentMethod' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-paymentMethodSettings400Example: summary: Default post-merchants-merchantId-paymentMethodSettings 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-paymentMethodSettings401Example: summary: Default post-merchants-merchantId-paymentMethodSettings 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-paymentMethodSettings403Example: summary: Default post-merchants-merchantId-paymentMethodSettings 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-paymentMethodSettings422Example: summary: Default post-merchants-merchantId-paymentMethodSettings 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-paymentMethodSettings500Example: summary: Default post-merchants-merchantId-paymentMethodSettings 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/paymentMethodSettings/{paymentMethodId}: get: tags: - Merchants summary: Adyen Get Payment Method Details description: 'Returns details for the merchant account and the payment method identified in the path. To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Payment methods read ' operationId: get-merchants-merchantId-paymentMethodSettings-paymentMethodId x-sortIndex: 3 x-methodName: getPaymentMethodDetails security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The unique identifier of the payment method. name: paymentMethodId in: path required: true schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/PaymentMethod' examples: get-merchants-merchantId-paymentMethodSettings-paymentMethodId200Example: summary: Default get-merchants-merchantId-paymentMethodSettings-paymentMethodId 200 response x-microcks-default: true value: afterpayTouch: example_value allowed: true applePay: example_value bcmc: example_value businessLineId: '500123' cartesBancaires: example_value clearpay: example_value countries: - example_value cup: example_value currencies: - example_value customRoutingFlags: - example_value diners: example_value discover: example_value eftpos_australia: example_value enabled: true giroPay: example_value girocard: example_value googlePay: example_value id: '500123' ideal: example_value interac_card: example_value jcb: example_value klarna: example_value maestro: example_value mc: example_value mealVoucher_FR: example_value paypal: example_value reference: REF-001 shopperInteraction: example_value sofort: example_value storeIds: - example_value swish: example_value twint: example_value type: standard verificationStatus: valid vipps: example_value visa: example_value description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-paymentMethodSettings-paymentMethodId400Example: summary: Default get-merchants-merchantId-paymentMethodSettings-paymentMethodId 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-paymentMethodSettings-paymentMethodId401Example: summary: Default get-merchants-merchantId-paymentMethodSettings-paymentMethodId 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-paymentMethodSettings-paymentMethodId403Example: summary: Default get-merchants-merchantId-paymentMethodSettings-paymentMethodId 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-paymentMethodSettings-paymentMethodId422Example: summary: Default get-merchants-merchantId-paymentMethodSettings-paymentMethodId 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-paymentMethodSettings-paymentMethodId500Example: summary: Default get-merchants-merchantId-paymentMethodSettings-paymentMethodId 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK patch: tags: - Merchants summary: Adyen Update a Payment Method description: 'Updates payment method details for the merchant account and the payment method identified in the path. To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Payment methods read and write ' operationId: patch-merchants-merchantId-paymentMethodSettings-paymentMethodId x-sortIndex: 4 x-methodName: updatePaymentMethod security: - BasicAuth: [] - ApiKeyAuth: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdatePaymentMethodInfo' parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The unique identifier of the payment method. name: paymentMethodId in: path required: true schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/PaymentMethod' examples: patch-merchants-merchantId-paymentMethodSettings-paymentMethodId200Example: summary: Default patch-merchants-merchantId-paymentMethodSettings-paymentMethodId 200 response x-microcks-default: true value: afterpayTouch: example_value allowed: true applePay: example_value bcmc: example_value businessLineId: '500123' cartesBancaires: example_value clearpay: example_value countries: - example_value cup: example_value currencies: - example_value customRoutingFlags: - example_value diners: example_value discover: example_value eftpos_australia: example_value enabled: true giroPay: example_value girocard: example_value googlePay: example_value id: '500123' ideal: example_value interac_card: example_value jcb: example_value klarna: example_value maestro: example_value mc: example_value mealVoucher_FR: example_value paypal: example_value reference: REF-001 shopperInteraction: example_value sofort: example_value storeIds: - example_value swish: example_value twint: example_value type: standard verificationStatus: valid vipps: example_value visa: example_value description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-paymentMethodSettings-paymentMethodId400Example: summary: Default patch-merchants-merchantId-paymentMethodSettings-paymentMethodId 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-paymentMethodSettings-paymentMethodId401Example: summary: Default patch-merchants-merchantId-paymentMethodSettings-paymentMethodId 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-paymentMethodSettings-paymentMethodId403Example: summary: Default patch-merchants-merchantId-paymentMethodSettings-paymentMethodId 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-paymentMethodSettings-paymentMethodId422Example: summary: Default patch-merchants-merchantId-paymentMethodSettings-paymentMethodId 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-paymentMethodSettings-paymentMethodId500Example: summary: Default patch-merchants-merchantId-paymentMethodSettings-paymentMethodId 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/paymentMethodSettings/{paymentMethodId}/addApplePayDomains: post: tags: - Merchants summary: Adyen Add an Apple Pay Domain description: 'Adds the new domain to the list of Apple Pay domains that are registered with the merchant account and the payment method identified in the path. For more information, see [Apple Pay documentation](https://docs.adyen.com/payment-methods/apple-pay/enable-apple-pay#register-merchant-domain). To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Payment methods read and write ' operationId: post-merchants-merchantId-paymentMethodSettings-paymentMethodId-addApplePayDomains x-sortIndex: 5 x-methodName: addApplePayDomain security: - BasicAuth: [] - ApiKeyAuth: [] requestBody: content: application/json: examples: add-applepay-domain: $ref: '#/components/examples/post-merchants-merchantId-paymentMethodSettings-paymentMethodId-addApplePayDomains-add-applepay-domain' schema: $ref: '#/components/schemas/ApplePayInfo' parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The unique identifier of the payment method. name: paymentMethodId in: path required: true schema: type: string responses: '204': description: 'No Content - look at the actual response code for the status of the request. ' '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-paymentMethodSettings-paymentMethodId-addApplePayDomains400Example: summary: Default post-merchants-merchantId-paymentMethodSettings-paymentMethodId-addApplePayDomains 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-paymentMethodSettings-paymentMethodId-addApplePayDomains401Example: summary: Default post-merchants-merchantId-paymentMethodSettings-paymentMethodId-addApplePayDomains 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-paymentMethodSettings-paymentMethodId-addApplePayDomains403Example: summary: Default post-merchants-merchantId-paymentMethodSettings-paymentMethodId-addApplePayDomains 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-paymentMethodSettings-paymentMethodId-addApplePayDomains422Example: summary: Default post-merchants-merchantId-paymentMethodSettings-paymentMethodId-addApplePayDomains 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-paymentMethodSettings-paymentMethodId-addApplePayDomains500Example: summary: Default post-merchants-merchantId-paymentMethodSettings-paymentMethodId-addApplePayDomains 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/paymentMethodSettings/{paymentMethodId}/getApplePayDomains: get: tags: - Merchants summary: Adyen Get Apple Pay Domains description: 'Returns all Apple Pay domains that are registered with the merchant account and the payment method identified in the path. For more information, see [Apple Pay documentation](https://docs.adyen.com/payment-methods/apple-pay/enable-apple-pay#register-merchant-domain). To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Payment methods read ' operationId: get-merchants-merchantId-paymentMethodSettings-paymentMethodId-getApplePayDomains x-sortIndex: 6 x-methodName: getApplePayDomains security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The unique identifier of the payment method. name: paymentMethodId in: path required: true schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/ApplePayInfo' examples: get-merchants-merchantId-paymentMethodSettings-paymentMethodId-getApplePayDomains200Example: summary: Default get-merchants-merchantId-paymentMethodSettings-paymentMethodId-getApplePayDomains 200 response x-microcks-default: true value: domains: - example_value description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-paymentMethodSettings-paymentMethodId-getApplePayDomains400Example: summary: Default get-merchants-merchantId-paymentMethodSettings-paymentMethodId-getApplePayDomains 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-paymentMethodSettings-paymentMethodId-getApplePayDomains401Example: summary: Default get-merchants-merchantId-paymentMethodSettings-paymentMethodId-getApplePayDomains 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-paymentMethodSettings-paymentMethodId-getApplePayDomains403Example: summary: Default get-merchants-merchantId-paymentMethodSettings-paymentMethodId-getApplePayDomains 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-paymentMethodSettings-paymentMethodId-getApplePayDomains422Example: summary: Default get-merchants-merchantId-paymentMethodSettings-paymentMethodId-getApplePayDomains 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-paymentMethodSettings-paymentMethodId-getApplePayDomains500Example: summary: Default get-merchants-merchantId-paymentMethodSettings-paymentMethodId-getApplePayDomains 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/payoutSettings: get: tags: - Merchants summary: Adyen Get a List of Payout Settings description: 'Returns the list of payout settings for the merchant account identified in the path. Use this endpoint if your integration requires it, such as Adyen for Platforms Manage. Your Adyen contact will set up your access. To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Payout account settings read' operationId: get-merchants-merchantId-payoutSettings x-sortIndex: 3 x-methodName: listPayoutSettings security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/PayoutSettingsResponse' examples: get-merchants-merchantId-payoutSettings200Example: summary: Default get-merchants-merchantId-payoutSettings 200 response x-microcks-default: true value: data: - example_value description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-payoutSettings400Example: summary: Default get-merchants-merchantId-payoutSettings 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-payoutSettings401Example: summary: Default get-merchants-merchantId-payoutSettings 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-payoutSettings403Example: summary: Default get-merchants-merchantId-payoutSettings 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-payoutSettings422Example: summary: Default get-merchants-merchantId-payoutSettings 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-payoutSettings500Example: summary: Default get-merchants-merchantId-payoutSettings 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK post: tags: - Merchants summary: Adyen Add a Payout Setting description: 'Sends a request to add a payout setting for the merchant account specified in the path. A payout setting links the merchant account to the [transfer instrument](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/transferInstruments) that contains the details of the payout bank account. Adyen verifies the bank account before allowing and enabling the payout setting. If you''re accepting payments in multiple currencies, you may add multiple payout settings for the merchant account. Use this endpoint if your integration requires it, such as Adyen for Platforms Manage. Your Adyen contact will set up your access. To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Payout account settings read and write' operationId: post-merchants-merchantId-payoutSettings x-sortIndex: 1 x-methodName: addPayoutSetting security: - BasicAuth: [] - ApiKeyAuth: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/PayoutSettingsRequest' parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/PayoutSettings' examples: post-merchants-merchantId-payoutSettings200Example: summary: Default post-merchants-merchantId-payoutSettings 200 response x-microcks-default: true value: allowed: true enabled: true enabledFromDate: example_value id: '500123' priority: first transferInstrumentId: '500123' verificationStatus: invalid description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-payoutSettings400Example: summary: Default post-merchants-merchantId-payoutSettings 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-payoutSettings401Example: summary: Default post-merchants-merchantId-payoutSettings 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-payoutSettings403Example: summary: Default post-merchants-merchantId-payoutSettings 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-payoutSettings422Example: summary: Default post-merchants-merchantId-payoutSettings 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-payoutSettings500Example: summary: Default post-merchants-merchantId-payoutSettings 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/payoutSettings/{payoutSettingsId}: delete: tags: - Merchants summary: Adyen Delete a Payout Setting description: 'Deletes the payout setting identified in the path. Use this endpoint if your integration requires it, such as Adyen for Platforms Manage. Your Adyen contact will set up your access. To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Payout account settings read and write' operationId: delete-merchants-merchantId-payoutSettings-payoutSettingsId x-sortIndex: 5 x-methodName: deletePayoutSetting security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The unique identifier of the payout setting. name: payoutSettingsId in: path required: true schema: type: string responses: '204': description: 'No Content - look at the actual response code for the status of the request. ' '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: delete-merchants-merchantId-payoutSettings-payoutSettingsId400Example: summary: Default delete-merchants-merchantId-payoutSettings-payoutSettingsId 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: delete-merchants-merchantId-payoutSettings-payoutSettingsId401Example: summary: Default delete-merchants-merchantId-payoutSettings-payoutSettingsId 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: delete-merchants-merchantId-payoutSettings-payoutSettingsId403Example: summary: Default delete-merchants-merchantId-payoutSettings-payoutSettingsId 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: delete-merchants-merchantId-payoutSettings-payoutSettingsId422Example: summary: Default delete-merchants-merchantId-payoutSettings-payoutSettingsId 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: delete-merchants-merchantId-payoutSettings-payoutSettingsId500Example: summary: Default delete-merchants-merchantId-payoutSettings-payoutSettingsId 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK get: tags: - Merchants summary: Adyen Get a Payout Setting description: 'Returns the payout setting identified in the path. Use this endpoint if your integration requires it, such as Adyen for Platforms Manage. Your Adyen contact will set up your access. To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Payout account settings read' operationId: get-merchants-merchantId-payoutSettings-payoutSettingsId x-sortIndex: 4 x-methodName: getPayoutSetting security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The unique identifier of the payout setting. name: payoutSettingsId in: path required: true schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/PayoutSettings' examples: get-merchants-merchantId-payoutSettings-payoutSettingsId200Example: summary: Default get-merchants-merchantId-payoutSettings-payoutSettingsId 200 response x-microcks-default: true value: allowed: true enabled: true enabledFromDate: example_value id: '500123' priority: first transferInstrumentId: '500123' verificationStatus: invalid description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-payoutSettings-payoutSettingsId400Example: summary: Default get-merchants-merchantId-payoutSettings-payoutSettingsId 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-payoutSettings-payoutSettingsId401Example: summary: Default get-merchants-merchantId-payoutSettings-payoutSettingsId 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-payoutSettings-payoutSettingsId403Example: summary: Default get-merchants-merchantId-payoutSettings-payoutSettingsId 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-payoutSettings-payoutSettingsId422Example: summary: Default get-merchants-merchantId-payoutSettings-payoutSettingsId 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-payoutSettings-payoutSettingsId500Example: summary: Default get-merchants-merchantId-payoutSettings-payoutSettingsId 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK patch: tags: - Merchants summary: Adyen Update a Payout Setting description: 'Updates the payout setting identified in the path. You can enable or disable the payout setting. Use this endpoint if your integration requires it, such as Adyen for Platforms Manage. Your Adyen contact will set up your access. To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Payout account settings read and write' operationId: patch-merchants-merchantId-payoutSettings-payoutSettingsId x-sortIndex: 2 x-methodName: updatePayoutSetting security: - BasicAuth: [] - ApiKeyAuth: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdatePayoutSettingsRequest' parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The unique identifier of the payout setting. name: payoutSettingsId in: path required: true schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/PayoutSettings' examples: patch-merchants-merchantId-payoutSettings-payoutSettingsId200Example: summary: Default patch-merchants-merchantId-payoutSettings-payoutSettingsId 200 response x-microcks-default: true value: allowed: true enabled: true enabledFromDate: example_value id: '500123' priority: first transferInstrumentId: '500123' verificationStatus: invalid description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-payoutSettings-payoutSettingsId400Example: summary: Default patch-merchants-merchantId-payoutSettings-payoutSettingsId 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-payoutSettings-payoutSettingsId401Example: summary: Default patch-merchants-merchantId-payoutSettings-payoutSettingsId 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-payoutSettings-payoutSettingsId403Example: summary: Default patch-merchants-merchantId-payoutSettings-payoutSettingsId 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-payoutSettings-payoutSettingsId422Example: summary: Default patch-merchants-merchantId-payoutSettings-payoutSettingsId 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-payoutSettings-payoutSettingsId500Example: summary: Default patch-merchants-merchantId-payoutSettings-payoutSettingsId 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/shippingLocations: get: tags: - Merchants summary: Adyen Get a List of Shipping Locations description: 'Returns the shipping locations for the merchant account identified in the path. A shipping location includes the address where orders can be delivered, and an ID which you need to specify when ordering terminal products. To make this request, your API credential must have one of the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Terminal ordering read * Management API—Terminal ordering read and write' operationId: get-merchants-merchantId-shippingLocations x-sortIndex: 4 x-methodName: listShippingLocations security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The name of the shipping location. name: name in: query required: false schema: type: string - description: The number of locations to skip. name: offset in: query required: false schema: format: int32 type: integer - description: The number of locations to return. name: limit in: query required: false schema: format: int32 type: integer responses: '200': content: application/json: examples: success: $ref: '#/components/examples/get-merchants-merchantId-shippingLocations-success-200' schema: $ref: '#/components/schemas/ShippingLocationsResponse' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-shippingLocations400Example: summary: Default get-merchants-merchantId-shippingLocations 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-shippingLocations401Example: summary: Default get-merchants-merchantId-shippingLocations 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-shippingLocations403Example: summary: Default get-merchants-merchantId-shippingLocations 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-shippingLocations422Example: summary: Default get-merchants-merchantId-shippingLocations 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-shippingLocations500Example: summary: Default get-merchants-merchantId-shippingLocations 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK post: tags: - Merchants summary: Adyen Create a Shipping Location description: "Creates a shipping location for the merchant account identified in the path. A shipping location defines an address where orders can be shipped to. \n\nTo make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions):\n* Management API—Terminal ordering read and write" operationId: post-merchants-merchantId-shippingLocations x-sortIndex: 5 x-methodName: createShippingLocation security: - BasicAuth: [] - ApiKeyAuth: [] requestBody: content: application/json: examples: create-shipping-location: $ref: '#/components/examples/post-merchants-merchantId-shippingLocations-create-shipping-location' schema: $ref: '#/components/schemas/ShippingLocation' parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string responses: '200': content: application/json: examples: create-shipping-location: $ref: '#/components/examples/post-merchants-merchantId-shippingLocations-create-shipping-location-200' schema: $ref: '#/components/schemas/ShippingLocation' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-shippingLocations400Example: summary: Default post-merchants-merchantId-shippingLocations 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-shippingLocations401Example: summary: Default post-merchants-merchantId-shippingLocations 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-shippingLocations403Example: summary: Default post-merchants-merchantId-shippingLocations 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-shippingLocations422Example: summary: Default post-merchants-merchantId-shippingLocations 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-shippingLocations500Example: summary: Default post-merchants-merchantId-shippingLocations 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/splitConfigurations: get: tags: - Merchants summary: Adyen Get a List of Split Configurations description: 'Returns the list of split configurations for the merchant account. To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API - SplitConfiguration read and write' operationId: get-merchants-merchantId-splitConfigurations x-sortIndex: 3 x-methodName: listSplitConfigurations security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string responses: '200': content: application/json: examples: success: $ref: '#/components/examples/get-merchants-merchantId-splitConfigurations-success-200' schema: $ref: '#/components/schemas/SplitConfigurationList' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-splitConfigurations400Example: summary: Default get-merchants-merchantId-splitConfigurations 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-splitConfigurations401Example: summary: Default get-merchants-merchantId-splitConfigurations 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-splitConfigurations403Example: summary: Default get-merchants-merchantId-splitConfigurations 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-splitConfigurations422Example: summary: Default get-merchants-merchantId-splitConfigurations 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-splitConfigurations500Example: summary: Default get-merchants-merchantId-splitConfigurations 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK post: tags: - Merchants summary: Adyen Create a Split Configuration description: 'Creates a split configuration for the merchant account specified in the path. To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API - SplitConfiguration read and write' operationId: post-merchants-merchantId-splitConfigurations x-sortIndex: 1 x-methodName: createSplitConfiguration security: - BasicAuth: [] - ApiKeyAuth: [] requestBody: content: application/json: examples: post-splitConfiguration: $ref: '#/components/examples/post-merchants-merchantId-splitConfigurations-post-splitConfiguration' schema: $ref: '#/components/schemas/SplitConfiguration' parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string responses: '200': content: application/json: examples: post-splitConfiguration: $ref: '#/components/examples/post-merchants-merchantId-splitConfigurations-post-splitConfiguration-200' schema: $ref: '#/components/schemas/SplitConfiguration' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-splitConfigurations400Example: summary: Default post-merchants-merchantId-splitConfigurations 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-splitConfigurations401Example: summary: Default post-merchants-merchantId-splitConfigurations 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-splitConfigurations403Example: summary: Default post-merchants-merchantId-splitConfigurations 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-splitConfigurations422Example: summary: Default post-merchants-merchantId-splitConfigurations 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-splitConfigurations500Example: summary: Default post-merchants-merchantId-splitConfigurations 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/splitConfigurations/{splitConfigurationId}: delete: tags: - Merchants summary: Adyen Delete a Split Configuration description: 'Deletes the split configuration specified in the path. To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API - SplitConfiguration read and write' operationId: delete-merchants-merchantId-splitConfigurations-splitConfigurationId x-sortIndex: 8 x-methodName: deleteSplitConfiguration security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The unique identifier of the split configuration. name: splitConfigurationId in: path required: true schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/SplitConfiguration' examples: delete-merchants-merchantId-splitConfigurations-splitConfigurationId200Example: summary: Default delete-merchants-merchantId-splitConfigurations-splitConfigurationId 200 response x-microcks-default: true value: description: A sample description for this resource. rules: - example_value splitConfigurationId: '500123' stores: - example_value description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: delete-merchants-merchantId-splitConfigurations-splitConfigurationId400Example: summary: Default delete-merchants-merchantId-splitConfigurations-splitConfigurationId 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: delete-merchants-merchantId-splitConfigurations-splitConfigurationId401Example: summary: Default delete-merchants-merchantId-splitConfigurations-splitConfigurationId 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: delete-merchants-merchantId-splitConfigurations-splitConfigurationId403Example: summary: Default delete-merchants-merchantId-splitConfigurations-splitConfigurationId 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: delete-merchants-merchantId-splitConfigurations-splitConfigurationId422Example: summary: Default delete-merchants-merchantId-splitConfigurations-splitConfigurationId 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: delete-merchants-merchantId-splitConfigurations-splitConfigurationId500Example: summary: Default delete-merchants-merchantId-splitConfigurations-splitConfigurationId 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK get: tags: - Merchants summary: Adyen Get a Split Configuration description: 'Returns the split configuration specified in the path. To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API - SplitConfiguration read and write' operationId: get-merchants-merchantId-splitConfigurations-splitConfigurationId x-sortIndex: 4 x-methodName: getSplitConfiguration security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The unique identifier of the split configuration. name: splitConfigurationId in: path required: true schema: type: string responses: '200': content: application/json: examples: success: $ref: '#/components/examples/get-merchants-merchantId-splitConfigurations-splitConfigurationId-success-200' schema: $ref: '#/components/schemas/SplitConfiguration' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-splitConfigurations-splitConfigurationId400Example: summary: Default get-merchants-merchantId-splitConfigurations-splitConfigurationId 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-splitConfigurations-splitConfigurationId401Example: summary: Default get-merchants-merchantId-splitConfigurations-splitConfigurationId 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-splitConfigurations-splitConfigurationId403Example: summary: Default get-merchants-merchantId-splitConfigurations-splitConfigurationId 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-splitConfigurations-splitConfigurationId422Example: summary: Default get-merchants-merchantId-splitConfigurations-splitConfigurationId 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-splitConfigurations-splitConfigurationId500Example: summary: Default get-merchants-merchantId-splitConfigurations-splitConfigurationId 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK patch: tags: - Merchants summary: Adyen Update Split Configuration Description description: 'Changes the description of the split configuration specified in the path. To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API - SplitConfiguration read and write' operationId: patch-merchants-merchantId-splitConfigurations-splitConfigurationId x-sortIndex: 5 x-methodName: updateSplitConfigurationDescription security: - BasicAuth: [] - ApiKeyAuth: [] requestBody: content: application/json: examples: patch-splitConfiguration-description: $ref: '#/components/examples/patch-merchants-merchantId-splitConfigurations-splitConfigurationId-patch-splitConfiguration-description' schema: $ref: '#/components/schemas/UpdateSplitConfigurationRequest' parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The unique identifier of the split configuration. name: splitConfigurationId in: path required: true schema: type: string responses: '200': content: application/json: examples: patch-splitConfiguration-description: $ref: '#/components/examples/patch-merchants-merchantId-splitConfigurations-splitConfigurationId-patch-splitConfiguration-description-200' schema: $ref: '#/components/schemas/SplitConfiguration' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-splitConfigurations-splitConfigurationId400Example: summary: Default patch-merchants-merchantId-splitConfigurations-splitConfigurationId 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-splitConfigurations-splitConfigurationId401Example: summary: Default patch-merchants-merchantId-splitConfigurations-splitConfigurationId 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-splitConfigurations-splitConfigurationId403Example: summary: Default patch-merchants-merchantId-splitConfigurations-splitConfigurationId 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-splitConfigurations-splitConfigurationId422Example: summary: Default patch-merchants-merchantId-splitConfigurations-splitConfigurationId 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-splitConfigurations-splitConfigurationId500Example: summary: Default patch-merchants-merchantId-splitConfigurations-splitConfigurationId 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK post: tags: - Merchants summary: Adyen Create a Rule description: 'Creates a rule in the split configuration specified in the path. To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API - SplitConfiguration read and write' operationId: post-merchants-merchantId-splitConfigurations-splitConfigurationId x-sortIndex: 2 x-methodName: createRule security: - BasicAuth: [] - ApiKeyAuth: [] requestBody: content: application/json: examples: post-splitConfiguration-rule: $ref: '#/components/examples/post-merchants-merchantId-splitConfigurations-splitConfigurationId-post-splitConfiguration-rule' schema: $ref: '#/components/schemas/SplitConfigurationRule' parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The unique identifier of the split configuration. name: splitConfigurationId in: path required: true schema: type: string responses: '200': content: application/json: examples: post-splitConfiguration-rule: $ref: '#/components/examples/post-merchants-merchantId-splitConfigurations-splitConfigurationId-post-splitConfiguration-rule-200' schema: $ref: '#/components/schemas/SplitConfiguration' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-splitConfigurations-splitConfigurationId400Example: summary: Default post-merchants-merchantId-splitConfigurations-splitConfigurationId 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-splitConfigurations-splitConfigurationId401Example: summary: Default post-merchants-merchantId-splitConfigurations-splitConfigurationId 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-splitConfigurations-splitConfigurationId403Example: summary: Default post-merchants-merchantId-splitConfigurations-splitConfigurationId 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-splitConfigurations-splitConfigurationId422Example: summary: Default post-merchants-merchantId-splitConfigurations-splitConfigurationId 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-splitConfigurations-splitConfigurationId500Example: summary: Default post-merchants-merchantId-splitConfigurations-splitConfigurationId 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/splitConfigurations/{splitConfigurationId}/rules/{ruleId}: delete: tags: - Merchants summary: Adyen Delete a Split Configuration Rule description: 'Deletes the split configuration rule specified in the path. To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API - SplitConfiguration read and write' operationId: delete-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId x-sortIndex: 9 x-methodName: deleteSplitConfigurationRule security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The unique identifier of the split configuration. name: splitConfigurationId in: path required: true schema: type: string - name: ruleId in: path required: true schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/SplitConfiguration' examples: delete-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId200Example: summary: Default delete-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId 200 response x-microcks-default: true value: description: A sample description for this resource. rules: - example_value splitConfigurationId: '500123' stores: - example_value description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: delete-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId400Example: summary: Default delete-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: delete-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId401Example: summary: Default delete-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: delete-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId403Example: summary: Default delete-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: delete-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId422Example: summary: Default delete-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: delete-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId500Example: summary: Default delete-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK patch: tags: - Merchants summary: Adyen Update Split Conditions description: 'Changes the conditions of the split configuration rule specified in the path. To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API - SplitConfiguration read and write' operationId: patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId x-sortIndex: 6 x-methodName: updateSplitConditions security: - BasicAuth: [] - ApiKeyAuth: [] requestBody: content: application/json: examples: patch-splitConfiguration-rule: $ref: '#/components/examples/patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId-patch-splitConfiguration-rule' schema: $ref: '#/components/schemas/UpdateSplitConfigurationRuleRequest' parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The identifier of the split configuration. name: splitConfigurationId in: path required: true schema: type: string - description: The unique identifier of the split configuration rule. name: ruleId in: path required: true schema: type: string responses: '200': content: application/json: examples: patch-splitConfiguration-rule: $ref: '#/components/examples/patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId-patch-splitConfiguration-rule-200' schema: $ref: '#/components/schemas/SplitConfiguration' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId400Example: summary: Default patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId401Example: summary: Default patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId403Example: summary: Default patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId422Example: summary: Default patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId500Example: summary: Default patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/splitConfigurations/{splitConfigurationId}/rules/{ruleId}/splitLogic/{splitLogicId}: patch: tags: - Merchants summary: Adyen Update the Split Logic description: 'Changes the split logic specified in the path. To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API - SplitConfiguration read and write' operationId: patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId-splitLogic-splitLogicId x-sortIndex: 7 x-methodName: updateSplitLogic security: - BasicAuth: [] - ApiKeyAuth: [] requestBody: content: application/json: examples: patch-splitConfiguration-rule-splitLogic: $ref: '#/components/examples/patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId-splitLogic-splitLogicId-patch-splitConfiguration-rule-splitLogic' schema: $ref: '#/components/schemas/UpdateSplitConfigurationLogicRequest' parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The unique identifier of the split configuration. name: splitConfigurationId in: path required: true schema: type: string - description: The unique identifier of the split configuration rule. name: ruleId in: path required: true schema: type: string - description: The unique identifier of the split configuration split. name: splitLogicId in: path required: true schema: type: string responses: '200': content: application/json: examples: patch-splitConfiguration-rule-splitLogic: $ref: '#/components/examples/patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId-splitLogic-splitLogicId-patch-splitConfiguration-rule-splitLogic-200' schema: $ref: '#/components/schemas/SplitConfiguration' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId-splitLogic-splitLogicId400Example: summary: Default patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId-splitLogic-splitLogicId 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId-splitLogic-splitLogicId401Example: summary: Default patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId-splitLogic-splitLogicId 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId-splitLogic-splitLogicId403Example: summary: Default patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId-splitLogic-splitLogicId 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId-splitLogic-splitLogicId422Example: summary: Default patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId-splitLogic-splitLogicId 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId-splitLogic-splitLogicId500Example: summary: Default patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId-splitLogic-splitLogicId 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/stores: get: tags: - Merchants summary: Adyen Get a List of Stores description: 'Returns a list of stores for the merchant account identified in the path. The list is grouped into pages as defined by the query parameters. To make this request, your API credential must have one of the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Stores read * Management API—Stores read and write' operationId: get-merchants-merchantId-stores x-sortIndex: 1 x-methodName: listStoresByMerchantId security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The number of the page to fetch. name: pageNumber in: query required: false schema: format: int32 type: integer - description: The number of items to have on a page, maximum 100. The default is 10 items on a page. name: pageSize in: query required: false schema: format: int32 type: integer - description: The reference of the store. name: reference in: query required: false schema: type: string responses: '200': content: application/json: examples: success: $ref: '#/components/examples/get-merchants-merchantId-stores-success-200' schema: $ref: '#/components/schemas/ListStoresResponse' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-stores400Example: summary: Default get-merchants-merchantId-stores 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-stores401Example: summary: Default get-merchants-merchantId-stores 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-stores403Example: summary: Default get-merchants-merchantId-stores 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-stores422Example: summary: Default get-merchants-merchantId-stores 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-stores500Example: summary: Default get-merchants-merchantId-stores 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK post: tags: - Merchants summary: Adyen Create a Store description: 'Creates a store for the merchant account identified in the path. To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Stores read and write' operationId: post-merchants-merchantId-stores x-sortIndex: 0 x-methodName: createStoreByMerchantId security: - BasicAuth: [] - ApiKeyAuth: [] requestBody: content: application/json: examples: post-stores: $ref: '#/components/examples/post-merchants-merchantId-stores-post-stores' schema: $ref: '#/components/schemas/StoreCreationRequest' parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string responses: '200': content: application/json: examples: post-stores: $ref: '#/components/examples/post-merchants-merchantId-stores-post-stores-200' schema: $ref: '#/components/schemas/Store' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-stores400Example: summary: Default post-merchants-merchantId-stores 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-stores401Example: summary: Default post-merchants-merchantId-stores 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-stores403Example: summary: Default post-merchants-merchantId-stores 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-stores422Example: summary: Default post-merchants-merchantId-stores 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-stores500Example: summary: Default post-merchants-merchantId-stores 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/stores/{reference}/terminalLogos: get: tags: - Merchants summary: Adyen Get the Terminal Logo description: "Returns the logo that is configured for a specific payment terminal model at the store identified in the path. \nThe logo is returned as a Base64-encoded string. You need to Base64-decode the string to get the actual image file. \nThis logo applies to all terminals of the specified model under the store, unless a different logo is configured for an individual terminal.\n\nTo make this request, your API credential must have one of the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions):\n* Management API—Terminal settings read\n* Management API—Terminal settings read and write" operationId: get-merchants-merchantId-stores-reference-terminalLogos x-sortIndex: 2 x-methodName: getTerminalLogo security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The reference that identifies the store. name: reference in: path required: true schema: type: string - description: 'The terminal model. Possible values: E355, VX675WIFIBT, VX680, VX690, VX700, VX820, M400, MX925, P400Plus, UX300, UX410, V200cPlus, V240mPlus, V400cPlus, V400m, e280, e285, e285p, S1E, S1EL, S1F2, S1L, S1U, S7T.' name: model in: query required: true schema: type: string responses: '200': content: application/json: examples: success: $ref: '#/components/examples/get-merchants-merchantId-stores-reference-terminalLogos-success-200' schema: $ref: '#/components/schemas/Logo' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-stores-reference-terminalLogos400Example: summary: Default get-merchants-merchantId-stores-reference-terminalLogos 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-stores-reference-terminalLogos401Example: summary: Default get-merchants-merchantId-stores-reference-terminalLogos 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-stores-reference-terminalLogos403Example: summary: Default get-merchants-merchantId-stores-reference-terminalLogos 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-stores-reference-terminalLogos422Example: summary: Default get-merchants-merchantId-stores-reference-terminalLogos 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-stores-reference-terminalLogos500Example: summary: Default get-merchants-merchantId-stores-reference-terminalLogos 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK patch: tags: - Merchants summary: Adyen Update the Terminal Logo description: "Updates the logo that is configured for a specific payment terminal model at the store identified in the path. You can update the logo for only one terminal model at a time.\nThis logo applies to all terminals of the specified model under the store, unless a different logo is configured for an individual terminal. \n\n* To change the logo, specify the image file as a Base64-encoded string.\n* To restore the logo inherited from a higher level (merchant or company account), specify an empty logo value.\n\nTo make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions):\n* Management API—Terminal settings read and write" operationId: patch-merchants-merchantId-stores-reference-terminalLogos x-sortIndex: 4 x-methodName: updateTerminalLogo security: - BasicAuth: [] - ApiKeyAuth: [] requestBody: content: application/json: examples: remove-logo: $ref: '#/components/examples/patch-merchants-merchantId-stores-reference-terminalLogos-remove-logo' upload-logo: $ref: '#/components/examples/patch-merchants-merchantId-stores-reference-terminalLogos-upload-logo' schema: $ref: '#/components/schemas/Logo' parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The reference that identifies the store. name: reference in: path required: true schema: type: string - description: 'The terminal model. Possible values: E355, VX675WIFIBT, VX680, VX690, VX700, VX820, M400, MX925, P400Plus, UX300, UX410, V200cPlus, V240mPlus, V400cPlus, V400m, e280, e285, e285p, S1E, S1EL, S1F2, S1L, S1U, S7T' name: model in: query required: true schema: type: string responses: '200': content: application/json: examples: remove-logo: $ref: '#/components/examples/patch-merchants-merchantId-stores-reference-terminalLogos-remove-logo-200' upload-logo: $ref: '#/components/examples/patch-merchants-merchantId-stores-reference-terminalLogos-upload-logo-200' schema: $ref: '#/components/schemas/Logo' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-stores-reference-terminalLogos400Example: summary: Default patch-merchants-merchantId-stores-reference-terminalLogos 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-stores-reference-terminalLogos401Example: summary: Default patch-merchants-merchantId-stores-reference-terminalLogos 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-stores-reference-terminalLogos403Example: summary: Default patch-merchants-merchantId-stores-reference-terminalLogos 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-stores-reference-terminalLogos422Example: summary: Default patch-merchants-merchantId-stores-reference-terminalLogos 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-stores-reference-terminalLogos500Example: summary: Default patch-merchants-merchantId-stores-reference-terminalLogos 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/stores/{reference}/terminalSettings: get: tags: - Merchants summary: Adyen Get Terminal Settings description: 'Returns the payment terminal settings that are configured for the store identified in the path. These settings apply to all terminals under the store unless different values are configured for an individual terminal. To make this request, your API credential must have one of the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Terminal settings read * Management API—Terminal settings read and write For [sensitive terminal settings](https://docs.adyen.com/point-of-sale/automating-terminal-management/configure-terminals-api#sensitive-terminal-settings), your API credential must have the following role: * Management API—Terminal settings Advanced read and write' operationId: get-merchants-merchantId-stores-reference-terminalSettings x-sortIndex: 1 x-methodName: getTerminalSettings security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The reference that identifies the store. name: reference in: path required: true schema: type: string responses: '200': content: application/json: examples: success: $ref: '#/components/examples/get-merchants-merchantId-stores-reference-terminalSettings-success-200' schema: $ref: '#/components/schemas/TerminalSettings' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-stores-reference-terminalSettings400Example: summary: Default get-merchants-merchantId-stores-reference-terminalSettings 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-stores-reference-terminalSettings401Example: summary: Default get-merchants-merchantId-stores-reference-terminalSettings 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-stores-reference-terminalSettings403Example: summary: Default get-merchants-merchantId-stores-reference-terminalSettings 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-stores-reference-terminalSettings422Example: summary: Default get-merchants-merchantId-stores-reference-terminalSettings 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-stores-reference-terminalSettings500Example: summary: Default get-merchants-merchantId-stores-reference-terminalSettings 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK patch: tags: - Merchants summary: Adyen Update Terminal Settings description: 'Updates payment terminal settings for the store identified in the path. These settings apply to all terminals under the store, unless different values are configured for an individual terminal. * To change a parameter value, include the full object that contains the parameter, even if you don''t want to change all parameters in the object. * To restore a parameter value inherited from a higher level, include the full object that contains the parameter, and specify an empty value for the parameter or omit the parameter. * Objects that are not included in the request are not updated. To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Terminal settings read and write For [sensitive terminal settings](https://docs.adyen.com/point-of-sale/automating-terminal-management/configure-terminals-api#sensitive-terminal-settings), your API credential must have the following role: * Management API—Terminal settings Advanced read and write' operationId: patch-merchants-merchantId-stores-reference-terminalSettings x-sortIndex: 3 x-methodName: updateTerminalSettings security: - BasicAuth: [] - ApiKeyAuth: [] requestBody: content: application/json: examples: add-eap-peap-and-psk-wifi-profiles: $ref: '#/components/examples/patch-merchants-merchantId-stores-reference-terminalSettings-add-eap-peap-and-psk-wifi-profiles' add-eap-tls-wifi-profile: $ref: '#/components/examples/patch-merchants-merchantId-stores-reference-terminalSettings-add-eap-tls-wifi-profile' schema: $ref: '#/components/schemas/TerminalSettings' parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The reference that identifies the store. name: reference in: path required: true schema: type: string responses: '200': content: application/json: examples: add-eap-peap-and-psk-wifi-profiles: $ref: '#/components/examples/patch-merchants-merchantId-stores-reference-terminalSettings-add-eap-peap-and-psk-wifi-profiles-200' add-eap-tls-wifi-profile: $ref: '#/components/examples/patch-merchants-merchantId-stores-reference-terminalSettings-add-eap-tls-wifi-profile-200' schema: $ref: '#/components/schemas/TerminalSettings' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-stores-reference-terminalSettings400Example: summary: Default patch-merchants-merchantId-stores-reference-terminalSettings 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-stores-reference-terminalSettings401Example: summary: Default patch-merchants-merchantId-stores-reference-terminalSettings 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-stores-reference-terminalSettings403Example: summary: Default patch-merchants-merchantId-stores-reference-terminalSettings 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-stores-reference-terminalSettings422Example: summary: Default patch-merchants-merchantId-stores-reference-terminalSettings 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-stores-reference-terminalSettings500Example: summary: Default patch-merchants-merchantId-stores-reference-terminalSettings 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/stores/{storeId}: get: tags: - Merchants summary: Adyen Get a Store description: 'Returns the details of the store identified in the path. To make this request, your API credential must have one of the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Stores read * Management API—Stores read and write' operationId: get-merchants-merchantId-stores-storeId x-sortIndex: 2 x-methodName: getStore security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The unique identifier of the store. name: storeId in: path required: true schema: type: string responses: '200': content: application/json: examples: success: $ref: '#/components/examples/get-merchants-merchantId-stores-storeId-success-200' schema: $ref: '#/components/schemas/Store' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-stores-storeId400Example: summary: Default get-merchants-merchantId-stores-storeId 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-stores-storeId401Example: summary: Default get-merchants-merchantId-stores-storeId 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-stores-storeId403Example: summary: Default get-merchants-merchantId-stores-storeId 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-stores-storeId422Example: summary: Default get-merchants-merchantId-stores-storeId 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-stores-storeId500Example: summary: Default get-merchants-merchantId-stores-storeId 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK patch: tags: - Merchants summary: Adyen Update a Store description: 'Updates the store identified in the path. You can only update some store parameters. To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Stores read and write' operationId: patch-merchants-merchantId-stores-storeId x-sortIndex: 3 x-methodName: updateStore security: - BasicAuth: [] - ApiKeyAuth: [] requestBody: content: application/json: examples: patch-stores: $ref: '#/components/examples/patch-merchants-merchantId-stores-storeId-patch-stores' patch-stores-splitConfiguration: $ref: '#/components/examples/patch-merchants-merchantId-stores-storeId-patch-stores-splitConfiguration' schema: $ref: '#/components/schemas/UpdateStoreRequest' parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The unique identifier of the store. name: storeId in: path required: true schema: type: string responses: '200': content: application/json: examples: patch-stores: $ref: '#/components/examples/patch-merchants-merchantId-stores-storeId-patch-stores-200' patch-stores-splitConfiguration: $ref: '#/components/examples/patch-merchants-merchantId-stores-storeId-patch-stores-splitConfiguration-200' schema: $ref: '#/components/schemas/Store' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-stores-storeId400Example: summary: Default patch-merchants-merchantId-stores-storeId 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-stores-storeId401Example: summary: Default patch-merchants-merchantId-stores-storeId 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-stores-storeId403Example: summary: Default patch-merchants-merchantId-stores-storeId 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-stores-storeId422Example: summary: Default patch-merchants-merchantId-stores-storeId 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-stores-storeId500Example: summary: Default patch-merchants-merchantId-stores-storeId 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/terminalLogos: get: tags: - Merchants summary: Adyen Get the Terminal Logo description: "Returns the logo that is configured for a specific payment terminal model at the merchant account identified in the path. \nThe logo is returned as a Base64-encoded string. You need to Base64-decode the string to get the actual image file. \nThis logo applies to all terminals of the specified model under the merchant account, unless a different logo is configured at a lower level (store or individual terminal).\n\nTo make this request, your API credential must have one of the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions):\n* Management API—Terminal settings read\n* Management API—Terminal settings read and write" operationId: get-merchants-merchantId-terminalLogos x-sortIndex: 2 x-methodName: getTerminalLogo security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: 'The terminal model. Possible values: E355, VX675WIFIBT, VX680, VX690, VX700, VX820, M400, MX925, P400Plus, UX300, UX410, V200cPlus, V240mPlus, V400cPlus, V400m, e280, e285, e285p, S1E, S1EL, S1F2, S1L, S1U, S7T.' name: model in: query required: true schema: type: string responses: '200': content: application/json: examples: success: $ref: '#/components/examples/get-merchants-merchantId-terminalLogos-success-200' schema: $ref: '#/components/schemas/Logo' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalLogos400Example: summary: Default get-merchants-merchantId-terminalLogos 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalLogos401Example: summary: Default get-merchants-merchantId-terminalLogos 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalLogos403Example: summary: Default get-merchants-merchantId-terminalLogos 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalLogos422Example: summary: Default get-merchants-merchantId-terminalLogos 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalLogos500Example: summary: Default get-merchants-merchantId-terminalLogos 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK patch: tags: - Merchants summary: Adyen Update the Terminal Logo description: "Updates the logo for a specific payment terminal model at the merchant account identified in the path. You can update the logo for only one terminal model at a time. \nThis logo applies to all terminals of the specified model under the merchant account, unless a different logo is configured at a lower level (store or individual terminal).\n\n* To change the logo, specify the image file as a Base64-encoded string.\n* To restore the logo inherited from the company account, specify an empty logo value.\n\nTo make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions):\n* Management API—Terminal settings read and write" operationId: patch-merchants-merchantId-terminalLogos x-sortIndex: 4 x-methodName: updateTerminalLogo security: - BasicAuth: [] - ApiKeyAuth: [] requestBody: content: application/json: examples: remove-logo: $ref: '#/components/examples/patch-merchants-merchantId-terminalLogos-remove-logo' upload-logo: $ref: '#/components/examples/patch-merchants-merchantId-terminalLogos-upload-logo' schema: $ref: '#/components/schemas/Logo' parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: 'The terminal model. Allowed values: E355, VX675WIFIBT, VX680, VX690, VX700, VX820, M400, MX925, P400Plus, UX300, UX410, V200cPlus, V240mPlus, V400cPlus, V400m, e280, e285, e285p, S1E, S1EL, S1F2, S1L, S1U, S7T.' name: model in: query required: true schema: type: string responses: '200': content: application/json: examples: remove-logo: $ref: '#/components/examples/patch-merchants-merchantId-terminalLogos-remove-logo-200' upload-logo: $ref: '#/components/examples/patch-merchants-merchantId-terminalLogos-upload-logo-200' schema: $ref: '#/components/schemas/Logo' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-terminalLogos400Example: summary: Default patch-merchants-merchantId-terminalLogos 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-terminalLogos401Example: summary: Default patch-merchants-merchantId-terminalLogos 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-terminalLogos403Example: summary: Default patch-merchants-merchantId-terminalLogos 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-terminalLogos422Example: summary: Default patch-merchants-merchantId-terminalLogos 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-terminalLogos500Example: summary: Default patch-merchants-merchantId-terminalLogos 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/terminalModels: get: tags: - Merchants summary: Adyen Get a List of Terminal Models description: 'Returns the payment terminal models that merchant account identified in the path has access to. The response includes the terminal model ID, which can be used as a query parameter when getting a list of terminals or a list of products for ordering. To make this request, your API credential must have one of the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Terminal ordering read * Management API—Terminal ordering read and write' operationId: get-merchants-merchantId-terminalModels x-sortIndex: 1 x-methodName: listTerminalModels security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string responses: '200': content: application/json: examples: success: $ref: '#/components/examples/get-merchants-merchantId-terminalModels-success-200' schema: $ref: '#/components/schemas/TerminalModelsResponse' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalModels400Example: summary: Default get-merchants-merchantId-terminalModels 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalModels401Example: summary: Default get-merchants-merchantId-terminalModels 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalModels403Example: summary: Default get-merchants-merchantId-terminalModels 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalModels422Example: summary: Default get-merchants-merchantId-terminalModels 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalModels500Example: summary: Default get-merchants-merchantId-terminalModels 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/terminalOrders: get: tags: - Merchants summary: Adyen Get a List of Orders description: 'Returns a list of terminal products orders for the merchant account identified in the path. To make this request, your API credential must have one of the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Terminal ordering read * Management API—Terminal ordering read and write' operationId: get-merchants-merchantId-terminalOrders x-sortIndex: 7 x-methodName: listOrders security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - name: merchantId in: path required: true schema: type: string - description: Your purchase order number. name: customerOrderReference in: query required: false schema: type: string - description: 'The order status. Possible values (not case-sensitive): Placed, Confirmed, Cancelled, Shipped, Delivered.' name: status in: query required: false schema: type: string - description: The number of orders to skip. name: offset in: query required: false schema: format: int32 type: integer - description: The number of orders to return. name: limit in: query required: false schema: format: int32 type: integer responses: '200': content: application/json: examples: success: $ref: '#/components/examples/get-merchants-merchantId-terminalOrders-success-200' schema: $ref: '#/components/schemas/TerminalOrdersResponse' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalOrders400Example: summary: Default get-merchants-merchantId-terminalOrders 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalOrders401Example: summary: Default get-merchants-merchantId-terminalOrders 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalOrders403Example: summary: Default get-merchants-merchantId-terminalOrders 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalOrders422Example: summary: Default get-merchants-merchantId-terminalOrders 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalOrders500Example: summary: Default get-merchants-merchantId-terminalOrders 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK post: tags: - Merchants summary: Adyen Create an Order description: 'Creates an order for payment terminal products for the merchant account identified in the path. To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Terminal ordering read and write >Requests to the Management API test endpoint do not create actual orders for test terminals. To order test terminals, you need to [submit a sales order](https://docs.adyen.com/point-of-sale/managing-terminals/order-terminals/#sales-order-steps) in your Customer Area.' operationId: post-merchants-merchantId-terminalOrders x-sortIndex: 6 x-methodName: createOrder security: - BasicAuth: [] - ApiKeyAuth: [] requestBody: content: application/json: examples: create-order: $ref: '#/components/examples/post-merchants-merchantId-terminalOrders-create-order' schema: $ref: '#/components/schemas/TerminalOrderRequest' parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string responses: '200': content: application/json: examples: create-order: $ref: '#/components/examples/post-merchants-merchantId-terminalOrders-create-order-200' schema: $ref: '#/components/schemas/TerminalOrder' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-terminalOrders400Example: summary: Default post-merchants-merchantId-terminalOrders 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-terminalOrders401Example: summary: Default post-merchants-merchantId-terminalOrders 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-terminalOrders403Example: summary: Default post-merchants-merchantId-terminalOrders 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-terminalOrders422Example: summary: Default post-merchants-merchantId-terminalOrders 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-terminalOrders500Example: summary: Default post-merchants-merchantId-terminalOrders 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/terminalOrders/{orderId}: get: tags: - Merchants summary: Adyen Get an Order description: 'Returns the details of the terminal products order identified in the path. To make this request, your API credential must have one of the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Terminal ordering read * Management API—Terminal ordering read and write' operationId: get-merchants-merchantId-terminalOrders-orderId x-sortIndex: 8 x-methodName: getOrder security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The unique identifier of the order. name: orderId in: path required: true schema: type: string responses: '200': content: application/json: examples: success: $ref: '#/components/examples/get-merchants-merchantId-terminalOrders-orderId-success-200' schema: $ref: '#/components/schemas/TerminalOrder' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalOrders-orderId400Example: summary: Default get-merchants-merchantId-terminalOrders-orderId 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalOrders-orderId401Example: summary: Default get-merchants-merchantId-terminalOrders-orderId 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalOrders-orderId403Example: summary: Default get-merchants-merchantId-terminalOrders-orderId 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalOrders-orderId422Example: summary: Default get-merchants-merchantId-terminalOrders-orderId 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalOrders-orderId500Example: summary: Default get-merchants-merchantId-terminalOrders-orderId 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK patch: tags: - Merchants summary: Adyen Update an Order description: "Updates the terminal products order identified in the path.\nUpdating is only possible while the order has the status **Placed**.\n\nThe request body only needs to contain what you want to change. \nHowever, to update the products in the `items` array, you must provide the entire array. For example, if the array has three items:\n To remove one item, the array must include the remaining two items. Or to add one item, the array must include all four items.\n\nTo make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions):\n* Management API—Terminal ordering read and write" operationId: patch-merchants-merchantId-terminalOrders-orderId x-sortIndex: 9 x-methodName: updateOrder security: - BasicAuth: [] - ApiKeyAuth: [] requestBody: content: application/json: examples: update-order: $ref: '#/components/examples/patch-merchants-merchantId-terminalOrders-orderId-update-order' schema: $ref: '#/components/schemas/TerminalOrderRequest' parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The unique identifier of the order. name: orderId in: path required: true schema: type: string responses: '200': content: application/json: examples: update-order: $ref: '#/components/examples/patch-merchants-merchantId-terminalOrders-orderId-update-order-200' schema: $ref: '#/components/schemas/TerminalOrder' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-terminalOrders-orderId400Example: summary: Default patch-merchants-merchantId-terminalOrders-orderId 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-terminalOrders-orderId401Example: summary: Default patch-merchants-merchantId-terminalOrders-orderId 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-terminalOrders-orderId403Example: summary: Default patch-merchants-merchantId-terminalOrders-orderId 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-terminalOrders-orderId422Example: summary: Default patch-merchants-merchantId-terminalOrders-orderId 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-terminalOrders-orderId500Example: summary: Default patch-merchants-merchantId-terminalOrders-orderId 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/terminalOrders/{orderId}/cancel: post: tags: - Merchants summary: Adyen Cancel an Order description: 'Cancels the terminal products order identified in the path. Cancelling is only possible while the order has the status **Placed**. To cancel an order, make a POST call without a request body. The response returns the full order details, but with the status changed to **Cancelled**. To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Terminal ordering read and write' operationId: post-merchants-merchantId-terminalOrders-orderId-cancel x-sortIndex: 10 x-methodName: cancelOrder security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The unique identifier of the order. name: orderId in: path required: true schema: type: string responses: '200': content: application/json: examples: cancel-order: $ref: '#/components/examples/post-merchants-merchantId-terminalOrders-orderId-cancel-cancel-order-200' schema: $ref: '#/components/schemas/TerminalOrder' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-terminalOrders-orderId-cancel400Example: summary: Default post-merchants-merchantId-terminalOrders-orderId-cancel 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-terminalOrders-orderId-cancel401Example: summary: Default post-merchants-merchantId-terminalOrders-orderId-cancel 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-terminalOrders-orderId-cancel403Example: summary: Default post-merchants-merchantId-terminalOrders-orderId-cancel 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-terminalOrders-orderId-cancel422Example: summary: Default post-merchants-merchantId-terminalOrders-orderId-cancel 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-terminalOrders-orderId-cancel500Example: summary: Default post-merchants-merchantId-terminalOrders-orderId-cancel 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/terminalProducts: get: tags: - Merchants summary: Adyen Get a List of Terminal Products description: 'Returns a country-specific list of payment terminal packages and parts that the merchant account identified in the path has access to. To make this request, your API credential must have one of the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Terminal ordering read * Management API—Terminal ordering read and write' operationId: get-merchants-merchantId-terminalProducts x-sortIndex: 2 x-methodName: listTerminalProducts security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The country to return products for, in [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format. For example, **US** name: country in: query required: true schema: type: string - description: The terminal model to return products for. Use the ID returned in the [GET `/terminalModels`](https://docs.adyen.com/api-explorer/#/ManagementService/latest/get/merchants/{merchantId}/terminalModels) response. For example, **Verifone.M400** name: terminalModelId in: query required: false schema: type: string - description: The number of products to skip. name: offset in: query required: false schema: format: int32 type: integer - description: The number of products to return. name: limit in: query required: false schema: format: int32 type: integer responses: '200': content: application/json: examples: success: $ref: '#/components/examples/get-merchants-merchantId-terminalProducts-success-200' schema: $ref: '#/components/schemas/TerminalProductsResponse' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalProducts400Example: summary: Default get-merchants-merchantId-terminalProducts 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalProducts401Example: summary: Default get-merchants-merchantId-terminalProducts 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalProducts403Example: summary: Default get-merchants-merchantId-terminalProducts 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalProducts422Example: summary: Default get-merchants-merchantId-terminalProducts 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalProducts500Example: summary: Default get-merchants-merchantId-terminalProducts 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/terminalSettings: get: tags: - Merchants summary: Adyen Get Terminal Settings description: 'Returns the payment terminal settings that are configured for the merchant account identified in the path. These settings apply to all terminals under the merchant account unless different values are configured at a lower level (store or individual terminal). To make this request, your API credential must have one of the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Terminal settings read * Management API—Terminal settings read and write' operationId: get-merchants-merchantId-terminalSettings x-sortIndex: 1 x-methodName: getTerminalSettings security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string responses: '200': content: application/json: examples: success: $ref: '#/components/examples/get-merchants-merchantId-terminalSettings-success-200' schema: $ref: '#/components/schemas/TerminalSettings' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalSettings400Example: summary: Default get-merchants-merchantId-terminalSettings 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalSettings401Example: summary: Default get-merchants-merchantId-terminalSettings 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalSettings403Example: summary: Default get-merchants-merchantId-terminalSettings 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalSettings422Example: summary: Default get-merchants-merchantId-terminalSettings 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-terminalSettings500Example: summary: Default get-merchants-merchantId-terminalSettings 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK patch: tags: - Merchants summary: Adyen Update Terminal Settings description: 'Updates payment terminal settings for the merchant account identified in the path. These settings apply to all terminals under the merchant account, unless different values are configured at a lower level (store or individual terminal). * To change a parameter value, include the full object that contains the parameter, even if you don''t want to change all parameters in the object. * To restore a parameter value inherited from a higher level, include the full object that contains the parameter, and specify an empty value for the parameter or omit the parameter. * Objects that are not included in the request are not updated. To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Terminal settings read and write' operationId: patch-merchants-merchantId-terminalSettings x-sortIndex: 3 x-methodName: updateTerminalSettings security: - BasicAuth: [] - ApiKeyAuth: [] requestBody: content: application/json: examples: add-eap-peap-and-psk-wifi-profiles: $ref: '#/components/examples/patch-merchants-merchantId-terminalSettings-add-eap-peap-and-psk-wifi-profiles' add-eap-tls-wifi-profile: $ref: '#/components/examples/patch-merchants-merchantId-terminalSettings-add-eap-tls-wifi-profile' schema: $ref: '#/components/schemas/TerminalSettings' parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string responses: '200': content: application/json: examples: add-eap-peap-and-psk-wifi-profiles: $ref: '#/components/examples/patch-merchants-merchantId-terminalSettings-add-eap-peap-and-psk-wifi-profiles-200' add-eap-tls-wifi-profile: $ref: '#/components/examples/patch-merchants-merchantId-terminalSettings-add-eap-tls-wifi-profile-200' schema: $ref: '#/components/schemas/TerminalSettings' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-terminalSettings400Example: summary: Default patch-merchants-merchantId-terminalSettings 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-terminalSettings401Example: summary: Default patch-merchants-merchantId-terminalSettings 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-terminalSettings403Example: summary: Default patch-merchants-merchantId-terminalSettings 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-terminalSettings422Example: summary: Default patch-merchants-merchantId-terminalSettings 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-terminalSettings500Example: summary: Default patch-merchants-merchantId-terminalSettings 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/users: get: tags: - Merchants summary: Adyen Get a List of Users description: 'Returns a list of users associated with the `merchantId` specified in the path. To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Users read and write ' operationId: get-merchants-merchantId-users x-sortIndex: 0 x-methodName: listUsers security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: Unique identifier of the merchant. name: merchantId in: path required: true schema: type: string - description: The number of the page to fetch. name: pageNumber in: query required: false schema: format: int32 type: integer - description: The number of items to have on a page. Maximum value is **100**. The default is **10** items on a page. name: pageSize in: query required: false schema: format: int32 type: integer - description: The partial or complete username to select all users that match. name: username in: query required: false schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/ListMerchantUsersResponse' examples: get-merchants-merchantId-users200Example: summary: Default get-merchants-merchantId-users 200 response x-microcks-default: true value: _links: https://example.com/resource data: - example_value itemsTotal: 500 pagesTotal: 500 description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-users400Example: summary: Default get-merchants-merchantId-users 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-users401Example: summary: Default get-merchants-merchantId-users 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-users403Example: summary: Default get-merchants-merchantId-users 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-users422Example: summary: Default get-merchants-merchantId-users 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-users500Example: summary: Default get-merchants-merchantId-users 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK post: tags: - Merchants summary: Adyen Create a New User description: 'Creates a user for the `merchantId` specified in the path. To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Users read and write ' operationId: post-merchants-merchantId-users x-sortIndex: 0 x-methodName: createNewUser security: - BasicAuth: [] - ApiKeyAuth: [] requestBody: content: application/json: examples: create-user: $ref: '#/components/examples/post-merchants-merchantId-users-create-user' schema: $ref: '#/components/schemas/CreateMerchantUserRequest' parameters: - description: Unique identifier of the merchant. name: merchantId in: path required: true schema: type: string responses: '200': content: application/json: examples: create-user: $ref: '#/components/examples/post-merchants-merchantId-users-create-user-200' schema: $ref: '#/components/schemas/CreateUserResponse' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-users400Example: summary: Default post-merchants-merchantId-users 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-users401Example: summary: Default post-merchants-merchantId-users 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-users403Example: summary: Default post-merchants-merchantId-users 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-users422Example: summary: Default post-merchants-merchantId-users 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-users500Example: summary: Default post-merchants-merchantId-users 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/users/{userId}: get: tags: - Merchants summary: Adyen Get User Details description: 'Returns user details for the `userId` and the `merchantId` specified in the path. To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Users read and write ' operationId: get-merchants-merchantId-users-userId x-sortIndex: 0 x-methodName: getUserDetails security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: Unique identifier of the merchant. name: merchantId in: path required: true schema: type: string - description: Unique identifier of the user. name: userId in: path required: true schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/User' examples: get-merchants-merchantId-users-userId200Example: summary: Default get-merchants-merchantId-users-userId 200 response x-microcks-default: true value: _links: https://example.com/resource accountGroups: - example_value active: true apps: - example_value email: user@example.com id: '500123' name: Example Name roles: - example_value timeZoneCode: CODE123 username: Example Name description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-users-userId400Example: summary: Default get-merchants-merchantId-users-userId 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-users-userId401Example: summary: Default get-merchants-merchantId-users-userId 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-users-userId403Example: summary: Default get-merchants-merchantId-users-userId 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-users-userId422Example: summary: Default get-merchants-merchantId-users-userId 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-users-userId500Example: summary: Default get-merchants-merchantId-users-userId 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK patch: tags: - Merchants summary: Adyen Update a User description: 'Updates user details for the `userId` and the `merchantId` specified in the path. To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Users read and write ' operationId: patch-merchants-merchantId-users-userId x-sortIndex: 0 x-methodName: updateUser security: - BasicAuth: [] - ApiKeyAuth: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateMerchantUserRequest' parameters: - description: Unique identifier of the merchant. name: merchantId in: path required: true schema: type: string - description: Unique identifier of the user. name: userId in: path required: true schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/User' examples: patch-merchants-merchantId-users-userId200Example: summary: Default patch-merchants-merchantId-users-userId 200 response x-microcks-default: true value: _links: https://example.com/resource accountGroups: - example_value active: true apps: - example_value email: user@example.com id: '500123' name: Example Name roles: - example_value timeZoneCode: CODE123 username: Example Name description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-users-userId400Example: summary: Default patch-merchants-merchantId-users-userId 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-users-userId401Example: summary: Default patch-merchants-merchantId-users-userId 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-users-userId403Example: summary: Default patch-merchants-merchantId-users-userId 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-users-userId422Example: summary: Default patch-merchants-merchantId-users-userId 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-users-userId500Example: summary: Default patch-merchants-merchantId-users-userId 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/webhooks: get: tags: - Merchants summary: Adyen List All Webhooks description: 'Lists all webhook configurations for the merchant account. To make this request, your API credential must have one of the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Webhooks read * Management API—Webhooks read and write' operationId: get-merchants-merchantId-webhooks x-sortIndex: 2 x-methodName: listAllWebhooks security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: The number of the page to fetch. name: pageNumber in: query required: false schema: format: int32 type: integer - description: The number of items to have on a page, maximum 100. The default is 10 items on a page. name: pageSize in: query required: false schema: format: int32 type: integer responses: '200': content: application/json: examples: get-merchant-webhooks: $ref: '#/components/examples/get-merchants-merchantId-webhooks-get-merchant-webhooks-200' schema: $ref: '#/components/schemas/ListWebhooksResponse' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-webhooks400Example: summary: Default get-merchants-merchantId-webhooks 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-webhooks401Example: summary: Default get-merchants-merchantId-webhooks 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-webhooks403Example: summary: Default get-merchants-merchantId-webhooks 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-webhooks422Example: summary: Default get-merchants-merchantId-webhooks 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-webhooks500Example: summary: Default get-merchants-merchantId-webhooks 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK post: tags: - Merchants summary: Adyen Set Up a Webhook description: 'Subscribe to receive webhook notifications about events related to your merchant account. You can add basic authentication to make sure the data is secure. To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Webhooks read and write' operationId: post-merchants-merchantId-webhooks x-sortIndex: 1 x-methodName: setUpWebhook security: - BasicAuth: [] - ApiKeyAuth: [] requestBody: content: application/json: examples: post-merchant-webhook: $ref: '#/components/examples/post-merchants-merchantId-webhooks-post-merchant-webhook' schema: $ref: '#/components/schemas/CreateMerchantWebhookRequest' parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string responses: '200': content: application/json: examples: post-merchant-webhook: $ref: '#/components/examples/post-merchants-merchantId-webhooks-post-merchant-webhook-200' schema: $ref: '#/components/schemas/Webhook' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-webhooks400Example: summary: Default post-merchants-merchantId-webhooks 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-webhooks401Example: summary: Default post-merchants-merchantId-webhooks 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-webhooks403Example: summary: Default post-merchants-merchantId-webhooks 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-webhooks422Example: summary: Default post-merchants-merchantId-webhooks 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-webhooks500Example: summary: Default post-merchants-merchantId-webhooks 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/webhooks/{webhookId}: delete: tags: - Merchants summary: Adyen Remove a Webhook description: 'Remove the configuration for the webhook identified in the path. To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Webhooks read and write' operationId: delete-merchants-merchantId-webhooks-webhookId x-sortIndex: 5 x-methodName: removeWebhook security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: Unique identifier of the webhook configuration. name: webhookId in: path required: true schema: type: string responses: '204': description: 'No Content - look at the actual response code for the status of the request. ' '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: delete-merchants-merchantId-webhooks-webhookId400Example: summary: Default delete-merchants-merchantId-webhooks-webhookId 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: delete-merchants-merchantId-webhooks-webhookId401Example: summary: Default delete-merchants-merchantId-webhooks-webhookId 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: delete-merchants-merchantId-webhooks-webhookId403Example: summary: Default delete-merchants-merchantId-webhooks-webhookId 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: delete-merchants-merchantId-webhooks-webhookId422Example: summary: Default delete-merchants-merchantId-webhooks-webhookId 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: delete-merchants-merchantId-webhooks-webhookId500Example: summary: Default delete-merchants-merchantId-webhooks-webhookId 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK get: tags: - Merchants summary: Adyen Get a Webhook description: 'Returns the configuration for the webhook identified in the path. To make this request, your API credential must have one of the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Webhooks read * Management API—Webhooks read and write' operationId: get-merchants-merchantId-webhooks-webhookId x-sortIndex: 3 x-methodName: getWebhook security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: Unique identifier of the webhook configuration. name: webhookId in: path required: true schema: type: string responses: '200': content: application/json: examples: get-merchant-webhook: $ref: '#/components/examples/get-merchants-merchantId-webhooks-webhookId-get-merchant-webhook-200' schema: $ref: '#/components/schemas/Webhook' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-webhooks-webhookId400Example: summary: Default get-merchants-merchantId-webhooks-webhookId 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-webhooks-webhookId401Example: summary: Default get-merchants-merchantId-webhooks-webhookId 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-webhooks-webhookId403Example: summary: Default get-merchants-merchantId-webhooks-webhookId 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-webhooks-webhookId422Example: summary: Default get-merchants-merchantId-webhooks-webhookId 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: get-merchants-merchantId-webhooks-webhookId500Example: summary: Default get-merchants-merchantId-webhooks-webhookId 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK patch: tags: - Merchants summary: Adyen Update a Webhook description: 'Make changes to the configuration of the webhook identified in the path. The request contains the new values you want to have in the webhook configuration. The response contains the full configuration for the webhook, which includes the new values from the request. To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Webhooks read and write' operationId: patch-merchants-merchantId-webhooks-webhookId x-sortIndex: 4 x-methodName: updateWebhook security: - BasicAuth: [] - ApiKeyAuth: [] requestBody: content: application/json: examples: patch-merchant-webhook: $ref: '#/components/examples/patch-merchants-merchantId-webhooks-webhookId-patch-merchant-webhook' schema: $ref: '#/components/schemas/UpdateMerchantWebhookRequest' parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: Unique identifier of the webhook configuration. name: webhookId in: path required: true schema: type: string responses: '200': content: application/json: examples: patch-merchant-webhook: $ref: '#/components/examples/patch-merchants-merchantId-webhooks-webhookId-patch-merchant-webhook-200' schema: $ref: '#/components/schemas/Webhook' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-webhooks-webhookId400Example: summary: Default patch-merchants-merchantId-webhooks-webhookId 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-webhooks-webhookId401Example: summary: Default patch-merchants-merchantId-webhooks-webhookId 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-webhooks-webhookId403Example: summary: Default patch-merchants-merchantId-webhooks-webhookId 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-webhooks-webhookId422Example: summary: Default patch-merchants-merchantId-webhooks-webhookId 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: patch-merchants-merchantId-webhooks-webhookId500Example: summary: Default patch-merchants-merchantId-webhooks-webhookId 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/webhooks/{webhookId}/generateHmac: post: tags: - Merchants summary: Adyen Generate an HMAC Key description: 'Returns an [HMAC key](https://en.wikipedia.org/wiki/HMAC) for the webhook identified in the path. This key allows you to check the integrity and the origin of the notifications you receive.By creating an HMAC key, you start receiving [HMAC-signed notifications](https://docs.adyen.com/development-resources/webhooks/verify-hmac-signatures#enable-hmac-signatures) from Adyen. Find out more about how to [verify HMAC signatures](https://docs.adyen.com/development-resources/webhooks/verify-hmac-signatures). To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Webhooks read and write' operationId: post-merchants-merchantId-webhooks-webhookId-generateHmac x-sortIndex: 6 x-methodName: generateHmacKey security: - BasicAuth: [] - ApiKeyAuth: [] parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - name: webhookId in: path required: true schema: type: string responses: '200': content: application/json: examples: post-merchant-webhook-generateHmac: $ref: '#/components/examples/post-merchants-merchantId-webhooks-webhookId-generateHmac-post-merchant-webhook-generateHmac-200' schema: $ref: '#/components/schemas/GenerateHmacKeyResponse' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-webhooks-webhookId-generateHmac400Example: summary: Default post-merchants-merchantId-webhooks-webhookId-generateHmac 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-webhooks-webhookId-generateHmac401Example: summary: Default post-merchants-merchantId-webhooks-webhookId-generateHmac 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-webhooks-webhookId-generateHmac403Example: summary: Default post-merchants-merchantId-webhooks-webhookId-generateHmac 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-webhooks-webhookId-generateHmac422Example: summary: Default post-merchants-merchantId-webhooks-webhookId-generateHmac 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-webhooks-webhookId-generateHmac500Example: summary: Default post-merchants-merchantId-webhooks-webhookId-generateHmac 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK /merchants/{merchantId}/webhooks/{webhookId}/test: post: tags: - Merchants summary: Adyen Test a Webhook description: 'Sends sample notifications to test if the webhook is set up correctly. We send four test notifications for each event code you choose. They cover success and failure scenarios for the hard-coded currencies EUR and GBP, regardless of the currencies configured in the merchant accounts. For custom notifications, we only send the specified custom notification. The response describes the result of the test. The `status` field tells you if the test was successful or not. You can use the other fields to troubleshoot unsuccessful tests. To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Webhooks read and write' operationId: post-merchants-merchantId-webhooks-webhookId-test x-sortIndex: 7 x-methodName: testWebhook security: - BasicAuth: [] - ApiKeyAuth: [] requestBody: content: application/json: examples: post-merchant-webhook-test: $ref: '#/components/examples/post-merchants-merchantId-webhooks-webhookId-test-post-merchant-webhook-test' schema: $ref: '#/components/schemas/TestWebhookRequest' parameters: - description: The unique identifier of the merchant account. name: merchantId in: path required: true schema: type: string - description: Unique identifier of the webhook configuration. name: webhookId in: path required: true schema: type: string responses: '200': content: application/json: examples: post-merchant-webhook-test: $ref: '#/components/examples/post-merchants-merchantId-webhooks-webhookId-test-post-merchant-webhook-test-200' schema: $ref: '#/components/schemas/TestWebhookResponse' description: OK - the request has succeeded. '204': description: No Content - the request has been successfully processed, but there is no additional content. '400': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-webhooks-webhookId-test400Example: summary: Default post-merchants-merchantId-webhooks-webhookId-test 400 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Bad Request - a problem reading or understanding the request. '401': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-webhooks-webhookId-test401Example: summary: Default post-merchants-merchantId-webhooks-webhookId-test 401 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unauthorized - authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-webhooks-webhookId-test403Example: summary: Default post-merchants-merchantId-webhooks-webhookId-test 403 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Forbidden - insufficient permissions to process the request. '422': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-webhooks-webhookId-test422Example: summary: Default post-merchants-merchantId-webhooks-webhookId-test 422 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Unprocessable Entity - a request validation error. '500': content: application/json: schema: $ref: '#/components/schemas/RestServiceError' examples: post-merchants-merchantId-webhooks-webhookId-test500Example: summary: Default post-merchants-merchantId-webhooks-webhookId-test 500 response x-microcks-default: true value: detail: example_value errorCode: CODE123 instance: example_value invalidFields: - example_value requestId: '500123' response: example_value status: 500 title: example_value type: standard description: Internal Server Error - the server could not process the request. x-microcks-operation: delay: 0 dispatcher: FALLBACK components: examples: get-merchants-merchantId-apiCredentials-success-200: summary: List of API credentials at the merchant level description: Example response when your API credential has access to 11 API credentials at the merchant level value: _links: first: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials?pageNumber=1&pageSize=10 last: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials?pageNumber=2&pageSize=10 next: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials?pageNumber=2&pageSize=10 self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials?pageNumber=1&pageSize=10 itemsTotal: 11 pagesTotal: 2 data: - id: YOUR_API_CREDENTIAL_1 username: YOUR_USERNAME_1 clientKey: YOUR_CLIENT_KEY_1 allowedIpAddresses: [] roles: - Merchant Report Download role active: true _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_CREDENTIAL_1 allowedOrigins: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_CREDENTIAL_1/allowedOrigins generateApiKey: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_CREDENTIAL_1/generateApiKey generateClientKey: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_CREDENTIAL_1/generateClientKey merchant: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT - id: YOUR_API_CREDENTIAL_2 username: YOUR_USERNAME_2 clientKey: YOUR_CLIENT_KEY_2 allowedIpAddresses: [] roles: - Merchant Rss feed role active: true _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_2 allowedOrigins: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_2/allowedOrigins generateApiKey: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_2/generateApiKey generateClientKey: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_2/generateClientKey merchant: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT - id: YOUR_API_CREDENTIAL_3 username: YOUR_USERNAME_3 clientKey: YOUR_CLIENT_KEY_3 allowedIpAddresses: [] roles: - Merchant iDeal-API Webservice role - Management API - Accounts read - Management API - API credentials read and write - Management API — Payment methods read - Merchant PAL Donation role - Merchant PAL Charity role - Checkout encrypted cardholder data - Checkout webservice role - Store payout detail and submit payout - withdrawal - Management API - Accounts read and write - Management API - Webhooks read - Merchant Payout role - API tokenise payment details - General API Payments role - API Supply MPI data with Payments - API Authorise Referred Payments - API PCI Payments role - CSC Tokenization Webservice role - Management API - Stores read - API Payment RefundWithData - API Clientside Encryption Payments role - API to retrieve authentication data - Management API - Stores read and write - Management API - Webhooks read and write - Mastercard inControl service - Merchant Recurring role - Management API - Payout Account Settings Read - API surcharge cost estimation and regulatory information - Store payout detail - Merchant PAL Webservice role active: true allowedOrigins: - id: YOUR_ALLOWED_ORIGIN_1 domain: YOUR_DOMAIN_1 _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_3/allowedOrigins/YOUR_ALLOWED_ORIGIN_1 - id: YOUR_ALLOWED_ORIGIN_2 domain: YOUR_DOMAIN_2 _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_3/allowedOrigins/YOUR_ALLOWED_ORIGIN_2 _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_3 allowedOrigins: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_3/allowedOrigins generateApiKey: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_3/generateApiKey generateClientKey: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_3/generateClientKey merchant: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT - id: YOUR_API_CREDENTIAL_4 username: YOUR_USERNAME_4 clientKey: YOUR_CLIENT_KEY_4 allowedIpAddresses: [] roles: - API Clientside Encryption Payments role - API tokenise payment details - General API Payments role - Checkout encrypted cardholder data - Merchant Recurring role - API PCI Payments role - CSC Tokenization Webservice role - Checkout webservice role - ThreeDSecure WebService Role - Merchant PAL Webservice role active: true _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_4 allowedOrigins: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_4/allowedOrigins generateApiKey: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_4/generateApiKey generateClientKey: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_4/generateClientKey merchant: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT - id: YOUR_API_CREDENTIAL_5 username: YOUR_USERNAME_5 clientKey: YOUR_CLIENT_KEY_5 allowedIpAddresses: [] roles: - Merchant iDeal-API Webservice role - General API Payments role - Checkout encrypted cardholder data - Merchant Recurring role - Checkout webservice role - Merchant PAL Webservice role active: true _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_5 allowedOrigins: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_5/allowedOrigins generateApiKey: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_5/generateApiKey generateClientKey: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_5/generateClientKey merchant: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT - id: YOUR_API_CREDENTIAL_6 username: YOUR_USERNAME_6 clientKey: YOUR_CLIENT_KEY_6 allowedIpAddresses: [] roles: - Checkout encrypted cardholder data - Merchant Recurring role - API PCI Payments role - Checkout webservice role - Merchant PAL Webservice role active: true _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_6 allowedOrigins: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_6/allowedOrigins generateApiKey: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_6/generateApiKey generateClientKey: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_6/generateClientKey merchant: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT - id: YOUR_API_CREDENTIAL_7 username: YOUR_USERNAME_7 clientKey: YOUR_CLIENT_KEY_7 allowedIpAddresses: [] roles: - Checkout encrypted cardholder data - Checkout webservice role - Merchant PAL Webservice role active: true _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_7 allowedOrigins: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_7/allowedOrigins generateApiKey: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_7/generateApiKey generateClientKey: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_7/generateClientKey merchant: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT - id: YOUR_API_CREDENTIAL_8 username: YOUR_USERNAME_8 clientKey: YOUR_CLIENT_KEY_8 allowedIpAddresses: [] roles: - Checkout encrypted cardholder data - Merchant Recurring role - Checkout webservice role - Merchant PAL Webservice role active: true _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_8 allowedOrigins: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_8/allowedOrigins generateApiKey: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_8/generateApiKey generateClientKey: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_8/generateClientKey merchant: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT - id: YOUR_API_CREDENTIAL_9 username: YOUR_USERNAME_9 clientKey: YOUR_CLIENT_KEY_9 allowedIpAddresses: [] roles: - Checkout encrypted cardholder data - Merchant Recurring role - API PCI Payments role - Checkout webservice role - Merchant PAL Webservice role active: true _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_9 allowedOrigins: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_9/allowedOrigins generateApiKey: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_9/generateApiKey generateClientKey: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_9/generateClientKey merchant: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT - id: YOUR_API_CREDENTIAL_10 username: YOUR_USERNAME_10 clientKey: YOUR_CLIENT_KEY_10 allowedIpAddresses: [] roles: - Checkout encrypted cardholder data - Merchant Recurring role - Checkout webservice role - Merchant PAL Webservice role active: true _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_10 allowedOrigins: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_10/allowedOrigins generateApiKey: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_10/generateApiKey generateClientKey: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_10/generateClientKey merchant: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT patch-merchants-merchantId-terminalOrders-orderId-update-order: summary: Update a terminal order description: Example request to update an order for terminal products value: shippingLocation: S2-73536B20665526704F30792642212044452F714622375D477270 items: - id: TBOX-V400m-684-EU name: V400m Package quantity: 1 - id: PART-287001-EU name: Bluetooth Charging Base - V400m quantity: 2 - id: PART-620222-EU name: Receipt Roll quantity: 20 patch-merchants-merchantId-stores-storeId-patch-stores: summary: Update store address. description: Example request to update the address of a store value: address: line1: 1776 West Pinewood Avenue line2: Heartland Building line3: '' postalCode: '20251' patch-merchants-merchantId-stores-reference-terminalSettings-add-eap-peap-and-psk-wifi-profiles-200: summary: Response code - 200 OK description: Example response for adding an EAP-PEAP Wi-Fi profile and a PSK Wi-Fi profile for a terminal value: cardholderReceipt: headerForAuthorizedReceipt: header1,header2,filler gratuities: - currency: EUR usePredefinedTipEntries: true predefinedTipEntries: - '100' - 1% - 5% allowCustomAmount: true nexo: displayUrls: localUrls: - password: BASIC_AUTH_PASSWORD url: https://your-display-notifications-endpoint.com username: BASIC_AUTH_USERNAME encryptionKey: identifier: KEY_IDENTIFIER passphrase: KEY_PASSPHRASE version: 1 eventUrls: eventPublicUrls: - password: BASIC_AUTH_PASSWORD url: https://your-event-notifications-endpoint.com username: BASIC_AUTH_USERNAME opi: enablePayAtTable: true payAtTableStoreNumber: '1' payAtTableURL: https:/your-pay-at-table-endpoint.com offlineProcessing: chipFloorLimit: 0 receiptOptions: qrCodeData: http://www.example.com/order/${pspreference}/${merchantreference} receiptPrinting: shopperApproved: true shopperRefused: true shopperCancelled: true shopperRefundApproved: true shopperRefundRefused: true shopperVoid: true signature: askSignatureOnScreen: true skipSignature: false deviceName: Amsterdam-236203386 wifiProfiles: profiles: - authType: wpa-eap autoWifi: false bssType: infra channel: 0 defaultProfile: true eap: peap eapCaCert: data: MD1rKS05M2JqRVFNQ...RTtLH1tLWo= name: eap-peap-ca.pem eapIdentity: admin eapIntermediateCert: data: PD3tUS1CRDdJTiGDR...EFoLS0tLQg= name: eap-peap-client.pem eapPwd: EAP_PEAP_PASSWORD name: Profile-eap-peap-1 ssid: your-network wsec: ccmp - authType: wpa-psk autoWifi: false bssType: infra channel: 0 defaultProfile: false name: Profile-guest-wifi psk: WIFI_PASSWORD ssid: your-network wsec: ccmp settings: band: 2.4GHz roaming: true timeout: 5 timeouts: fromActiveToSleep: 30 hardware: displayMaximumBackLight: 75 post-merchants-merchantId-paymentMethodSettings-paymentMethodId-addApplePayDomains-add-applepay-domain: summary: Add an Apple Pay domain description: Example request to add an Apple Pay domain value: domains: - https://example.com patch-merchants-merchantId-terminalLogos-remove-logo: summary: Remove logo to restore the logo from a higher level description: Example request to remove the payment terminal logo configured at the current level, and inherit the logo from a higher level value: data: '' patch-merchants-merchantId-terminalLogos-remove-logo-200: summary: Response code - 200 OK description: Example response for removing a payment terminal logo to restore the logo from a higher level value: data: LOGO_INHERITED_FROM_HIGHER_LEVEL_BASE-64_ENCODED_STRING patch-merchants-merchantId-stores-reference-terminalLogos-remove-logo: summary: Remove logo to restore the logo from a higher level description: Example request to remove the payment terminal logo configured at the current level, and inherit the logo from a higher level value: data: '' patch-merchants-merchantId-stores-storeId-patch-stores-splitConfiguration: summary: Add split configuration to store description: Example request to add a split configuration to the store value: splitConfiguration: balanceAccountId: BA3227C223222H5HQ2XX77VVH splitConfigurationId: SCNF4224P22322585HPCX384JV6JGX get-merchants-merchantId-webhooks-get-merchant-webhooks-200: summary: OK 200 - Get the list of webhook configurations description: Example response for getting the list of webhook configurations. value: _links: first: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/webhooks?pageNumber=1&pageSize=10 last: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/webhooks?pageNumber=1&pageSize=10 self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/webhooks?pageNumber=1&pageSize=10 itemsTotal: 1 pagesTotal: 1 data: - id: S2-3E5E42476641 type: standard url: YOUR_WEBHOOK_URL description: Webhook for YOUR_MERCHANT_ACCOUNT - YOUR_MERCHANT_CODE username: '' hasPassword: false active: true hasError: false sslVersion: TLSv1.2 communicationFormat: json acceptsExpiredCertificate: false acceptsSelfSignedCertificate: false acceptsUntrustedRootCertificate: false populateSoapActionHeader: false additionalSettings: properties: includePosTerminalInfo: false includeARN: false includePosDetails: false includeCardInfoForRecurringContractNotification: false includeRiskData: false includeRiskExperimentReference: false includeSoapSecurityHeader: false includeContactlessWalletTokenInformation: false includeAcquirerReference: false includeRiskProfileReference: false includeOriginalMerchantReferenceCancelOrRefundNotification: false includeNfcTokenInformation: false includeSubvariant: false includeThreeDSVersion: false includeInstallmentsInfo: false includeAliasInfo: false includeShopperCountry: false includeRawThreeDSecureResult: false includeAirlineData: false includeGrossCurrencyChargebackDetails: false includeThreeDSecureResult: false includeMetadataIn3DSecurePaymentNotification: false includeOriginalReferenceForChargebackReversed: false addAcquirerResult: false includeDeliveryAddress: false includeRetryAttempts: false includeExtraCosts: false includeCardHolderName: false includeShopperDetail: false includeBankAccountDetails: false includeMandateDetails: false includeAuthAmountForDynamicZeroAuth: false includeIssuerCountry: false includeAcquirerErrorDetails: false includeCoBrandedWith: false includeShopperInteraction: false includeDeviceAndBrowserInfo: false addRawAcquirerResult: false includeCardBin: false includeFundingSource: false includeThreeDS2ChallengeInformation: false includeRiskProfile: false includeRealtimeAccountUpdaterStatus: false includeDunningProjectData: false includePaymentResultInOrderClosedNotification: false includeCardBinDetails: false includeNotesInManualReviewNotifications: false includeZeroAuthFlag: false addCaptureReferenceToDisputeNotification: false includePayPalDetails: false includeRawThreeDSecureDetailsResult: false includeBankVerificationResults: false includeCaptureDelayHours: false addPaymentAccountReference: false includePayULatamDetails: false includeStore: false returnAvsData: false includeWeChatPayOpenid: false includeUpiVpa: false includeCustomRoutingFlagging: false includeTokenisedPaymentMetaData: false _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/webhooks/S2-3E5E42476641 generateHmac: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/webhooks/S2-3E5E42476641/generateHmac merchant: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT testWebhook: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/webhooks/S2-3E5E42476641/test post-merchants-merchantId-paymentMethodSettings-01.add-payment-method-visa-200: summary: Response code - 200 OK description: Example response after sending a request to add Visa as a payment method value: businessLineId: BL322KV223222D5F8H2J4BQ6C id: PM3227C223224K5FH84M8CBNH type: visa storeId: ST322LJ223223K5F4SQNR9XL5 enabled: true countries: - NL currencies: - EUR allowed: false verificationStatus: pending post-merchants-post-merchants: summary: Create a merchant account for an Adyen for Platforms Manage integration description: Example request for creating a merchant account value: companyId: YOUR_COMPANY_ACCOUNT legalEntityId: YOUR_LEGAL_ENTITY_ID businessLineId: YOUR_BUSINESS_LINE_ID description: YOUR_DESCRIPTION reference: YOUR_OWN_REFERENCE get-merchants-merchantId-terminalProducts-success-200: summary: Response code - 200 OK description: Example response with V400m products available in Spain value: data: - id: PART-620222-EU name: Receipt Roll price: currency: EUR value: 0 - id: PART-175746-EU name: Adyen Test Card price: currency: EUR value: 0 - id: PART-327486-EU name: Battery - V400m price: currency: EUR value: 0 - id: PART-287001-EU name: Bluetooth Charging Base - V400m price: currency: EUR value: 0 - id: PART-745984-EU name: Power Supply EU - V400m price: currency: EUR value: 0 - id: TBOX-V400m-684-EU name: V400m Package description: Includes an EU Power Supply, SIM Card and battery price: currency: EUR value: 0 itemsIncluded: - Receipt Roll - Terminal Device V400m EU/GB patch-merchants-merchantId-stores-reference-terminalLogos-upload-logo-200: summary: Response code - 200 OK description: Example response for uploading a payment terminal logo value: data: BASE-64_ENCODED_STRING_FROM_THE_REQUEST get-merchants-merchantId-stores-reference-terminalSettings-success-200: summary: Response code - 200 OK description: Example response when getting the settings of a payment terminal value: cardholderReceipt: headerForAuthorizedReceipt: header1,header2,filler gratuities: - currency: EUR usePredefinedTipEntries: true predefinedTipEntries: - '100' - 1% - 5% allowCustomAmount: true nexo: nexoEventUrls: - https://your-event-notifications-endpoint.com opi: enablePayAtTable: true payAtTableStoreNumber: '1' payAtTableURL: https:/your-pay-at-table-endpoint.com receiptOptions: {} receiptPrinting: shopperApproved: true shopperRefused: true shopperCancelled: true shopperRefundApproved: true shopperRefundRefused: true shopperVoid: true signature: askSignatureOnScreen: true skipSignature: false deviceName: Amsterdam-236203386 wifiProfiles: profiles: - authType: wpa-psk autoWifi: false bssType: infra channel: 0 defaultProfile: true name: Guest Wi-Fi psk: 4R8R2R3V456X ssid: G470P37660D4G wsec: ccmp settings: band: All roaming: true timeouts: fromActiveToSleep: 30 hardware: displayMaximumBackLight: 75 patch-merchants-merchantId-stores-storeId-patch-stores-splitConfiguration-200: summary: Split configuration added to store description: Example response after adding a split confuguration to the store value: id: YOUR_STORE_ID address: country: US line1: 1776 West Pinewood Avenue line2: Heartland Building line3: '' city: Springfield stateOrProvince: NY postalCode: '20251' description: City centre store merchantId: YOUR_MERCHANT_ACCOUNT_ID shopperStatement: Springfield Shop phoneNumber: '+1813702551707653' reference: Spring_store_2 splitConfiguration: balanceAccountId: BA3227C223222H5HQ2XX77VVH splitConfigurationId: SCNF4224P22322585HPCX384JV6JGX status: active _links: self: href: https://management-test.adyen.com/v1/stores/YOUR_STORE_ID patch-merchants-merchantId-apiCredentials-apiCredentialId-patch-merchant-credential-200: summary: OK 200 - Activate an API credential description: Example response for activating an API credential. value: id: YOUR_API_CREDENTIAL username: YOUR_USERNAME clientKey: YOUR_CLIENT_KEY allowedIpAddresses: [] roles: - Checkout webservice role - Merchant PAL Webservice role active: true allowedOrigins: - id: YOUR_ALLOWED_ORIGIN domain: https://www.mystore.com _links: self: href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL/allowedOrigins/YOUR_ALLOWED_ORIGIN _links: self: href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL allowedOrigins: href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL/allowedOrigins generateApiKey: href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL/generateApiKey generateClientKey: href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL/generateClientKey merchant: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT post-merchants-merchantId-terminalOrders-create-order-200: summary: Response code - 200 OK description: Example response after creating an order for terminal products value: id: '4154567890100682' customerOrderReference: YOUR_REFERENCE status: Placed shippingLocation: id: S2-6A6C2E3432747D4F2F2C3455485E3836457D name: YOUR_COMPANY Spain contact: firstName: Pablo lastName: Mengano phoneNumber: '+34911234567' email: Pablo.Mengano@company.com address: streetAddress: Paseo de la Castellana 43 streetAddress2: 7 piso postalCode: '28046' city: Madrid country: ES billingEntity: id: MerchantAccount.YOUR_MERCHANT_ACCOUNT name: YOUR_MERCHANT_ACCOUNT taxId: ES1234567890 email: Pablo.Mengano@company.com address: streetAddress: Paseo de la Castellana 43, 7 postalCode: '28046' city: Madrid country: ES orderDate: '2022-01-21T16:12:33Z' items: - id: PART-287001-EU name: Bluetooth Charging Base - V400m quantity: 2 - id: PART-620222-EU name: Receipt Roll quantity: 20 post-merchants-merchantId-paymentMethodSettings-02.add-payment-method-partner-model-200: summary: Response code - 200 OK description: Example response after sending a request to add Swish in a partner model setup value: id: PM3227C223224K5FH84M8CBNH businessLineId: BL322KV223222D5F8H2J4BQ6C storeIds: - ST322LJ223223K5F4SQNR9XL5 type: swish countries: - SE currencies: - SEK swish: swishNumber: '1231111111' patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId-patch-splitConfiguration-rule: summary: Update the conditions in split configuration rule description: Example request for updating the conditions of a rule in a split configuration value: currency: EUR fundingSource: ANY paymentMethod: visa shopperInteraction: ANY post-merchants-merchantId-stores-post-stores-200: summary: Response code - 200 OK description: Example response after creating a store value: id: YOUR_STORE_ID address: country: US line1: 200 Main Street line2: Building 5A line3: Suite 3 city: Springfield stateOrProvince: NY postalCode: '20250' description: City centre store merchantId: YOUR_MERCHANT_ACCOUNT_ID shopperStatement: Springfield Shop phoneNumber: '1813702551707653' reference: Spring_store_2 status: active _links: self: href: https://management-test.adyen.com/v1/stores/YOUR_STORE_ID patch-merchants-merchantId-splitConfigurations-splitConfigurationId-patch-splitConfiguration-description: summary: Update split configuration description description: Example request for updating the description of a split configuration value: description: Updated description for the split configuration patch-merchants-merchantId-webhooks-webhookId-patch-merchant-webhook: summary: Activate the webhook description: Example request for activating a webhook configuration. value: active: true post-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-add-allowed-origin-200: summary: OK 200 - Add an allowed origin for the API credential description: Example response for adding an allowed origin for the API credential. value: id: YOUR_ALLOWED_ORIGIN domain: https://www.eu.mystore.com _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL/allowedOrigins/YOUR_ALLOWED_ORIGIN get-merchants-merchantId-terminalModels-success-200: summary: Response code - 200 OK description: Example response with the terminal models that the merchant account has access to value: data: - id: Verifone.e315 name: Verifone e315 - id: Verifone.e315M name: Verifone e315M - id: Verifone.E355 name: Verifone E355 - id: Verifone.M400 name: Verifone M400 - id: Verifone.MX915 name: Verifone MX915 - id: Verifone.MX925 name: Verifone MX925 - id: Verifone.P400 name: Verifone P400 - id: Verifone.P400Plus name: Verifone P400Plus - id: Verifone.P400Eth name: Verifone P400Eth - id: Verifone.V240m name: Verifone V240m - id: Verifone.V240mPlus name: Verifone V240mPlus - id: Verifone.UX300 name: Verifone UX300 - id: Verifone.V200cPlus name: Verifone V200cPlus - id: Verifone.V400cPlus name: Verifone V400cPlus - id: Verifone.V400m name: Verifone V400m - id: Verifone.V210mPlus name: Verifone V210mPlus - id: Verifone.VX520 name: Verifone VX520 - id: Verifone.VX6753G name: Verifone VX6753G - id: Verifone.VX675WIFIBT name: Verifone VX675WIFIBT - id: Verifone.VX680 name: Verifone VX680 - id: Verifone.VX6803G name: Verifone VX6803G - id: Verifone.VX690 name: Verifone VX690 - id: Verifone.VX700 name: Verifone VX700 - id: Verifone.VX810 name: Verifone VX810 - id: Verifone.VX820 name: Verifone VX820 - id: Verifone.VX825 name: Verifone VX825 - id: Verifone.e285 name: Verifone e285 - id: Verifone.E285 name: Verifone E285 - id: Verifone.e285p name: Verifone e285p - id: Verifone.e280 name: Verifone e280 - id: Verifone.UX410 name: Verifone UX410 - id: Castles.S1E name: Castles S1E - id: Castles.S1EL name: Castles S1EL - id: Castles.S1F name: Castles S1F - id: Castles.S1F2 name: Castles S1F2 - id: Castles.S1F2L name: Castles S1F2L - id: Castles.S1E2 name: Castles S1E2 - id: Castles.S1E2L name: Castles S1E2L get-merchants-merchantId-terminalOrders-success-200: summary: Response code - 200 OK description: Example response with the terminal orders for a merchant account value: data: - id: '4154567890100682' customerOrderReference: YOUR_REFERENCE_M2 status: Placed shippingLocation: id: S2-6A6C2E3432747D4F2F2C3455485E3836457D name: YOUR_COMPANY Spain contact: firstName: Pablo lastName: Mengano phoneNumber: '+34911234567' email: Pablo.Mengano@company.com address: streetAddress: Paseo de la Castellana 43 streetAddress2: 7 piso postalCode: '28046' city: Madrid country: ES billingEntity: id: MerchantAccount.YOUR_MERCHANT_ACCOUNT name: YOUR_MERCHANT_ACCOUNT taxId: ES1234567890 email: Pablo.Mengano@company.com address: streetAddress: Paseo de la Castellana 43, 7 postalCode: '28046' city: Madrid country: ES orderDate: '2022-01-21T16:12:33Z' items: - id: PART-287001-EU name: Bluetooth Charging Base - V400m quantity: 2 - id: PART-620222-EU name: Receipt Roll quantity: 20 - id: '8315943674501996' customerOrderReference: YOUR_REFERENCE_M1 status: Cancelled shippingLocation: id: S2-6A6C2E3432747D4F2F2C3455485E3836457D name: YOUR_COMPANY Spain contact: firstName: Pablo lastName: Mengano phoneNumber: '+34911234567' email: Pablo.Mengano@company.com address: streetAddress: Paseo de la Castellana 43 streetAddress2: 7 piso postalCode: '28046' city: Madrid country: ES billingEntity: id: MerchantAccount.YOUR_MERCHANT_ACCOUNT name: YOUR_MERCHANT_ACCOUNT taxId: ES1234567890 email: Pablo.Mengano@company.com address: streetAddress: Paseo de la Castellana 43, 7 postalCode: '28046' city: Madrid country: ES orderDate: '2022-01-04T09:41:07.000Z' items: - id: TBOX-V400m-774-EU name: V400m Package quantity: 1 patch-merchants-merchantId-terminalSettings-add-eap-tls-wifi-profile-200: summary: Response code - 200 OK description: Example response for adding an EAP-TLS Wi-Fi profile for a terminal value: cardholderReceipt: headerForAuthorizedReceipt: header1,header2,filler gratuities: - currency: EUR usePredefinedTipEntries: true predefinedTipEntries: - '100' - 1% - 5% allowCustomAmount: true nexo: nexoEventUrls: - https://your-event-notifications-endpoint.com opi: enablePayAtTable: true payAtTableStoreNumber: '1' payAtTableURL: https:/your-pay-at-table-endpoint.com offlineProcessing: chipFloorLimit: 0 receiptOptions: qrCodeData: http://www.example.com/order/${pspreference}/${merchantreference} receiptPrinting: shopperApproved: true shopperRefused: true shopperCancelled: true shopperRefundApproved: true shopperRefundRefused: true shopperVoid: true signature: askSignatureOnScreen: true skipSignature: false deviceName: Amsterdam-236203386 wifiProfiles: profiles: - authType: wpa-eap autoWifi: false bssType: infra channel: 0 defaultProfile: true eap: tls eapCaCert: data: LS0tLS05M2JqRVFNQ...EUtLS0tLQo= name: eap-tls-ca.pem eapClientCert: data: LS0tLS1CRUdJTiBDR...EUtLS0tLQo= name: eap-tls-client.pem eapClientKey: data: AAAB3NzaC1...Rtah3KLFwPU= name: rsa-private.key eapClientPwd: '' eapIdentity: admin hiddenSsid: false name: Profile-eap-tls-1 ssid: your-network wsec: ccmp settings: band: 2.4GHz roaming: true timeout: 5 timeouts: fromActiveToSleep: 30 hardware: displayMaximumBackLight: 75 patch-merchants-merchantId-stores-reference-terminalLogos-remove-logo-200: summary: Response code - 200 OK description: Example response for removing a payment terminal logo to restore the logo from a higher level value: data: LOGO_INHERITED_FROM_HIGHER_LEVEL_BASE-64_ENCODED_STRING get-merchants-merchantId-billingEntities-success-200: summary: Response code - 200 OK description: Example response with billing entities for a merchant account value: data: - id: MerchantAccount.YOUR_MERCHANT_ACCOUNT name: YOUR_MERCHANT_ACCOUNT taxId: ES1234567890 email: Pablo.Mengano@company.com address: streetAddress: Paseo de la Castellana 43, 7 postalCode: '28046' city: Madrid country: ES post-merchants-merchantId-webhooks-post-merchant-webhook: summary: Add a webhook configuration description: Example request for adding a standard webhook configuration. value: type: standard url: YOUR_WEBHOOK_URL username: YOUR_USER password: YOUR_PASSWORD active: true sslVersion: TLSv1.2 communicationFormat: json acceptsExpiredCertificate: false acceptsSelfSignedCertificate: true acceptsUntrustedRootCertificate: true populateSoapActionHeader: false patch-merchants-merchantId-terminalLogos-upload-logo-200: summary: Response code - 200 OK description: Example response for uploading a payment terminal logo value: data: BASE-64_ENCODED_STRING_FROM_THE_REQUEST get-merchants-merchantId-webhooks-webhookId-get-merchant-webhook-200: summary: OK 200 - Get a webhook configuration description: Example response for getting a webhook configuration. value: id: S2-3E5E42476641 type: standard url: YOUR_WEBHOOK_URL description: Webhook for YOUR_MERCHANT_ACCOUNT - YOUR_MERCHANT_CODE username: '' hasPassword: false active: true hasError: false sslVersion: TLSv1.2 communicationFormat: json acceptsExpiredCertificate: false acceptsSelfSignedCertificate: false acceptsUntrustedRootCertificate: false populateSoapActionHeader: false additionalSettings: properties: includePosTerminalInfo: false includeARN: false includePosDetails: false includeCardInfoForRecurringContractNotification: false includeRiskData: false includeRiskExperimentReference: false includeSoapSecurityHeader: false includeContactlessWalletTokenInformation: false includeAcquirerReference: false includeRiskProfileReference: false includeOriginalMerchantReferenceCancelOrRefundNotification: false includeNfcTokenInformation: false includeSubvariant: false includeThreeDSVersion: false includeInstallmentsInfo: false includeAliasInfo: false includeShopperCountry: false includeRawThreeDSecureResult: false includeAirlineData: false includeGrossCurrencyChargebackDetails: false includeThreeDSecureResult: false includeMetadataIn3DSecurePaymentNotification: false includeOriginalReferenceForChargebackReversed: false addAcquirerResult: false includeDeliveryAddress: false includeRetryAttempts: false includeExtraCosts: false includeCardHolderName: false includeShopperDetail: false includeBankAccountDetails: false includeMandateDetails: false includeAuthAmountForDynamicZeroAuth: false includeIssuerCountry: false includeAcquirerErrorDetails: false includeCoBrandedWith: false includeShopperInteraction: false includeDeviceAndBrowserInfo: false addRawAcquirerResult: false includeCardBin: false includeFundingSource: false includeThreeDS2ChallengeInformation: false includeRiskProfile: false includeRealtimeAccountUpdaterStatus: false includeDunningProjectData: false includePaymentResultInOrderClosedNotification: false includeCardBinDetails: false includeNotesInManualReviewNotifications: false includeZeroAuthFlag: false addCaptureReferenceToDisputeNotification: false includePayPalDetails: false includeRawThreeDSecureDetailsResult: false includeBankVerificationResults: false includeCaptureDelayHours: false addPaymentAccountReference: false includePayULatamDetails: false includeStore: false returnAvsData: false includeWeChatPayOpenid: false includeUpiVpa: false includeCustomRoutingFlagging: false includeTokenisedPaymentMetaData: false _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/webhooks/S2-3E5E42476641 generateHmac: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/webhooks/S2-3E5E42476641/generateHmac merchant: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT testWebhook: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/webhooks/S2-3E5E42476641/test get-merchants-success-200: summary: List of merchant accounts description: Example response when your API credential has access to 23 merchant accounts value: _links: first: href: https://management-test.adyen.com/v1/merchants?pageNumber=1&pageSize=10 last: href: https://management-test.adyen.com/v1/merchants?pageNumber=3&pageSize=10 next: href: https://management-test.adyen.com/v1/merchants?pageNumber=2&pageSize=10 self: href: https://management-test.adyen.com/v1/merchants?pageNumber=1&pageSize=10 itemsTotal: 23 pagesTotal: 3 data: - id: YOUR_MERCHANT_ACCOUNT_1 name: YOUR_MERCHANT_NAME_1 captureDelay: immediate defaultShopperInteraction: Ecommerce status: Active shopWebAddress: YOUR_SHOP_URL_1 merchantCity: Amsterdam primarySettlementCurrency: EUR _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_1 apiCredentials: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_1/apiCredentials users: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_1/users webhooks: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_1/webhooks - id: YOUR_MERCHANT_ACCOUNT_2 name: YOUR_MERCHANT_NAME_2 captureDelay: immediate defaultShopperInteraction: POS status: Active shopWebAddress: YOUR_SHOP_URL_2 merchantCity: '' primarySettlementCurrency: EUR _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_2 apiCredentials: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_2/apiCredentials users: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_2/users webhooks: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_2/webhooks - id: YOUR_MERCHANT_ACCOUNT_3 status: YOUR_MERCHANT_NAME_3 merchantCity: Amsterdam primarySettlementCurrency: EUR _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_3 apiCredentials: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_3/apiCredentials users: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_3/users webhooks: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_3/webhooks - id: YOUR_MERCHANT_ACCOUNT_4 name: YOUR_MERCHANT_NAME_4 captureDelay: immediate defaultShopperInteraction: Ecommerce status: Active shopWebAddress: YOUR_SHOP_URL_4 merchantCity: Sao Paulo primarySettlementCurrency: BRL _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_4 apiCredentials: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_4/apiCredentials users: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_4/users webhooks: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_4/webhooks - id: YOUR_MERCHANT_ACCOUNT_5 name: YOUR_MERCHANT_NAME_5 captureDelay: '3' defaultShopperInteraction: Ecommerce status: Active shopWebAddress: YOUR_SHOP_URL_5 primarySettlementCurrency: EUR _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_5 apiCredentials: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_5/apiCredentials users: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_5/users webhooks: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_5/webhooks - id: YOUR_MERCHANT_ACCOUNT_6 name: YOUR_MERCHANT_NAME_6 captureDelay: immediate defaultShopperInteraction: Ecommerce status: Active shopWebAddress: YOUR_SHOP_URL_6 merchantCity: Zagreb primarySettlementCurrency: BRL _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_NAME_6 apiCredentials: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_NAME_6/apiCredentials users: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_NAME_6/users webhooks: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_NAME_6/webhooks - id: YOUR_MERCHANT_ACCOUNT_7 name: YOUR_MERCHANT_NAME_7 captureDelay: manual defaultShopperInteraction: Moto status: Active shopWebAddress: YOUR_SHOP_URL_7 merchantCity: Amsterdam primarySettlementCurrency: EUR _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_7 apiCredentials: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_7/apiCredentials users: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_7/users webhooks: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_7/webhooks - id: YOUR_MERCHANT_ACCOUNT_8 name: YOUR_MERCHANT_NAME_8 captureDelay: immediate defaultShopperInteraction: Ecommerce status: Active shopWebAddress: YOUR_SHOP_URL_8 merchantCity: Amsterdam primarySettlementCurrency: EUR _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_8 apiCredentials: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_8/apiCredentials users: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_8/users webhooks: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_8/webhooks - id: YOUR_MERCHANT_ACCOUNT_9 name: YOUR_MERCHANT_NAME_9 captureDelay: '3' defaultShopperInteraction: Ecommerce status: Active shopWebAddress: YOUR_SHOP_URL_9 merchantCity: '' primarySettlementCurrency: EUR _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_9 apiCredentials: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_9/apiCredentials users: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_9/users webhooks: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_9/webhooks - id: YOUR_MERCHANT_ACCOUNT_10 name: YOUR_MERCHANT_NAME_10 captureDelay: manual defaultShopperInteraction: Ecommerce status: Active shopWebAddress: YOUR_SHOP_URL_10 merchantCity: Paris primarySettlementCurrency: EUR _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_10 apiCredentials: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_10/apiCredentials users: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_10/users webhooks: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_10/webhooks post-merchants-merchantId-stores-post-stores: summary: Create a store under the merchant account specified in the path. description: Example request to create a store value: description: City centre store shopperStatement: Springfield Shop phoneNumber: '1813702551707653' reference: Spring_store_2 address: country: US line1: 200 Main Street line2: Building 5A line3: Suite 3 city: Springfield stateOrProvince: NY postalCode: '20250' get-merchants-merchantId-terminalOrders-orderId-success-200: summary: Response code - 200 OK description: Example response with the details of the terminal products order value: id: '4154567890100682' customerOrderReference: YOUR_REFERENCE status: Placed shippingLocation: id: S2-6A6C2E3432747D4F2F2C3455485E3836457D name: YOUR_COMPANY Spain contact: firstName: Pablo lastName: Mengano phoneNumber: '+34911234567' email: Pablo.Mengano@company.com address: streetAddress: Paseo de la Castellana 43 streetAddress2: 7 piso postalCode: '28046' city: Madrid country: ES billingEntity: id: MerchantAccount.YOUR_MERCHANT_ACCOUNT name: YOUR_MERCHANT_ACCOUNT taxId: ES1234567890 email: Pablo.Mengano@company.com address: streetAddress: Paseo de la Castellana 43, 7 postalCode: '28046' city: Madrid country: ES orderDate: '2022-01-21T16:12:33Z' items: - id: PART-287001-EU name: Bluetooth Charging Base - V400m quantity: 2 - id: PART-620222-EU name: Receipt Roll quantity: 20 get-merchants-merchantId-apiCredentials-apiCredentialId-success-200: summary: Details of the API credential description: Example response with details of the API credential at the merchant level value: id: YOUR_API_CREDENTIAL username: YOUR_USERNAME clientKey: YOUR_CLIENT_KEY allowedIpAddresses: [] roles: - Merchant Report Download role active: true _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_CREDENTIAL allowedOrigins: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_CREDENTIAL/allowedOrigins generateApiKey: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_CREDENTIAL/generateApiKey generateClientKey: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_CREDENTIAL/generateClientKey merchant: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT post-merchants-merchantId-webhooks-webhookId-generateHmac-post-merchant-webhook-generateHmac-200: summary: OK 200 - Generate a webhook HMAC key description: Example response for generating a webhook HMAC. value: hmacKey: 7052E6804F0AF40DCC390464C817F4F963516FA42AC8816D518DC5D39F41E902 post-merchants-merchantId-webhooks-webhookId-test-post-merchant-webhook-test-200: summary: OK 200 - Test a webhook notification description: Example response for testing a webhook notification. value: data: - merchantId: YOUR_MERCHANT_ACCOUNT output: '[accepted]' requestSent: '{"live":"false","notificationItems":[{"NotificationRequestItem":{"amount":{"currency":"EUR","value":100},"eventCode":"AUTHORISATION","eventDate":"2022-05-10T17:02:03+02:00","merchantAccountCode":"YOUR_MERCHANT_ACCOUNT","merchantReference":"4TZLD23Y","operations":["CANCEL","CAPTURE","REFUND"],"paymentMethod":"visa","pspReference":"E05WW50L6IOBRGA0","reason":"","success":"true"}}]}' responseCode: '200' responseTime: 532 ms status: success patch-merchants-merchantId-terminalLogos-upload-logo: summary: Upload terminal logo description: Example request to upload a payment terminal logo value: data: LOGO_FILE_CONVERTED_TO_A_BASE-64_ENCODED_STRING post-merchants-merchantId-users-create-user-200: summary: Response code - 200 OK description: Example response after creating a user on the merchant level value: id: S2-3B3C3C3B22 name: firstName: John gender: UNKNOWN lastName: Smith email: john.smith@example.com timeZoneCode: Europe/Amsterdam username: johnsmith roles: - Merchant standard role active: true _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/users/S2-3B3C3C3B22 associatedMerchantAccounts: - YOUR_MERCHANT_ACCOUNT patch-merchants-merchantId-terminalSettings-add-eap-tls-wifi-profile: summary: Add EAP-TLS Wi-Fi profile description: Example request to add an EAP-TLS Wi-Fi profile for a terminal value: wifiProfiles: profiles: - authType: wpa-eap autoWifi: false bssType: infra channel: 0 defaultProfile: true eap: tls eapCaCert: data: LS0tLS05M2JqRVFNQ...EUtLS0tLQo= name: eap-tls-ca.pem eapClientCert: data: LS0tLS1CRUdJTiBDR...EUtLS0tLQo= name: eap-tls-client.pem eapClientKey: data: AAAB3NzaC1...Rtah3KLFwPU= name: rsa-private.key eapClientPwd: '' eapIdentity: admin hiddenSsid: false name: Profile-eap-tls-1 ssid: your-network wsec: ccmp settings: band: 2.4GHz roaming: true timeout: 5 patch-merchants-merchantId-apiCredentials-apiCredentialId-patch-merchant-credential: summary: Activate an API credential description: Example request for activating an API credential. value: active: true get-merchants-merchantId-terminalSettings-success-200: summary: Response code - 200 OK description: Example response when getting the settings of a payment terminal value: cardholderReceipt: headerForAuthorizedReceipt: header1,header2,filler gratuities: - currency: EUR usePredefinedTipEntries: true predefinedTipEntries: - '100' - 1% - 5% allowCustomAmount: true nexo: displayUrls: localUrls: - password: BASIC_AUTH_PASSWORD url: https://your-display-notifications-endpoint.com username: BASIC_AUTH_USERNAME encryptionKey: identifier: KEY_IDENTIFIER passphrase: KEY_PASSPHRASE version: 1 eventUrls: eventPublicUrls: - password: BASIC_AUTH_PASSWORD url: https://your-event-notifications-endpoint.com username: BASIC_AUTH_USERNAME opi: enablePayAtTable: true payAtTableStoreNumber: '1' payAtTableURL: https:/your-pay-at-table-endpoint.com offlineProcessing: chipFloorLimit: 0 receiptOptions: qrCodeData: http://www.example.com/order/${pspreference}/${merchantreference} receiptPrinting: shopperApproved: true shopperRefused: true shopperCancelled: true shopperRefundApproved: true shopperRefundRefused: true shopperVoid: true signature: askSignatureOnScreen: true skipSignature: false deviceName: Amsterdam-236203386 wifiProfiles: profiles: - authType: wpa-psk autoWifi: false bssType: infra channel: 0 defaultProfile: true hiddenSsid: false name: Guest Wi-Fi psk: 4R8R2R3V456X ssid: G470P37660D4G wsec: ccmp settings: band: All roaming: true timeouts: fromActiveToSleep: 30 hardware: displayMaximumBackLight: 75 post-merchants-merchantId-webhooks-post-merchant-webhook-200: summary: OK 200 - Add a webhook configuration description: Example response for adding a webhook configuration. value: id: S2-31433949437F type: standard url: YOUR_WEBHOOK_URL description: Webhook for YOUR_MERCHANT_ACCOUNT - YOUR_MERCHANT_CODE username: myuser hasPassword: true active: true hasError: false sslVersion: TLSv1.2 communicationFormat: json acceptsExpiredCertificate: false acceptsSelfSignedCertificate: true acceptsUntrustedRootCertificate: true certificateAlias: signed-test.adyen.com_2023 populateSoapActionHeader: false additionalSettings: properties: includePosTerminalInfo: false includeARN: false includePosDetails: false includeCardInfoForRecurringContractNotification: false includeRiskData: false includeRiskExperimentReference: false includeSoapSecurityHeader: false includeContactlessWalletTokenInformation: false includeAcquirerReference: false includeRiskProfileReference: false includeOriginalMerchantReferenceCancelOrRefundNotification: false includeNfcTokenInformation: false includeSubvariant: false includeThreeDSVersion: false includeInstallmentsInfo: false includeAliasInfo: false includeShopperCountry: false includeRawThreeDSecureResult: false includeAirlineData: false includeGrossCurrencyChargebackDetails: false includeThreeDSecureResult: false includeMetadataIn3DSecurePaymentNotification: false includeOriginalReferenceForChargebackReversed: false addAcquirerResult: false includeDeliveryAddress: false includeRetryAttempts: false includeExtraCosts: false includeCardHolderName: false includeShopperDetail: false includeBankAccountDetails: false includeMandateDetails: false includeAuthAmountForDynamicZeroAuth: false includeIssuerCountry: false includeAcquirerErrorDetails: false includeCoBrandedWith: false includeShopperInteraction: false includeDeviceAndBrowserInfo: false addRawAcquirerResult: false includeCardBin: false includeFundingSource: false includeThreeDS2ChallengeInformation: false includeRiskProfile: false includeRealtimeAccountUpdaterStatus: false includeDunningProjectData: false includePaymentResultInOrderClosedNotification: false includeCardBinDetails: false includeNotesInManualReviewNotifications: false includeZeroAuthFlag: false addCaptureReferenceToDisputeNotification: false includePayPalDetails: false includeRawThreeDSecureDetailsResult: false includeBankVerificationResults: false includeCaptureDelayHours: false addPaymentAccountReference: false includePayULatamDetails: false includeStore: false returnAvsData: false includeWeChatPayOpenid: false includeUpiVpa: false includeCustomRoutingFlagging: false includeTokenisedPaymentMetaData: false _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/webhooks/S2-31433949437F generateHmac: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/webhooks/S2-31433949437F/generateHmac merchant: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT testWebhook: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/webhooks/S2-31433949437F/test post-merchants-merchantId-users-create-user: summary: Create a user description: Example request to create a user on the merchant level value: name: firstName: John lastName: Smith username: johnsmith email: john.smith@example.com timeZoneCode: Europe/Amsterdam roles: - Merchant standard role associatedMerchantAccounts: - YOUR_MERCHANT_ACCOUNT post-merchants-merchantId-webhooks-webhookId-test-post-merchant-webhook-test: summary: Test a webhook notification description: Example request for testing a webhook notification. value: notification: paymentMethod: visa eventCode: AUTHORISATION amount: currency: EUR value: 1000 reason: Authorize visa payment success: true types: - CUSTOM post-merchants-merchantId-splitConfigurations-splitConfigurationId-post-splitConfiguration-rule: summary: Add rule to a split configuration description: Example request to add a rule to a split configuration value: paymentMethod: visa shopperInteraction: POS fundingSource: ANY currency: USD splitLogic: paymentFee: deductFromLiableAccount chargeback: deductFromLiableAccount tip: addToOneBalanceAccount remainder: addToLiableAccount commission: fixedAmount: 10 variablePercentage: 100 additionalCommission: fixedAmount: 10 variablePercentage: 50 balanceAccountId: BA3227C223222H5HQ2XX77VVH post-merchants-merchantId-splitConfigurations-post-splitConfiguration-200: summary: Split configuration created description: Example response after creating a split configuration value: description: Your description for the split configuration rules: - currency: ANY fundingSource: ANY paymentMethod: ANY ruleId: SCRL4224P22322585HPCX384JW65VW shopperInteraction: ANY splitLogic: additionalCommission: fixedAmount: 10 variablePercentage: 50 balanceAccountId: BA3227C223222H5HQ2XX77VVH chargeback: deductFromLiableAccount commission: fixedAmount: 10 variablePercentage: 100 splitLogicId: SCLG4224P22322585HPCX384JX52M2 paymentFee: deductFromLiableAccount remainder: addToOneBalanceAccount tip: addToOneBalanceAccount splitConfigurationId: SCNF4224P22322585HPCX384JV6JGX get-merchants-merchantId-terminalLogos-success-200: summary: Response code - 200 OK description: Example response when getting the logo of a payment terminal value: data: BASE-64_ENCODED_STRING get-merchants-merchantId-splitConfigurations-success-200: summary: List of split configurations description: Example response when retrieving the list of split configurations in your merchant account value: data: - description: Your description for the split configuration rules: - currency: GBP fundingSource: ANY paymentMethod: ANY ruleId: SCRL4224P22322585HP89PPCST6BCZ shopperInteraction: ANY splitLogic: additionalCommission: fixedAmount: 100 variablePercentage: 100 balanceAccountId: BA3227C223222H5HQ2XX77VVH chargeback: deductFromLiableAccount commission: fixedAmount: 200 variablePercentage: 100 splitLogicId: SCLG4224P22322585HP89PPCSV27VP paymentFee: deductFromLiableAccount remainder: addToOneBalanceAccount tip: addToOneBalanceAccount splitConfigurationId: SCNF4224P22322585HP89PPCSS24MF - description: Your description for the second split configuration rules: - currency: ANY fundingSource: ANY paymentMethod: ANY ruleId: SCRL4224P22322585HPCX384JW65VW shopperInteraction: ANY splitLogic: additionalCommission: fixedAmount: 10 variablePercentage: 50 balanceAccountId: BA3227C223222H5HQ2XX77VVH chargeback: deductFromLiableAccount commission: fixedAmount: 10 variablePercentage: 100 splitLogicId: SCLG4224P22322585HPCX384JX52M2 paymentFee: deductFromLiableAccount remainder: addToOneBalanceAccount tip: addToOneBalanceAccount - currency: EUR fundingSource: ANY paymentMethod: visa ruleId: SCRL4224P22322585HPCX5V4KV6L2R shopperInteraction: ANY splitLogic: additionalCommission: fixedAmount: 100 variablePercentage: 0 balanceAccountId: BA3227C223222H5HQ2XX77VVH chargeback: deductFromLiableAccount commission: fixedAmount: 100 variablePercentage: 100 splitLogicId: SCLG4224P22322585HPCX5V4KW26C9 paymentFee: deductFromLiableAccount remainder: addToLiableAccount tip: addToLiableAccount splitConfigurationId: SCNF4224P22322585HPCX384JV6JGX patch-merchants-merchantId-stores-storeId-patch-stores-200: summary: Response code - 200 OK description: Example response after updating the store value: id: YOUR_STORE_ID address: country: US line1: 1776 West Pinewood Avenue line2: Heartland Building line3: '' city: Springfield stateOrProvince: NY postalCode: '20251' description: City centre store merchantId: YOUR_MERCHANT_ACCOUNT_ID shopperStatement: Springfield Shop phoneNumber: '+1813702551707653' reference: Spring_store_2 status: active _links: self: href: https://management-test.adyen.com/v1/stores/YOUR_STORE_ID patch-merchants-merchantId-terminalSettings-add-eap-peap-and-psk-wifi-profiles: summary: Add EAP-PEAP and PSK Wi-Fi profiles description: Example request to add an EAP-PEAP Wi-Fi profile and a PSK Wi-Fi profile for a terminal value: wifiProfiles: profiles: - authType: wpa-eap autoWifi: false bssType: infra channel: 0 defaultProfile: true eap: peap eapCaCert: data: MD1rKS05M2JqRVFNQ...RTtLH1tLWo= name: eap-peap-ca.pem eapIdentity: admin eapIntermediateCert: data: PD3tUS1CRDdJTiGDR...EFoLS0tLQg= name: eap-peap-client.pem eapPwd: EAP_PEAP_PASSWORD hiddenSsid: false name: Profile-eap-peap-1 ssid: your-network wsec: ccmp - authType: wpa-psk autoWifi: false bssType: infra channel: 0 defaultProfile: false hiddenSsid: false name: Profile-guest-wifi psk: WIFI_PASSWORD ssid: your-network wsec: ccmp settings: band: 2.4GHz roaming: true timeout: 5 get-merchants-merchantId-stores-reference-terminalLogos-success-200: summary: Response code - 200 OK description: Example response when getting the logo of a payment terminal value: data: BASE-64_ENCODED_STRING get-merchants-merchantId-shippingLocations-success-200: summary: Response code - 200 OK description: Example response with shipping locations for a merchant account value: data: - id: S2-6A6C2E3432747D4F2F2C3455485E3836457D name: YOUR_COMPANY Spain contact: firstName: Pablo lastName: Mengano phoneNumber: '+34911234567' email: Pablo.Mengano@company.com address: streetAddress: Paseo de la Castellana 43 streetAddress2: 7 piso postalCode: '28046' city: Madrid country: ES post-merchants-merchantId-apiCredentials-post-merchant-credential-200: summary: OK 200 - Add an API credential description: Example response for adding an API credential. value: id: YOUR_API_CREDENTIAL username: YOUR_USERNAME clientKey: YOUR_CLIENT_KEY allowedIpAddresses: [] roles: - Checkout webservice role active: true allowedOrigins: - id: YOUR_ALLOWED_ORIGIN domain: https://www.mystore.com _links: self: href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL/allowedOrigins/YOUR_ALLOWED_ORIGIN _links: self: href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL allowedOrigins: href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL/allowedOrigins generateApiKey: href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL/generateApiKey generateClientKey: href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL/generateClientKey merchant: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT apiKey: YOUR_API_KEY password: YOUR_PASSWORD get-merchants-merchantId-splitConfigurations-splitConfigurationId-success-200: summary: Details of the split configuration description: Example response with details of the split configuration value: description: Your description for the split configuration rules: - currency: ANY fundingSource: ANY paymentMethod: ANY ruleId: SCRL4224P22322585HPCX384JW65VW shopperInteraction: ANY splitLogic: additionalCommission: fixedAmount: 10 variablePercentage: 50 balanceAccountId: BA3227C223222H5HQ2XX77VVH chargeback: deductFromLiableAccount commission: fixedAmount: 10 variablePercentage: 100 splitLogicId: SCLG4224P22322585HPCX384JX52M2 paymentFee: deductFromLiableAccount remainder: addToOneBalanceAccount tip: addToOneBalanceAccount - currency: EUR fundingSource: ANY paymentMethod: visa ruleId: SCRL4224P22322585HPCX5V4KV6L2R shopperInteraction: ANY splitLogic: additionalCommission: fixedAmount: 100 variablePercentage: 0 balanceAccountId: BA3227C223222H5HQ2XX77VVH chargeback: deductFromLiableAccount commission: fixedAmount: 100 variablePercentage: 100 splitLogicId: SCLG4224P22322585HPCX5V4KW26C9 paymentFee: deductFromLiableAccount remainder: addToLiableAccount tip: addToLiableAccount splitConfigurationId: SCNF4224P22322585HPCX384JV6JGX get-merchants-merchantId-stores-success-200: summary: Response code - 200 OK description: Example response when getting a list of stores for a merchant account value: _links: first: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_ID/stores?pageNumber=1&pageSize=1 last: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_ID/stores?pageNumber=2&pageSize=1 next: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_ID/stores?pageNumber=2&pageSize=1 self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_ID/stores?pageNumber=1&pageSize=1 itemsTotal: 2 pagesTotal: 1 data: - id: ST322LJ223223K5F4SQNR9XL5 address: city: Springfield country: US line1: 200 Main Street line2: Building 5A line3: Suite 3 postalCode: '20250' stateOrProvince: NY description: City centre store merchantId: YOUR_MERCHANT_ACCOUNT_ID phoneNumber: '+1813702551707653' reference: Springfield Shop status: active _links: self: href: https://management-test.adyen.com/v1/stores/ST322LJ223223K5F4SQNR9XL5 - id: ST322LJ223223K5F4SQNR9XL6 address: city: North Madison country: US line1: 1492 Townline Road line2: Rowland Business Park postalCode: '20577' stateOrProvince: NY description: West location merchantId: YOUR_MERCHANT_ACCOUNT_ID phoneNumber: '+1211992213193020' reference: Second Madison store status: active _links: self: href: https://management-test.adyen.com/v1/stores/ST322LJ223223K5F4SQNR9XL6 post-merchants-merchantId-terminalOrders-orderId-cancel-cancel-order-200: summary: Terminal order cancelled description: Example response after cancelling an order for terminal products value: id: '4154567890100682' customerOrderReference: YOUR_REFERENCE status: Cancelled shippingLocation: id: S2-6A6C2E3432747D4F2F2C3455485E3836457D name: YOUR_COMPANY Spain contact: firstName: Pablo lastName: Mengano phoneNumber: '+34911234567' email: Pablo.Mengano@company.com address: streetAddress: Paseo de la Castellana 43 streetAddress2: 7 piso postalCode: '28046' city: Madrid country: ES billingEntity: id: MerchantAccount.YOUR_MERCHANT_ACCOUNT name: YOUR_MERCHANT_ACCOUNT taxId: ES1234567890 email: Pablo.Mengano@company.com address: streetAddress: Paseo de la Castellana 43, 7 postalCode: '28046' city: Madrid country: ES orderDate: '2022-01-21T16:12:33Z' items: - id: PART-287001-EU name: Bluetooth Charging Base - V400m quantity: 2 - id: PART-620222-EU name: Receipt Roll quantity: 20 ? patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId-splitLogic-splitLogicId-patch-splitConfiguration-rule-splitLogic : summary: Update the split logic description: Example request for updating the split logic in a split configuration rule value: additionalCommission: fixedAmount: 100 variablePercentage: 0 balanceAccountId: BA3227C223222H5HQ2XX77VVH chargeback: deductFromLiableAccount commission: fixedAmount: 100 variablePercentage: 100 paymentFee: deductFromLiableAccount remainder: addToLiableAccount tip: addToLiableAccount patch-merchants-merchantId-stores-reference-terminalSettings-add-eap-tls-wifi-profile-200: summary: Response code - 200 OK description: Example response for adding an EAP-TLS Wi-Fi profile for a terminal value: cardholderReceipt: headerForAuthorizedReceipt: header1,header2,filler gratuities: - currency: EUR usePredefinedTipEntries: true predefinedTipEntries: - '100' - 1% - 5% allowCustomAmount: true nexo: displayUrls: localUrls: - password: BASIC_AUTH_PASSWORD url: https://your-display-notifications-endpoint.com username: BASIC_AUTH_USERNAME encryptionKey: identifier: KEY_IDENTIFIER passphrase: KEY_PASSPHRASE version: 1 eventUrls: eventPublicUrls: - password: BASIC_AUTH_PASSWORD url: https://your-event-notifications-endpoint.com username: BASIC_AUTH_USERNAME opi: enablePayAtTable: true payAtTableStoreNumber: '1' payAtTableURL: https:/your-pay-at-table-endpoint.com offlineProcessing: chipFloorLimit: 0 receiptOptions: qrCodeData: http://www.example.com/order/${pspreference}/${merchantreference} receiptPrinting: shopperApproved: true shopperRefused: true shopperCancelled: true shopperRefundApproved: true shopperRefundRefused: true shopperVoid: true signature: askSignatureOnScreen: true skipSignature: false deviceName: Amsterdam-236203386 wifiProfiles: profiles: - authType: wpa-eap autoWifi: false bssType: infra channel: 0 defaultProfile: true eap: tls eapCaCert: data: LS0tLS05M2JqRVFNQ...EUtLS0tLQo= name: eap-tls-ca.pem eapClientCert: data: LS0tLS1CRUdJTiBDR...EUtLS0tLQo= name: eap-tls-client.pem eapClientKey: data: AAAB3NzaC1...Rtah3KLFwPU= name: rsa-private.key eapClientPwd: '' eapIdentity: admin name: Profile-eap-tls-1 ssid: your-network wsec: ccmp settings: band: 2.4GHz roaming: true timeout: 5 timeouts: fromActiveToSleep: 30 hardware: displayMaximumBackLight: 75 patch-merchants-merchantId-splitConfigurations-splitConfigurationId-patch-splitConfiguration-description-200: summary: Split configuration description updated description: Example response after updating the description of a split configuration value: description: Updated description for the split configuration rules: - currency: ANY fundingSource: ANY paymentMethod: ANY ruleId: SCRL4224P22322585HPCX384JW65VW shopperInteraction: ANY splitLogic: additionalCommission: fixedAmount: 10 variablePercentage: 50 balanceAccountId: BA3227C223222H5HQ2XX77VVH chargeback: deductFromLiableAccount commission: fixedAmount: 10 variablePercentage: 100 splitLogicId: SCLG4224P22322585HPCX384JX52M2 paymentFee: deductFromLiableAccount remainder: addToOneBalanceAccount tip: addToOneBalanceAccount - currency: EUR fundingSource: ANY paymentMethod: visa ruleId: SCRL4224P22322585HPCX5V4KV6L2R shopperInteraction: ANY splitLogic: additionalCommission: fixedAmount: 100 variablePercentage: 0 balanceAccountId: BA3227C223222H5HQ2XX77VVH chargeback: deductFromLiableAccount commission: fixedAmount: 100 variablePercentage: 100 splitLogicId: SCLG4224P22322585HPCX5V4KW26C9 paymentFee: deductFromLiableAccount remainder: addToLiableAccount tip: addToLiableAccount splitConfigurationId: SCNF4224P22322585HPCX384JV6JGX patch-merchants-merchantId-terminalSettings-add-eap-peap-and-psk-wifi-profiles-200: summary: Response code - 200 OK description: Example response for adding an EAP-PEAP Wi-Fi profile and a PSK Wi-Fi profile for a terminal value: cardholderReceipt: headerForAuthorizedReceipt: header1,header2,filler gratuities: - currency: EUR usePredefinedTipEntries: true predefinedTipEntries: - '100' - 1% - 5% allowCustomAmount: true nexo: nexoEventUrls: - https://your-event-notifications-endpoint.com opi: enablePayAtTable: true payAtTableStoreNumber: '1' payAtTableURL: https:/your-pay-at-table-endpoint.com offlineProcessing: chipFloorLimit: 0 receiptOptions: qrCodeData: http://www.example.com/order/${pspreference}/${merchantreference} receiptPrinting: shopperApproved: true shopperRefused: true shopperCancelled: true shopperRefundApproved: true shopperRefundRefused: true shopperVoid: true signature: askSignatureOnScreen: true skipSignature: false deviceName: Amsterdam-236203386 wifiProfiles: profiles: - authType: wpa-eap autoWifi: false bssType: infra channel: 0 defaultProfile: true eap: peap eapCaCert: data: MD1rKS05M2JqRVFNQ...RTtLH1tLWo= name: eap-peap-ca.pem eapIdentity: admin eapIntermediateCert: data: PD3tUS1CRDdJTiGDR...EFoLS0tLQg= name: eap-peap-client.pem eapPwd: EAP_PEAP_PASSWORD hiddenSsid: false name: Profile-eap-peap-1 ssid: your-network wsec: ccmp - authType: wpa-psk autoWifi: false bssType: infra channel: 0 defaultProfile: false hiddenSsid: false name: Profile-guest-wifi psk: WIFI_PASSWORD ssid: your-network wsec: ccmp settings: band: 2.4GHz roaming: true timeout: 5 timeouts: fromActiveToSleep: 30 hardware: displayMaximumBackLight: 75 patch-merchants-merchantId-stores-reference-terminalSettings-add-eap-tls-wifi-profile: summary: Add EAP-TLS Wi-Fi profile description: Example request to add an EAP-TLS Wi-Fi profile for a terminal value: wifiProfiles: profiles: - authType: wpa-eap autoWifi: false bssType: infra channel: 0 defaultProfile: true eap: tls eapCaCert: data: LS0tLS05M2JqRVFNQ...EUtLS0tLQo= name: eap-tls-ca.pem eapClientCert: data: LS0tLS1CRUdJTiBDR...EUtLS0tLQo= name: eap-tls-client.pem eapClientKey: data: AAAB3NzaC1...Rtah3KLFwPU= name: rsa-private.key eapClientPwd: '' eapIdentity: admin name: Profile-eap-tls-1 ssid: your-network wsec: ccmp settings: band: 2.4GHz roaming: true timeout: 5 patch-merchants-merchantId-webhooks-webhookId-patch-merchant-webhook-200: summary: OK 200 - Activate the webhook description: Example response for activating a webhook configuration. value: id: S2-3E5E42476641 type: standard url: YOUR_WEBHOOK_URL description: Webhook for YOUR_MERCHANT_ACCOUNT - YOUR_MERCHANT_CODE username: '' hasPassword: false active: true hasError: false sslVersion: TLSv1.2 communicationFormat: json acceptsExpiredCertificate: false acceptsSelfSignedCertificate: false acceptsUntrustedRootCertificate: false populateSoapActionHeader: false additionalSettings: properties: includePosTerminalInfo: false includeARN: false includePosDetails: false includeCardInfoForRecurringContractNotification: false includeRiskData: false includeRiskExperimentReference: false includeSoapSecurityHeader: false includeContactlessWalletTokenInformation: false includeAcquirerReference: false includeRiskProfileReference: false includeOriginalMerchantReferenceCancelOrRefundNotification: false includeNfcTokenInformation: false includeSubvariant: false includeThreeDSVersion: false includeInstallmentsInfo: false includeAliasInfo: false includeShopperCountry: false includeRawThreeDSecureResult: false includeAirlineData: false includeGrossCurrencyChargebackDetails: false includeThreeDSecureResult: false includeMetadataIn3DSecurePaymentNotification: false includeOriginalReferenceForChargebackReversed: false addAcquirerResult: false includeDeliveryAddress: false includeRetryAttempts: false includeExtraCosts: false includeCardHolderName: false includeShopperDetail: false includeBankAccountDetails: false includeMandateDetails: false includeAuthAmountForDynamicZeroAuth: false includeIssuerCountry: false includeAcquirerErrorDetails: false includeCoBrandedWith: false includeShopperInteraction: false includeDeviceAndBrowserInfo: false addRawAcquirerResult: false includeCardBin: false includeFundingSource: false includeThreeDS2ChallengeInformation: false includeRiskProfile: false includeRealtimeAccountUpdaterStatus: false includeDunningProjectData: false includePaymentResultInOrderClosedNotification: false includeCardBinDetails: false includeNotesInManualReviewNotifications: false includeZeroAuthFlag: false addCaptureReferenceToDisputeNotification: false includePayPalDetails: false includeRawThreeDSecureDetailsResult: false includeBankVerificationResults: false includeCaptureDelayHours: false addPaymentAccountReference: false includePayULatamDetails: false includeStore: false returnAvsData: false includeWeChatPayOpenid: false includeUpiVpa: false includeCustomRoutingFlagging: false includeTokenisedPaymentMetaData: false _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/webhooks/S2-3E5E42476641 generateHmac: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/webhooks/S2-3E5E42476641/generateHmac merchant: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT testWebhook: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/webhooks/S2-3E5E42476641/test get-merchants-merchantId-stores-storeId-success-200: summary: Response code - 200 OK description: Example response when getting the details of a store value: storeId: ST322LJ223223K5F4SQNR9XL5 address: city: Springfield country: US line1: 200 Main Street line2: Building 5A line3: Suite 3 postalCode: '20250' stateOrProvince: NY description: City centre store merchantId: YOUR_MERCHANT_ACCOUNT_ID phoneNumber: '+1813702551707653' reference: Springfield Shop status: active _links: self: href: https://management-test.adyen.com/v1/stores/ST322LJ223223K5F4SQNR9XL5 patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId-patch-splitConfiguration-rule-200: summary: Split configuration rule updated description: Example response after updating a rule in a split configuration value: description: Your description for the split configuration rules: - currency: ANY fundingSource: ANY paymentMethod: ANY ruleId: SCRL4224P22322585HPCX384JW65VW shopperInteraction: ANY splitLogic: additionalCommission: fixedAmount: 10 variablePercentage: 50 balanceAccountId: BA3227C223222H5HQ2XX77VVH chargeback: deductFromLiableAccount commission: fixedAmount: 10 variablePercentage: 100 splitLogicId: SCLG4224P22322585HPCX384JX52M2 paymentFee: deductFromLiableAccount remainder: addToOneBalanceAccount tip: addToOneBalanceAccount - currency: EUR fundingSource: ANY paymentMethod: visa ruleId: SCRL4224P22322585HPCX5V4KV6L2R shopperInteraction: ANY splitLogic: additionalCommission: fixedAmount: 10 variablePercentage: 50 balanceAccountId: BA3227C223222H5HQ2XX77VVH chargeback: deductFromLiableAccount commission: fixedAmount: 10 variablePercentage: 100 splitLogicId: SCLG4224P22322585HPCX5V4KW26C9 paymentFee: deductFromLiableAccount remainder: addToLiableAccount tip: addToOneBalanceAccount splitConfigurationId: SCNF4224P22322585HPCX384JV6JGX ? patch-merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId-splitLogic-splitLogicId-patch-splitConfiguration-rule-splitLogic-200 : summary: Split logic updated description: Example response after updating the split logic value: description: Your description for the split configuration rules: - currency: ANY fundingSource: ANY paymentMethod: ANY ruleId: SCRL4224P22322585HPCX384JW65VW shopperInteraction: ANY splitLogic: additionalCommission: fixedAmount: 10 variablePercentage: 50 balanceAccountId: BA3227C223222H5HQ2XX77VVH chargeback: deductFromLiableAccount commission: fixedAmount: 10 variablePercentage: 100 splitLogicId: SCLG4224P22322585HPCX384JX52M2 paymentFee: deductFromLiableAccount remainder: addToOneBalanceAccount tip: addToOneBalanceAccount - currency: EUR fundingSource: ANY paymentMethod: visa ruleId: SCRL4224P22322585HPCX5V4KV6L2R shopperInteraction: ANY splitLogic: additionalCommission: fixedAmount: 100 variablePercentage: 0 balanceAccountId: BA3227C223222H5HQ2XX77VVH chargeback: deductFromLiableAccount commission: fixedAmount: 100 variablePercentage: 100 splitLogicId: SCLG4224P22322585HPCX5V4KW26C9 paymentFee: deductFromLiableAccount remainder: addToLiableAccount tip: addToLiableAccount splitConfigurationId: SCNF4224P22322585HPCX384JV6JGX get-merchants-merchantId-success-200: summary: Details of the merchant account description: Example response with details of the merchant account value: id: YOUR_MERCHANT_ACCOUNT name: YOUR_MERCHANT_NAME captureDelay: manual defaultShopperInteraction: Ecommerce status: Active shopWebAddress: YOUR_SHOP_URL merchantCity: Amsterdam primarySettlementCurrency: EUR _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT apiCredentials: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials users: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/users webhooks: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/webhooks post-merchants-merchantId-splitConfigurations-splitConfigurationId-post-splitConfiguration-rule-200: summary: Split configuration created description: Example response after creating a split configuration value: description: My first split configuration rules: - currency: ANY fundingSource: ANY paymentMethod: ANY ruleId: SCRL4224P22322585HPCX384JW65VW shopperInteraction: ANY splitLogic: additionalCommission: fixedAmount: 10 variablePercentage: 50 balanceAccountId: BA3227C223222H5HQ2XX77VVH chargeback: deductFromLiableAccount commission: fixedAmount: 10 variablePercentage: 100 splitLogicId: SCLG4224P22322585HPCX384JX52M2 paymentFee: deductFromLiableAccount remainder: addToOneBalanceAccount tip: addToOneBalanceAccount - currency: USD fundingSource: ANY paymentMethod: visa ruleId: SCRL4224P22322585HPCX5V4KV6L2R shopperInteraction: POS splitLogic: additionalCommission: fixedAmount: 10 variablePercentage: 50 balanceAccountId: BA3227C223222H5HQ2XX77VVH chargeback: deductFromLiableAccount commission: fixedAmount: 10 variablePercentage: 100 splitLogicId: SCLG4224P22322585HPCX5V4KW26C9 paymentFee: deductFromLiableAccount remainder: addToLiableAccount tip: addToOneBalanceAccount splitConfigurationId: SCNF4224P22322585HPCX384JV6JGX get-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-get-allowed-origin-200: summary: OK 200 - Get the list of allowed origins for the API credential description: Example response for getting the list of allowed origins for the API credential. value: data: - id: YOUR_ALLOWED_ORIGIN_1 domain: https://www.eu.mystore.com _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL/allowedOrigins/YOUR_ALLOWED_ORIGIN_1 - id: YOUR_ALLOWED_ORIGIN_2 domain: https://www.us.mystore.com _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL/allowedOrigins/YOUR_ALLOWED_ORIGIN_2 post-merchants-merchantId-apiCredentials-post-merchant-credential: summary: Add an API credential description: Example request for adding an API credential. value: roles: - Checkout webservice role allowedOrigins: - https://www.mystore.com post-merchants-merchantId-splitConfigurations-post-splitConfiguration: summary: Create a split configuration description: Example request to create a split configuration value: description: Your description for the split configuration rules: - paymentMethod: ANY shopperInteraction: ANY fundingSource: ANY currency: ANY splitLogic: paymentFee: deductFromLiableAccount chargeback: deductFromLiableAccount tip: addToOneBalanceAccount remainder: addToOneBalanceAccount commission: fixedAmount: 10 variablePercentage: 100 additionalCommission: fixedAmount: 10 variablePercentage: 50 balanceAccountId: BA3227C223222H5HQ2XX77VVH patch-merchants-merchantId-stores-reference-terminalSettings-add-eap-peap-and-psk-wifi-profiles: summary: Add EAP-PEAP and PSK Wi-Fi profiles description: Example request to add an EAP-PEAP Wi-Fi profile and a PSK Wi-Fi profile for a terminal value: wifiProfiles: profiles: - authType: wpa-eap autoWifi: false bssType: infra channel: 0 defaultProfile: true eap: peap eapCaCert: data: MD1rKS05M2JqRVFNQ...RTtLH1tLWo= name: eap-peap-ca.pem eapIdentity: admin eapIntermediateCert: data: PD3tUS1CRDdJTiGDR...EFoLS0tLQg= name: eap-peap-client.pem eapPwd: EAP_PEAP_PASSWORD name: Profile-eap-peap-1 ssid: your-network wsec: ccmp - authType: wpa-psk autoWifi: false bssType: infra channel: 0 defaultProfile: false name: Profile-guest-wifi psk: WIFI_PASSWORD ssid: your-network wsec: ccmp settings: band: 2.4GHz roaming: true timeout: 5 post-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-add-allowed-origin: summary: Add an allowed origin for the API credential description: Example request for adding an allowed origin for the API credential. value: domain: https://www.eu.mystore.com post-merchants-merchantId-paymentMethodSettings-01.add-payment-method-visa: summary: Request to add Visa description: Example request to add Visa as the payment method value: type: visa businessLineId: BL322KV223222D5F8H2J4BQ6C storeIds: - ST322LJ223223K5F4SQNR9XL5 currencies: - EUR countries: - NL post-merchants-merchantId-shippingLocations-create-shipping-location: summary: Create a shipping location description: Example request to create a shipping location value: name: YOUR_MERCHANT_ACCOUNT Barcelona depot address: companyName: YOUR_COMPANY streetAddress: El quinto pino 42 postalCode: 8012 city: Barcelona stateOrProvince: '' country: ES contact: firstName: Rita lastName: Perengano phoneNumber: +34 93 1234567 email: Rita.Perengano@company.com post-merchants-merchantId-shippingLocations-create-shipping-location-200: summary: Shipping location created description: Example response after creating a shipping location value: id: S2-73536B20665526704F30792642212044452F714622375D477270 name: YOUR_MERCHANT_ACCOUNT Barcelona depot contact: firstName: Rita lastName: Perengano phoneNumber: '+34931234567' email: Rita.Perengano@company.com address: companyName: YOUR_COMPANY streetAddress: El quinto pino 42 postalCode: 8012 city: Barcelona stateOrProvince: '' post-merchants-merchantId-terminalOrders-create-order: summary: Create an order description: Example request to create an order for terminal products value: customerOrderReference: YOUR_REFERENCE shippingLocationId: S2-6A6C2E3432747D4F2F2C3455485E3836457D billingEntityId: MerchantAccount.YOUR_MERCHANT_ACCOUNT items: - id: PART-287001-EU name: Bluetooth Charging Base - V400m quantity: 2 - id: PART-620222-EU name: Receipt Roll quantity: 20 patch-merchants-merchantId-stores-reference-terminalLogos-upload-logo: summary: Upload terminal logo description: Example request to upload a payment terminal logo value: data: LOGO_FILE_CONVERTED_TO_A_BASE-64_ENCODED_STRING post-merchants-merchantId-paymentMethodSettings-02.add-payment-method-partner-model: summary: Request to add Swish description: Example request to add Swish with a partner model setup value: businessLineId: BL322KV223222D5F8H2J4BQ6C storeIds: - ST322LJ223223K5F4SQNR9XL5 type: swish swish: swishNumber: '1231111111' currencies: - SEK countries: - SE get-merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-originId-get-allowed-origins-200: summary: OK 200 - Get an allowed origin for the API credential description: Example response for getting an allowed origin for the API credential. value: id: YOUR_ALLOWED_ORIGIN domain: https://www.eu.mystore.com _links: self: href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL/allowedOrigins/YOUR_ALLOWED_ORIGIN patch-merchants-merchantId-terminalOrders-orderId-update-order-200: summary: Response code - 200 OK description: Example response after updating an order for terminal products value: id: '4154567890100682' customerOrderReference: YOUR_REFERENCE status: Placed shippingLocation: id: S2-73536B20665526704F30792642212044452F714622375D477270 name: YOUR_MERCHANT_ACCOUNT Barcelona depot contact: firstName: Rita lastName: Perengano phoneNumber: '+34931234567' email: Rita.Perengano@company.com address: companyName: YOUR_COMPANY streetAddress: El quinto pino 42 postalCode: 8012 city: Barcelona stateOrProvince: '' country: ES billingEntity: id: MerchantAccount.YOUR_MERCHANT_ACCOUNT name: YOUR_MERCHANT_ACCOUNT taxId: ES1234567890 email: Pablo.Mengano@company.com address: streetAddress: Paseo de la Castellana 43, 7 postalCode: '28046' city: Madrid country: ES orderDate: '2022-01-21T16:12:33Z' items: - id: TBOX-V400m-684-EU name: V400m Package quantity: 1 - id: PART-287001-EU name: Bluetooth Charging Base - V400m quantity: 2 - id: PART-620222-EU name: Receipt Roll quantity: 20 post-merchants-post-merchants-200: summary: Merchant account created description: Example response for creating a merchant account value: companyId: YOUR_COMPANY_ACCOUNT legalEntityId: YOUR_LEGAL_ENTITY_ID businessLineId: YOUR_BUSINESS_LINE_ID description: YOUR_DESCRIPTION reference: YOUR_OWN_REFERENCE id: YOUR_OWN_REFERENCE schemas: CreateApiCredentialResponse: properties: _links: description: References to resources linked to the API credential. $ref: '#/components/schemas/ApiCredentialLinks' active: description: Indicates if the API credential is enabled. Must be set to **true** to use the credential in your integration. type: boolean allowedIpAddresses: description: 'List of IP addresses from which your client can make requests. If the list is empty, we allow requests from any IP. If the list is not empty and we get a request from an IP which is not on the list, you get a security error.' items: type: string type: array allowedOrigins: description: List containing the [allowed origins](https://docs.adyen.com/development-resources/client-side-authentication#allowed-origins) linked to the API credential. items: $ref: '#/components/schemas/AllowedOrigin' type: array apiKey: description: The API key for the API credential that was created. type: string clientKey: description: Public key used for [client-side authentication](https://docs.adyen.com/development-resources/client-side-authentication). The client key is required for Drop-in and Components integrations. type: string description: description: Description of the API credential. maxLength: 50 type: string id: description: Unique identifier of the API credential. type: string password: description: The password for the API credential that was created. type: string roles: description: List of [roles](https://docs.adyen.com/development-resources/api-credentials#roles-1) for the API credential. items: type: string type: array username: description: The name of the [API credential](https://docs.adyen.com/development-resources/api-credentials), for example **ws@Company.TestCompany**. type: string required: - id - username - clientKey - allowedIpAddresses - roles - active - password - apiKey type: object GooglePayInfo: properties: merchantId: description: 'Google Pay [Merchant ID](https://support.google.com/paymentscenter/answer/7163092?hl=en). Character length and limitations: 16 alphanumeric characters or 20 numeric characters.' maxLength: 20 minLength: 16 type: string reuseMerchantId: description: 'Indicates whether the Google Pay Merchant ID is used for several merchant accounts. Default value: **false**.' type: boolean required: - merchantId type: object SofortInfo: properties: currencyCode: description: Sofort currency code. For example, **EUR**. type: string logo: description: 'Sofort logo. Format: Base64-encoded string.' type: string required: - logo - currencyCode type: object PaymentMethod: properties: afterpayTouch: description: Afterpay Touch details. $ref: '#/components/schemas/AfterpayTouchInfo' allowed: description: Indicates whether receiving payments is allowed. This value is set to **true** by Adyen after screening your merchant account. type: boolean applePay: description: Apple Pay details. $ref: '#/components/schemas/ApplePayInfo' bcmc: description: Bancontact details. $ref: '#/components/schemas/BcmcInfo' businessLineId: description: The unique identifier of the business line. Required if you have a [platform setup](https://docs.adyen.com/marketplaces-and-platforms/platform-structure-resources/platform-setup/). type: string cartesBancaires: description: Cartes Bancaires details. $ref: '#/components/schemas/CartesBancairesInfo' clearpay: description: Clearpay details. $ref: '#/components/schemas/ClearpayInfo' countries: description: The list of countries where a payment method is available. By default, all countries supported by the payment method. items: type: string type: array cup: description: China Union Pay details. $ref: '#/components/schemas/GenericPmWithTdiInfo' currencies: description: The list of currencies that a payment method supports. By default, all currencies supported by the payment method. items: type: string type: array customRoutingFlags: description: The list of custom routing flags to route payment to the intended acquirer. items: type: string type: array diners: description: Diners details. $ref: '#/components/schemas/GenericPmWithTdiInfo' discover: description: Discover details. $ref: '#/components/schemas/GenericPmWithTdiInfo' eftpos_australia: description: Eftpos Australia details. $ref: '#/components/schemas/GenericPmWithTdiInfo' enabled: description: Indicates whether the payment method is enabled (**true**) or disabled (**false**). type: boolean giroPay: description: giropay details. $ref: '#/components/schemas/GiroPayInfo' girocard: description: Girocard details. $ref: '#/components/schemas/GenericPmWithTdiInfo' googlePay: description: Google Pay details. $ref: '#/components/schemas/GooglePayInfo' id: description: The identifier of the resource. type: string ideal: description: iDeal details. $ref: '#/components/schemas/GenericPmWithTdiInfo' interac_card: description: Interac Card details. $ref: '#/components/schemas/GenericPmWithTdiInfo' jcb: description: JCB details. $ref: '#/components/schemas/GenericPmWithTdiInfo' klarna: description: Klarna details. $ref: '#/components/schemas/KlarnaInfo' maestro: description: Maestro details. $ref: '#/components/schemas/GenericPmWithTdiInfo' mc: description: MasterCard details. $ref: '#/components/schemas/GenericPmWithTdiInfo' mealVoucher_FR: description: Meal Voucher FR details. $ref: '#/components/schemas/MealVoucherFRInfo' paypal: description: PayPal details. $ref: '#/components/schemas/PayPalInfo' reference: description: Your reference for the payment method. Supported characters a-z, A-Z, 0-9. maxLength: 150 type: string shopperInteraction: description: The sales channel. type: string sofort: description: Sofort details. $ref: '#/components/schemas/SofortInfo' storeIds: x-addedInVersion: '3' description: The unique identifier of the store for which to configure the payment method, if any. items: type: string type: array swish: description: Swish details. $ref: '#/components/schemas/SwishInfo' twint: description: Twint details. $ref: '#/components/schemas/TwintInfo' type: description: Payment method [variant](https://docs.adyen.com/development-resources/paymentmethodvariant#management-api). type: string verificationStatus: description: 'Payment method status. Possible values: * **valid** * **pending** * **invalid** * **rejected**' enum: - valid - pending - invalid - rejected type: string vipps: description: Vipps details. $ref: '#/components/schemas/VippsInfo' visa: description: Visa details. $ref: '#/components/schemas/GenericPmWithTdiInfo' required: - id type: object CreateMerchantApiCredentialRequest: properties: allowedOrigins: description: The list of [allowed origins](https://docs.adyen.com/development-resources/client-side-authentication#allowed-origins) for the new API credential. items: type: string type: array description: description: Description of the API credential. type: string roles: description: List of [roles](https://docs.adyen.com/development-resources/api-credentials#roles-1) for the API credential. Only roles assigned to 'ws@Company.' can be assigned to other API credentials. items: type: string type: array type: object CreateMerchantWebhookRequest: properties: acceptsExpiredCertificate: description: 'Indicates if expired SSL certificates are accepted. Default value: **false**.' type: boolean acceptsSelfSignedCertificate: description: 'Indicates if self-signed SSL certificates are accepted. Default value: **false**.' type: boolean acceptsUntrustedRootCertificate: description: 'Indicates if untrusted SSL certificates are accepted. Default value: **false**.' type: boolean active: description: Indicates if the webhook configuration is active. The field must be **true** for us to send webhooks about events related an account. type: boolean additionalSettings: description: Additional shopper and transaction information to be included in your [standard notifications](https://docs.adyen.com/development-resources/webhooks/understand-notifications#event-codes). Find out more about the available [additional settings](https://docs.adyen.com/development-resources/webhooks/additional-settings). $ref: '#/components/schemas/AdditionalSettings' communicationFormat: description: 'Format or protocol for receiving webhooks. Possible values: * **soap** * **http** * **json** ' enum: - http - json - soap example: soap type: string description: description: Your description for this webhook configuration. type: string encryptionProtocol: x-addedInVersion: '2' description: 'SSL version to access the public webhook URL specified in the `url` field. Possible values: * **TLSv1.3** * **TLSv1.2** * **HTTP** - Only allowed on Test environment. If not specified, the webhook will use `sslVersion`: **TLSv1.2**.' enum: - HTTP - TLSv1.2 - TLSv1.3 example: TLSv1.2 type: string networkType: description: 'Network type for Terminal API notification webhooks. Possible values: * **public** * **local** Default Value: **public**.' enum: - local - public type: string password: description: Password to access the webhook URL. type: string populateSoapActionHeader: description: 'Indicates if the SOAP action header needs to be populated. Default value: **false**. Only applies if `communicationFormat`: **soap**.' type: boolean type: description: 'The type of webhook that is being created. Possible values are: - **standard** - **account-settings-notification** - **banktransfer-notification** - **boletobancario-notification** - **directdebit-notification** - **ach-notification-of-change-notification** - **pending-notification** - **ideal-notification** - **ideal-pending-notification** - **report-notification** - **rreq-notification** Find out more about [standard notification webhooks](https://docs.adyen.com/development-resources/webhooks/understand-notifications#event-codes) and [other types of notifications](https://docs.adyen.com/development-resources/webhooks/understand-notifications#other-notifications).' type: string url: description: Public URL where webhooks will be sent, for example **https://www.domain.com/webhook-endpoint**. example: http://www.adyen.com type: string username: description: Username to access the webhook URL. maxLength: 255 type: string required: - url - active - communicationFormat - type type: object Passcodes: properties: adminMenuPin: description: The passcode for the Admin menu and the Settings menu. maxLength: 6 type: string refundPin: description: The passcode for referenced and unreferenced refunds on standalone terminals. maxLength: 6 type: string screenLockPin: description: The passcode to unlock the terminal screen after a timeout. maxLength: 6 minLength: 4 type: string txMenuPin: description: The passcode for the Transactions menu. maxLength: 6 type: string type: object ShippingLocation: properties: address: description: The address details of the shipping location. $ref: '#/components/schemas/Address' contact: description: The contact details for the shipping location. $ref: '#/components/schemas/Contact' id: description: The unique identifier of the shipping location, for use as `shippingLocationId` when creating an order. type: string name: description: The unique name of the shipping location. type: string type: object PaymentMethodResponse: properties: _links: description: Pagination references. $ref: '#/components/schemas/PaginationLinks' data: description: The list of supported payment methods and their details. items: $ref: '#/components/schemas/PaymentMethod' type: array itemsTotal: description: Total number of items. format: int32 type: integer pagesTotal: description: Total number of pages. format: int32 type: integer typesWithErrors: description: Payment method types with errors. items: enum: - afterpaytouch - alipay - alipay_hk - amex - applepay - bcmc - blik - cartebancaire - clearpay - cup - diners - directdebit_GB - discover - ebanking_FI - eftpos_australia - elo - elocredit - elodebit - girocard - googlepay - hiper - hipercard - ideal - interac_card - jcb - klarna - klarna_account - klarna_paynow - maestro - mbway - mc - mcdebit - mealVoucher_FR - mobilepay - multibanco - onlineBanking_PL - paybybank - paypal - payshop - swish - trustly - twint - twint_pos - vipps - visa - visadebit - vpay - wechatpay - wechatpay_pos type: string type: array required: - itemsTotal - pagesTotal type: object Notification: properties: category: description: The type of event notification sent when you select the notification button. enum: - SaleWakeUp - KeyPressed type: string details: description: The text shown in the prompt which opens when you select the notification button. For example, the description of the input box for pay-at-table. type: string enabled: description: Enables sending event notifications either by pressing the Confirm key on terminals with a keypad or by tapping the event notification button on the terminal screen. type: boolean showButton: description: Shows or hides the event notification button on the screen of terminal models that have a keypad. type: boolean title: description: The name of the notification button on the terminal screen. type: string type: object TransactionDescriptionInfo: properties: doingBusinessAsName: description: "The text to be shown on the shopper's bank statement.\n We recommend sending a maximum of 22 characters, otherwise banks might truncate the string.\n Allowed characters: **a-z**, **A-Z**, **0-9**, spaces, and special characters **. , ' _ - ? + * /**." maxLength: 22 type: string type: default: dynamic description: 'The type of transaction description you want to use: - **fixed**: The transaction description set in this request is used for all payments with this payment method. - **append**: The transaction description set in this request is used as a base for all payments with this payment method. The [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is appended to this base description. Note that if the combined length exceeds 22 characters, banks may truncate the string. - **dynamic**: Only the [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is used for payments with this payment method.' enum: - append - dynamic - fixed type: string type: object Standalone: properties: currencyCode: description: The default currency of the standalone payment terminal as an [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code. maxLength: 3 minLength: 3 type: string enableStandalone: description: Enable standalone mode. type: boolean type: object Logo: properties: data: description: The image file, converted to a Base64-encoded string, of the logo to be shown on the terminal. maxLength: 350000 type: string type: object ListMerchantApiCredentialsResponse: properties: _links: description: Pagination references. $ref: '#/components/schemas/PaginationLinks' data: description: The list of API credentials. items: $ref: '#/components/schemas/ApiCredential' type: array itemsTotal: description: Total number of items. format: int32 type: integer pagesTotal: description: Total number of pages. format: int32 type: integer required: - itemsTotal - pagesTotal type: object OrderItem: properties: id: description: The unique identifier of the product. type: string installments: description: The number of installments for the specified product `id`. format: int64 type: integer name: description: The name of the product. type: string quantity: description: The number of items with the specified product `id` included in the order. format: int32 type: integer type: object TerminalProduct: properties: description: description: Information about items included and integration options. type: string id: description: The unique identifier of the product. type: string itemsIncluded: description: A list of parts included in the terminal package. items: type: string type: array name: description: The descriptive name of the product. type: string price: description: The price of the product. $ref: '#/components/schemas/TerminalProductPrice' type: object WebhookLinks: properties: company: description: The company account that the webhook is configured for. Only present for company-level webhooks. $ref: '#/components/schemas/LinksElement' generateHmac: description: Generate an HMAC key. $ref: '#/components/schemas/LinksElement' merchant: description: The merchant account that the webhook is configured for. Only present for merchant-level webhooks. $ref: '#/components/schemas/LinksElement' self: description: Link to the resource itself. $ref: '#/components/schemas/LinksElement' testWebhook: description: Test the webhook setup. $ref: '#/components/schemas/LinksElement' required: - self - testWebhook - generateHmac type: object Gratuity: properties: allowCustomAmount: description: Indicates whether one of the predefined tipping options is to let the shopper enter a custom tip. If **true**, only three of the other options defined in `predefinedTipEntries` are shown. type: boolean currency: description: The currency that the tipping settings apply to. type: string predefinedTipEntries: description: 'Tipping options the shopper can choose from if `usePredefinedTipEntries` is **true**. The maximum number of predefined options is four, or three plus the option to enter a custom tip. The options can be a mix of: - A percentage of the transaction amount. Example: **5%** - A tip amount in [minor units](https://docs.adyen.com/development-resources/currency-codes). Example: **500** for a EUR 5 tip.' items: type: string type: array usePredefinedTipEntries: description: Indicates whether the terminal shows a prompt to enter a tip (**false**), or predefined tipping options to choose from (**true**). type: boolean type: object Address: properties: city: description: The name of the city. type: string companyName: description: The name of the company. type: string country: description: The two-letter country code, in [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format. type: string postalCode: description: The postal code. type: string stateOrProvince: description: "The state or province as defined in [ISO 3166-2](https://www.iso.org/standard/72483.html). For example, **ON** for Ontario, Canada. \n\nApplicable for the following countries:\n- Australia\n- Brazil\n- Canada\n- India\n- Mexico\n- New Zealand\n- United States" type: string streetAddress: description: The name of the street, and the house or building number. type: string streetAddress2: description: Additional address details, if any. type: string type: object BillingEntity: properties: address: description: The address details of the billing entity. $ref: '#/components/schemas/Address' email: description: The email address of the billing entity. type: string id: description: The unique identifier of the billing entity, for use as `billingEntityId` when creating an order. type: string name: description: The unique name of the billing entity. type: string taxId: description: The tax number of the billing entity. type: string type: object MinorUnitsMonetaryValue: properties: amount: description: The transaction amount, in [minor units](https://docs.adyen.com/development-resources/currency-codes). format: int32 type: integer currencyCode: description: The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes). type: string type: object SwishInfo: properties: swishNumber: description: 'Swish number. Format: 10 digits without spaces. For example, **1231111111**.' maxLength: 10 minLength: 10 type: string required: - swishNumber type: object UpdatePaymentMethodInfo: properties: bcmc: description: Bancontact details. $ref: '#/components/schemas/BcmcInfo' cartesBancaires: description: Cartes Bancaires details. $ref: '#/components/schemas/CartesBancairesInfo' countries: description: The list of countries where a payment method is available. By default, all countries supported by the payment method. items: type: string type: array cup: description: China Union Pay details. $ref: '#/components/schemas/GenericPmWithTdiInfo' currencies: description: The list of currencies that a payment method supports. By default, all currencies supported by the payment method. items: type: string type: array customRoutingFlags: description: Custom routing flags for acquirer routing. items: type: string type: array diners: description: Diners details. $ref: '#/components/schemas/GenericPmWithTdiInfo' discover: description: Discover details. $ref: '#/components/schemas/GenericPmWithTdiInfo' eftpos_australia: description: Eftpos Australia details. $ref: '#/components/schemas/GenericPmWithTdiInfo' enabled: description: Indicates whether the payment method is enabled (**true**) or disabled (**false**). type: boolean girocard: description: Girocard details. $ref: '#/components/schemas/GenericPmWithTdiInfo' ideal: description: iDeal details. $ref: '#/components/schemas/GenericPmWithTdiInfo' interac_card: description: Interac Card details. $ref: '#/components/schemas/GenericPmWithTdiInfo' jcb: description: JCB details. $ref: '#/components/schemas/GenericPmWithTdiInfo' maestro: description: Maestro details. $ref: '#/components/schemas/GenericPmWithTdiInfo' mc: description: MasterCard details. $ref: '#/components/schemas/GenericPmWithTdiInfo' storeIds: description: The list of stores for this payment method items: type: string type: array visa: description: Visa details. $ref: '#/components/schemas/GenericPmWithTdiInfo' type: object GiroPayInfo: properties: supportEmail: description: The email address of merchant support. type: string required: - supportEmail type: object Key: properties: identifier: description: The unique identifier of the shared key. type: string passphrase: description: The secure passphrase to protect the shared key. type: string version: description: The version number of the shared key. format: int32 type: integer type: object AdditionalSettings: properties: includeEventCodes: description: 'Object containing list of event codes for which the notifcation will be sent. ' items: type: string type: array properties: additionalProperties: type: boolean description: 'Object containing boolean key-value pairs. The key can be any [standard webhook additional setting](https://docs.adyen.com/development-resources/webhooks/additional-settings), and the value indicates if the setting is enabled. For example, `captureDelayHours`: **true** means the standard notifications you get will contain the number of hours remaining until the payment will be captured.' type: object type: object GenericPmWithTdiInfo: properties: transactionDescription: description: Information regarding the transaction description. $ref: '#/components/schemas/TransactionDescriptionInfo' type: object TapToPay: properties: merchantDisplayName: description: The text shown on the screen during the Tap to Pay transaction. type: string type: object WifiProfiles: properties: profiles: description: List of remote Wi-Fi profiles. items: $ref: '#/components/schemas/Profile' type: array settings: description: General Wi-Fi settings. $ref: '#/components/schemas/Settings' type: object Nexo: properties: displayUrls: description: The list of local and public URLs to send display notifications to when using Terminal API. $ref: '#/components/schemas/NotificationUrl' encryptionKey: description: The key you share with Adyen to secure local communications when using Terminal API. $ref: '#/components/schemas/Key' eventUrls: description: The list of local and public URLs to send event notifications to when using Terminal API. $ref: '#/components/schemas/EventUrl' nexoEventUrls: deprecated: true x-deprecatedInVersion: '1' x-deprecatedMessage: Use `eventUrls` instead. description: One or more URLs to send event messages to when using Terminal API. items: type: string type: array notification: description: Configures sending event notifications by pressing a button on a terminal, for example used for pay-at-table. $ref: '#/components/schemas/Notification' type: object Configuration: properties: brand: description: 'Payment method, like **eftpos_australia** or **mc**. See the [possible values](https://docs.adyen.com/development-resources/paymentmethodvariant#management-api). ' type: string country: description: Countries, to filter different surcharge amounts for domestic or international cards. items: type: string type: array currencies: description: Currency, and surcharge percentage or amount. items: $ref: '#/components/schemas/Currency' type: array sources: description: 'Funding source. Possible values: * **Credit** * **Debit**' items: type: string type: array required: - brand - currencies type: object Store: properties: _links: description: Reference to resources connected with the store. $ref: '#/components/schemas/Links' address: description: The address of the store. $ref: '#/components/schemas/StoreLocation' businessLineIds: description: "The unique identifiers of the [business lines](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/businesslines__resParam_id) that the store is associated with.\n If not specified, the business line of the merchant account is used. Required when there are multiple business lines under the merchant account." items: type: string type: array description: description: The description of the store. type: string externalReferenceId: description: 'The unique identifier of the store, used by certain payment methods and tax authorities. Accepts up to 14 digits. Required for CNPJ in Brazil, in the format 00.000.000/00git00-00 separated by dots, slashes, hyphens, or without separators. Optional for Zip in Australia and SIRET in France, required except for nonprofit organizations and incorporated associations. ' type: string id: description: The unique identifier of the store. This value is generated by Adyen. type: string merchantId: description: The unique identifier of the merchant account that the store belongs to. type: string phoneNumber: description: 'The phone number of the store, including ''+'' and country code in the [E.164](https://en.wikipedia.org/wiki/E.164) format. If passed in a different format, we convert and validate the phone number against E.164. ' type: string reference: description: "A reference to recognize the store by. Also known as the store code.\n Allowed characters: lowercase and uppercase letters without diacritics, numbers 0 through 9, hyphen (-), and underscore (_)" type: string shopperStatement: description: The store name shown on the shopper's bank or credit card statement and on the shopper receipt. type: string splitConfiguration: description: Rules for Adyen for Platforms merchants to split the transaction amount and fees. $ref: '#/components/schemas/StoreSplitConfiguration' status: description: "The status of the store. Possible values are:\n\n- **active**. This value is assigned automatically when a store is created. \n- **inactive**. The terminals under the store are blocked from accepting new transactions, but capturing outstanding transactions is still possible.\n- **closed**. This status is irreversible. The terminals under the store are reassigned to the merchant inventory." enum: - active - closed - inactive type: string type: object EventUrl: properties: eventLocalUrls: description: One or more local URLs to send event notifications to when using Terminal API. items: $ref: '#/components/schemas/Url' type: array eventPublicUrls: description: One or more public URLs to send event notifications to when using Terminal API. items: $ref: '#/components/schemas/Url' type: array type: object SplitConfiguration: properties: description: description: Your description for the split configuration. maxLength: 300 type: string rules: description: Array of rules that define the split configuration behavior. items: $ref: '#/components/schemas/SplitConfigurationRule' type: array splitConfigurationId: description: Unique identifier of the split configuration. readOnly: true type: string stores: description: List of stores to which the split configuration applies. items: type: string readOnly: true type: array required: - description - rules type: object PayoutSettingsRequest: properties: enabled: description: 'Indicates if payouts to this bank account are enabled. Default: **true**. To receive payouts into this bank account, both `enabled` and `allowed` must be **true**.' type: boolean enabledFromDate: description: 'The date when Adyen starts paying out to this bank account. Format: [ISO 8601](https://www.w3.org/TR/NOTE-datetime), for example, **2019-11-23T12:25:28Z** or **2020-05-27T20:25:28+08:00**. If not specified, the `enabled` field indicates if payouts are enabled for this bank account. If a date is specified and: * `enabled`: **true**, payouts are enabled starting the specified date. * `enabled`: **false**, payouts are disabled until the specified date. On the specified date, `enabled` changes to **true** and this field is reset to **null**.' type: string transferInstrumentId: description: The unique identifier of the [transfer instrument](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/transferInstruments) that contains the details of the bank account. type: string required: - transferInstrumentId type: object BcmcInfo: properties: enableBcmcMobile: description: Indicates if [Bancontact mobile](https://docs.adyen.com/payment-methods/bancontact/bancontact-mobile) is enabled. type: boolean transactionDescription: description: Information regarding the transaction description. $ref: '#/components/schemas/TransactionDescriptionInfo' type: object Links: properties: self: description: Link to the resource itself. $ref: '#/components/schemas/LinksElement' required: - self type: object ClearpayInfo: properties: supportUrl: description: Support Url type: string required: - supportUrl type: object RequestActivationResponse: properties: companyId: description: The unique identifier of the company account. type: string merchantId: description: The unique identifier of the merchant account you requested to activate. type: string type: object TerminalProductPrice: properties: currency: description: The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes). type: string value: description: The price of the item. format: double type: number type: object GenerateClientKeyResponse: properties: clientKey: description: Generated client key type: string required: - clientKey type: object ListStoresResponse: properties: _links: description: Pagination references. $ref: '#/components/schemas/PaginationLinks' data: description: List of stores items: $ref: '#/components/schemas/Store' type: array itemsTotal: description: Total number of items. format: int32 type: integer pagesTotal: description: Total number of pages. format: int32 type: integer required: - itemsTotal - pagesTotal type: object UpdateMerchantApiCredentialRequest: properties: active: description: Indicates if the API credential is enabled. type: boolean allowedOrigins: description: The new list of [allowed origins](https://docs.adyen.com/development-resources/client-side-authentication#allowed-origins) for the API credential. items: type: string type: array description: description: Description of the API credential. type: string roles: description: List of [roles](https://docs.adyen.com/development-resources/api-credentials#roles-1) for the API credential. Only roles assigned to 'ws@Company.' can be assigned to other API credentials. items: type: string type: array type: object LinksElement: properties: href: type: string type: object PaymentMethodSetupInfo: properties: afterpayTouch: description: Afterpay Touch details. $ref: '#/components/schemas/AfterpayTouchInfo' applePay: description: Apple Pay details. $ref: '#/components/schemas/ApplePayInfo' bcmc: description: Bancontact details. $ref: '#/components/schemas/BcmcInfo' businessLineId: description: The unique identifier of the business line. Required if you have a [platform setup](https://docs.adyen.com/marketplaces-and-platforms/platform-structure-resources/platform-setup/). type: string cartesBancaires: description: Cartes Bancaires details. $ref: '#/components/schemas/CartesBancairesInfo' clearpay: description: Clearpay details. $ref: '#/components/schemas/ClearpayInfo' countries: description: The list of countries where a payment method is available. By default, all countries supported by the payment method. items: type: string type: array cup: description: China Union Pay details. $ref: '#/components/schemas/GenericPmWithTdiInfo' currencies: description: The list of currencies that a payment method supports. By default, all currencies supported by the payment method. items: type: string type: array customRoutingFlags: description: The list of custom routing flags to route payment to the intended acquirer. items: type: string type: array diners: description: Diners details. $ref: '#/components/schemas/GenericPmWithTdiInfo' discover: description: Discover details. $ref: '#/components/schemas/GenericPmWithTdiInfo' eftpos_australia: description: Eftpos Australia details. $ref: '#/components/schemas/GenericPmWithTdiInfo' giroPay: description: giropay details. $ref: '#/components/schemas/GiroPayInfo' girocard: description: Girocard details. $ref: '#/components/schemas/GenericPmWithTdiInfo' googlePay: description: Google Pay details. $ref: '#/components/schemas/GooglePayInfo' ideal: description: iDeal details. $ref: '#/components/schemas/GenericPmWithTdiInfo' interac_card: description: Interac Card details. $ref: '#/components/schemas/GenericPmWithTdiInfo' jcb: description: JCB details. $ref: '#/components/schemas/GenericPmWithTdiInfo' klarna: description: Klarna details. $ref: '#/components/schemas/KlarnaInfo' maestro: description: Maestro details. $ref: '#/components/schemas/GenericPmWithTdiInfo' mc: description: MasterCard details. $ref: '#/components/schemas/GenericPmWithTdiInfo' mealVoucher_FR: description: Meal Voucher FR details. $ref: '#/components/schemas/MealVoucherFRInfo' paypal: description: PayPal details. $ref: '#/components/schemas/PayPalInfo' reference: description: Your reference for the payment method. Supported characters a-z, A-Z, 0-9. maxLength: 150 type: string shopperInteraction: description: 'The sales channel. Required if the merchant account does not have a sales channel. When you provide this field, it overrides the default sales channel set on the merchant account. Possible values: **eCommerce**, **pos**, **contAuth**, and **moto**. ' enum: - eCommerce - pos - moto - contAuth type: string sofort: description: Sofort details. $ref: '#/components/schemas/SofortInfo' storeIds: x-addedInVersion: '3' description: The unique identifier of the store for which to configure the payment method, if any. items: type: string type: array swish: description: Swish details. $ref: '#/components/schemas/SwishInfo' twint: description: Twint details. $ref: '#/components/schemas/TwintInfo' type: description: Payment method [variant](https://docs.adyen.com/development-resources/paymentmethodvariant#management-api). enum: - afterpaytouch - alipay - alipay_hk - amex - applepay - bcmc - blik - cartebancaire - clearpay - cup - diners - directdebit_GB - discover - ebanking_FI - eftpos_australia - elo - elocredit - elodebit - girocard - googlepay - hiper - hipercard - ideal - interac_card - jcb - klarna - klarna_account - klarna_paynow - maestro - mbway - mc - mcdebit - mealVoucher_FR - mobilepay - multibanco - onlineBanking_PL - paybybank - paypal - payshop - swish - trustly - twint - twint_pos - vipps - visa - visadebit - vpay - wechatpay - wechatpay_pos type: string vipps: description: Vipps details. $ref: '#/components/schemas/VippsInfo' visa: description: Visa details. $ref: '#/components/schemas/GenericPmWithTdiInfo' required: - type type: object ReceiptPrinting: properties: merchantApproved: description: Print a merchant receipt when the payment is approved. type: boolean merchantCancelled: description: Print a merchant receipt when the transaction is cancelled. type: boolean merchantCaptureApproved: description: Print a merchant receipt when capturing the payment is approved. type: boolean merchantCaptureRefused: description: Print a merchant receipt when capturing the payment is refused. type: boolean merchantRefundApproved: description: Print a merchant receipt when the refund is approved. type: boolean merchantRefundRefused: description: Print a merchant receipt when the refund is refused. type: boolean merchantRefused: description: Print a merchant receipt when the payment is refused. type: boolean merchantVoid: description: Print a merchant receipt when a previous transaction is voided. type: boolean shopperApproved: description: Print a shopper receipt when the payment is approved. type: boolean shopperCancelled: description: Print a shopper receipt when the transaction is cancelled. type: boolean shopperCaptureApproved: description: Print a shopper receipt when capturing the payment is approved. type: boolean shopperCaptureRefused: description: Print a shopper receipt when capturing the payment is refused. type: boolean shopperRefundApproved: description: Print a shopper receipt when the refund is approved. type: boolean shopperRefundRefused: description: Print a shopper receipt when the refund is refused. type: boolean shopperRefused: description: Print a shopper receipt when the payment is refused. type: boolean shopperVoid: description: Print a shopper receipt when a previous transaction is voided. type: boolean type: object IdName: properties: id: description: The identifier of the terminal model. type: string name: description: The name of the terminal model. type: string type: object CreateMerchantUserRequest: properties: accountGroups: description: The list of [account groups](https://docs.adyen.com/account/account-structure#account-groups) associated with this user. items: type: string type: array email: description: The email address of the user. type: string name: description: 'The user''s full name. Allowed length: 1—80 characters.' maxLength: 80 minLength: 1 $ref: '#/components/schemas/Name' roles: description: The list of [roles](https://docs.adyen.com/account/user-roles) for this user. items: type: string type: array timeZoneCode: description: The [tz database name](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) of the time zone of the user. For example, **Europe/Amsterdam**. type: string username: description: The user's email address that will be their username. Must be the same as the one in the `email` field. maxLength: 255 minLength: 1 type: string required: - name - email - username type: object RestServiceError: properties: detail: description: A human-readable explanation specific to this occurrence of the problem. type: string errorCode: description: A code that identifies the problem type. type: string instance: description: A unique URI that identifies the specific occurrence of the problem. type: string invalidFields: description: Detailed explanation of each validation error, when applicable. items: $ref: '#/components/schemas/InvalidField' type: array requestId: description: A unique reference for the request, essentially the same as `pspReference`. type: string response: description: JSON response payload. $ref: '#/components/schemas/JSONObject' status: description: The HTTP status code. format: int32 type: integer title: description: A short, human-readable summary of the problem type. type: string type: description: A URI that identifies the problem type, pointing to human-readable documentation on this problem type. type: string required: - type - errorCode - title - detail - status type: object TestWebhookResponse: properties: data: description: List with test results. Each test webhook we send has a list element with the result. items: $ref: '#/components/schemas/TestOutput' type: array type: object Opi: properties: enablePayAtTable: description: Indicates if Pay at table is enabled. type: boolean payAtTableStoreNumber: description: The store number to use for Pay at Table. type: string payAtTableURL: description: The URL and port number used for Pay at Table communication. type: string type: object Payment: properties: contactlessCurrency: description: The default currency for contactless payments on the payment terminal, as the three-letter [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code. maxLength: 3 minLength: 3 type: string hideMinorUnitsInCurrencies: description: Hides the minor units for the listed [ISO currency codes](https://en.wikipedia.org/wiki/ISO_4217). items: type: string type: array type: object GenerateHmacKeyResponse: properties: hmacKey: description: The HMAC key generated for this webhook. type: string required: - hmacKey type: object KlarnaInfo: properties: autoCapture: description: 'Indicates the status of [Automatic capture](https://docs.adyen.com/online-payments/capture#automatic-capture). Default value: **false**.' type: boolean disputeEmail: description: The email address for disputes. type: string region: description: The region of operation. For example, **NA**, **EU**, **CH**, **AU**. enum: - NA - EU - CH - AU maxLength: 2 minLength: 2 type: string supportEmail: description: The email address of merchant support. type: string required: - region - supportEmail - disputeEmail type: object SplitConfigurationLogic: properties: acquiringFees: description: 'Specifies the logic to apply when booking the transaction fees. Should be combined with adyenFees. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.' enum: - deductFromLiableAccount - deductFromOneBalanceAccount type: string additionalCommission: description: Contains the logic used to calculate your user's commission, booked directly to their balance account. $ref: '#/components/schemas/AdditionalCommission' adyenCommission: description: 'Specifies the logic to apply when booking the transaction fees. Should be combined with schemeFee, interchange & adyenMarkup. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.' enum: - deductFromLiableAccount - deductFromOneBalanceAccount type: string adyenFees: description: 'Specifies the logic to apply when booking the transaction fees. Should be combined with acquiringFees. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.' enum: - deductFromLiableAccount - deductFromOneBalanceAccount type: string adyenMarkup: description: 'Specifies the logic to apply when booking the transaction fees. Should be combined with schemeFee, adyenCommission & interchange. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.' enum: - deductFromLiableAccount - deductFromOneBalanceAccount type: string chargeback: description: 'Specifies the logic to apply when booking the chargeback amount. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**, **deductAccordingToSplitRatio**.' enum: - deductFromLiableAccount - deductFromOneBalanceAccount - deductAccordingToSplitRatio type: string chargebackCostAllocation: description: 'Specifies the logic to apply when allocating the chargeback costs. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**' enum: - deductFromLiableAccount - deductFromOneBalanceAccount type: string commission: description: Contains the logic used to the calculate your platform's commission, booked to your liable balance account. $ref: '#/components/schemas/Commission' interchange: description: 'Specifies the logic to apply when booking the transaction fees. Should be combined with schemeFee, adyenCommission & adyenMarkup. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.' enum: - deductFromLiableAccount - deductFromOneBalanceAccount type: string paymentFee: description: 'Specifies the logic to apply when booking the transaction fees. Cannot be combined with other fees. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.' enum: - deductFromLiableAccount - deductFromOneBalanceAccount type: string remainder: description: 'Specifies the logic to apply when booking the amount left over after currency conversion. Possible values: **addToLiableAccount**, **addToOneBalanceAccount**.' enum: - addToLiableAccount - addToOneBalanceAccount type: string schemeFee: description: 'Specifies the logic to apply when booking the transaction fees. Should be combined with interchange, adyenCommission & adyenMarkup. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.' enum: - deductFromLiableAccount - deductFromOneBalanceAccount type: string splitLogicId: description: Unique identifier of the split logic that is applied when the split configuration conditions are met. readOnly: true type: string surcharge: description: 'Specifies the logic to apply when booking the surcharge amount. Possible values: **addToLiableAccount**, **addToOneBalanceAccount**' enum: - addToLiableAccount - addToOneBalanceAccount type: string tip: description: 'Specifies the logic to apply when booking tips (gratuity). Possible values: **addToLiableAccount**, **addToOneBalanceAccount**.' enum: - addToLiableAccount - addToOneBalanceAccount type: string required: - commission type: object UpdateStoreRequest: properties: address: description: The address of the store. It is not possible to update the country of the store. $ref: '#/components/schemas/UpdatableAddress' businessLineIds: description: The unique identifiers of the [business lines](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/businessLines__resParam_id) that the store is associated with. items: type: string type: array description: description: The description of the store. type: string externalReferenceId: description: 'The unique identifier of the store, used by certain payment methods and tax authorities. Accepts up to 14 digits. Required for CNPJ in Brazil, in the format 00.000.000/00git00-00 separated by dots, slashes, hyphens, or without separators. Optional for Zip in Australia and SIRET in France, required except for nonprofit organizations and incorporated associations. ' type: string phoneNumber: description: 'The phone number of the store, including ''+'' and country code in the [E.164](https://en.wikipedia.org/wiki/E.164) format. If passed in a different format, we convert and validate the phone number against E.164. ' type: string splitConfiguration: description: Rules for Adyen for Platforms merchants to split the transaction amount and fees. $ref: '#/components/schemas/StoreSplitConfiguration' status: description: "The status of the store. Possible values are:\n\n- **active**: This value is assigned automatically when a store is created. \n- **inactive**: The maximum [transaction limits and number of Store-and-Forward transactions](https://docs.adyen.com/point-of-sale/determine-account-structure/configure-features#payment-features) for the store are set to 0. This blocks new transactions, but captures are still possible.\n- **closed**: The terminals of the store are reassigned to the merchant inventory, so they can't process payments.\n\nYou can change the status from **active** to **inactive**, and from **inactive** to **active** or **closed**. \nOnce **closed**, a store can't be reopened." enum: - active - closed - inactive type: string type: object TerminalModelsResponse: properties: data: description: The terminal models that the API credential has access to. items: $ref: '#/components/schemas/IdName' type: array type: object SplitConfigurationList: properties: data: description: List of split configurations applied to the stores under the merchant account. items: $ref: '#/components/schemas/SplitConfiguration' type: array type: object User: properties: _links: description: References to resources connected with this user. $ref: '#/components/schemas/Links' accountGroups: description: The list of [account groups](https://docs.adyen.com/account/account-structure#account-groups) associated with this user. items: type: string type: array active: description: Indicates whether this user is active. type: boolean apps: description: Set of apps available to this user items: type: string type: array email: description: The email address of the user. type: string id: description: The unique identifier of the user. type: string name: description: The user's full name. $ref: '#/components/schemas/Name' roles: description: The list of [roles](https://docs.adyen.com/account/user-roles) for this user. items: type: string type: array timeZoneCode: description: The [tz database name](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) of the time zone of the user. For example, **Europe/Amsterdam**. type: string username: description: The username for this user. maxLength: 255 minLength: 1 type: string required: - id - email - timeZoneCode - username - roles type: object OfflineProcessing: properties: chipFloorLimit: description: The maximum offline transaction amount for chip cards, in the processing currency and specified in [minor units](https://docs.adyen.com/development-resources/currency-codes). format: int32 type: integer offlineSwipeLimits: description: The maximum offline transaction amount for swiped cards, in the specified currency. items: $ref: '#/components/schemas/MinorUnitsMonetaryValue' type: array type: object PayAtTable: properties: authenticationMethod: description: 'Allowed authentication methods: Magswipe, Manual Entry.' enum: - MAGSWIPE - MKE type: string enablePayAtTable: description: Enable Pay at table. type: boolean paymentInstrument: description: 'Sets the allowed payment instrument for Pay at table transactions. Can be: **cash** or **card**. If not set, the terminal presents both options.' enum: - Cash - Card type: string type: object ApiCredentialLinks: properties: allowedOrigins: description: List of allowed origins. $ref: '#/components/schemas/LinksElement' company: description: Company account that the API credential is linked to. Only present for company-level webhooks. $ref: '#/components/schemas/LinksElement' generateApiKey: description: 'Generates a new API key. When you generate a new one, the existing key remains valid for 24 hours. ' $ref: '#/components/schemas/LinksElement' generateClientKey: description: Generates a new client key, used to authenticate client-side requests. When you generate a new one, the existing key remains valid for 24 hours. $ref: '#/components/schemas/LinksElement' merchant: description: The merchant account that the API credential is linked to. Only present for merchant-level API credentials. $ref: '#/components/schemas/LinksElement' self: description: Link to the resource itself. $ref: '#/components/schemas/LinksElement' required: - self type: object ListMerchantResponse: properties: _links: description: Pagination references. $ref: '#/components/schemas/PaginationLinks' data: description: The list of merchant accounts. items: $ref: '#/components/schemas/Merchant' type: array itemsTotal: description: Total number of items. format: int32 type: integer pagesTotal: description: Total number of pages. format: int32 type: integer required: - itemsTotal - pagesTotal type: object Name2: properties: firstName: description: The first name. type: string lastName: description: The last name. type: string type: object Url: properties: encrypted: description: Indicates if the message sent to this URL should be encrypted. type: boolean password: description: The password for authentication of the notifications. type: string url: description: 'The URL in the format: http(s)://domain.com.' type: string username: description: The username for authentication of the notifications. type: string type: object ReceiptOptions: properties: logo: description: The receipt logo converted to a Base64-encoded string. The image must be a .bmp file of < 256 KB, dimensions 240 (H) x 384 (W) px. maxLength: 350000 type: string promptBeforePrinting: description: Indicates whether a screen appears asking if you want to print the shopper receipt. type: boolean qrCodeData: description: "Data to print on the receipt as a QR code. This can include static text and the following variables:\n\n- `${merchantreference}`: the merchant reference of the transaction.\n- `${pspreference}`: the PSP reference of the transaction.\n\n For example, **http://www.example.com/order/${pspreference}/${merchantreference}**." type: string type: object ShippingLocationsResponse: properties: data: description: Physical locations where orders can be shipped to. items: $ref: '#/components/schemas/ShippingLocation' type: array type: object TerminalSettings: properties: cardholderReceipt: description: Settings to define the header of the shopper receipt. $ref: '#/components/schemas/CardholderReceipt' connectivity: description: Settings for terminal connectivity features. $ref: '#/components/schemas/Connectivity' gratuities: description: Settings for tipping with or without predefined options to choose from. The maximum number of predefined options is four, or three plus the option to enter a custom tip. items: $ref: '#/components/schemas/Gratuity' type: array hardware: description: Settings for terminal hardware features. $ref: '#/components/schemas/Hardware' localization: description: Settings for localization. $ref: '#/components/schemas/Localization' nexo: description: Settings for a Terminal API integration. $ref: '#/components/schemas/Nexo' offlineProcessing: description: Settings for [offline payment](https://docs.adyen.com/point-of-sale/offline-payments) features. $ref: '#/components/schemas/OfflineProcessing' opi: description: Settings for an Oracle Payment Interface (OPI) integration. $ref: '#/components/schemas/Opi' passcodes: description: Settings for [passcodes](https://docs.adyen.com/point-of-sale/managing-terminals/menu-access?tab=manage_passcodes_with_an_api_call_2#manage-passcodes) features. $ref: '#/components/schemas/Passcodes' payAtTable: description: Settings for [Pay-at-table](https://docs.adyen.com/point-of-sale/pay-at-x) features. $ref: '#/components/schemas/PayAtTable' payment: description: Settings for payment features. $ref: '#/components/schemas/Payment' receiptOptions: description: Generic receipt settings. $ref: '#/components/schemas/ReceiptOptions' receiptPrinting: description: Transaction outcomes that you want the terminal to print a merchant receipt or a shopper receipt for. $ref: '#/components/schemas/ReceiptPrinting' refunds: description: Settings for refunds. $ref: '#/components/schemas/Refunds' signature: description: Settings to skip signature, sign on display, or sign on receipt. $ref: '#/components/schemas/Signature' standalone: description: Settings for [standalone](https://docs.adyen.com/point-of-sale/standalone/standalone-build/set-up-standalone#set-up-standalone-using-an-api-call) features. $ref: '#/components/schemas/Standalone' surcharge: description: Settings for payment [surcharge](https://docs.adyen.com/point-of-sale/surcharge) features. $ref: '#/components/schemas/Surcharge' tapToPay: description: Settings for Tap to Pay. $ref: '#/components/schemas/TapToPay' timeouts: description: Settings for device [time-outs](https://docs.adyen.com/point-of-sale/pos-timeouts#device-time-out). $ref: '#/components/schemas/Timeouts' wifiProfiles: description: Remote Wi-Fi profiles for WPA and WPA2 PSK and EAP Wi-Fi networks. $ref: '#/components/schemas/WifiProfiles' type: object InvalidField: properties: message: description: Description of the validation error. type: string name: description: The field that has an invalid value. type: string value: description: The invalid value. type: string required: - name - value - message type: object VippsInfo: properties: logo: description: 'Vipps logo. Format: Base64-encoded string.' type: string subscriptionCancelUrl: description: Vipps subscription cancel url (required in case of [recurring payments](https://docs.adyen.com/online-payments/tokenization)) type: string required: - logo type: object TestOutput: properties: merchantId: description: Unique identifier of the merchant account that the notification is about. type: string output: description: 'The response your server returned for the test webhook. Your server must respond with **[accepted]** for the test webhook to be successful (`data.status`: **success**). Find out more about [accepting notifications](https://docs.adyen.com/development-resources/webhooks#accept-notifications) You can use the value of this field together with the [`responseCode`](https://docs.adyen.com/api-explorer/#/ManagementService/v1/post/merchants/{merchantId}/webhooks/{id}/test__resParam_data-responseCode) value to troubleshoot unsuccessful test webhooks.' type: string requestSent: description: The [body of the notification webhook](https://docs.adyen.com/development-resources/webhooks/understand-notifications#notification-structure) that was sent to your server. type: string responseCode: description: 'The HTTP response code for your server''s response to the test webhook. You can use the value of this field together with the the [`output`](https://docs.adyen.com/api-explorer/#/ManagementService/v1/post/merchants/{merchantId}/webhooks/{id}/test__resParam_data-output) field value to troubleshoot failed test webhooks.' example: '200' type: string responseTime: description: The time between sending the test webhook and receiving the response from your server. You can use it as an indication of how long your server takes to process a webhook notification. Measured in milliseconds, for example **304 ms**. type: string status: description: 'The status of the test request. Possible values are: * **success**, if `data.output`: **[accepted]** and `data.responseCode`: **200**. * **failed**, in all other cases. You can use the value of the [`output`](https://docs.adyen.com/api-explorer/#/ManagementService/v1/post/merchants/{merchantId}/webhooks/{id}/test__resParam_data-output) field together with the [`responseCode`](https://docs.adyen.com/api-explorer/#/ManagementService/v1/post/merchants/{merchantId}/webhooks/{id}/test__resParam_data-responseCode) value to troubleshoot failed test webhooks.' type: string required: - status type: object UpdatePayoutSettingsRequest: properties: enabled: description: 'Indicates if payouts to this bank account are enabled. Default: **true**. To receive payouts into this bank account, both `enabled` and `allowed` must be **true**.' type: boolean type: object AllowedOriginsResponse: properties: data: description: List of allowed origins. items: $ref: '#/components/schemas/AllowedOrigin' type: array type: object JSONObject: type: object MealVoucherFRInfo: properties: conecsId: description: 'Meal Voucher conecsId. Format: digits only' type: string siret: description: 'Meal Voucher siret. Format: 14 digits.' maxLength: 14 minLength: 14 type: string subTypes: description: 'The list of additional payment methods. Allowed values: **mealVoucher_FR_edenred**, **mealVoucher_FR_groupeup**, **mealVoucher_FR_natixis**, **mealVoucher_FR_sodexo**.' items: type: string type: array required: - siret - conecsId - subTypes type: object Timeouts: properties: fromActiveToSleep: description: Indicates the number of seconds of inactivity after which the terminal display goes into sleep mode. format: int32 type: integer type: object TwintInfo: properties: logo: description: 'Twint logo. Format: Base64-encoded string.' type: string required: - logo type: object TestWebhookRequest: properties: notification: description: Custom test notification object. Required when the [`types`](https://docs.adyen.com/api-explorer/#/ManagementService/v1/post/companies/{companyId}/webhooks/{webhookId}/test__reqParam_types) list contains **CUSTOM**. $ref: '#/components/schemas/CustomNotification' types: description: "List of event codes for which to send test notifications. Only the webhook types below are supported. \n\nPossible values if webhook `type`: **standard**:\n\n* **AUTHORISATION**\n* **CHARGEBACK_REVERSED**\n* **ORDER_CLOSED**\n* **ORDER_OPENED**\n* **PAIDOUT_REVERSED**\n* **PAYOUT_THIRDPARTY**\n* **REFUNDED_REVERSED**\n* **REFUND_WITH_DATA**\n* **REPORT_AVAILABLE**\n* **CUSTOM** - set your custom notification fields in the [`notification`](https://docs.adyen.com/api-explorer/#/ManagementService/v1/post/companies/{companyId}/webhooks/{webhookId}/test__reqParam_notification) object.\n\nPossible values if webhook `type`: **banktransfer-notification**:\n\n* **PENDING**\n\nPossible values if webhook `type`: **report-notification**:\n\n* **REPORT_AVAILABLE**\n\nPossible values if webhook `type`: **ideal-notification**:\n\n* **AUTHORISATION**\n\nPossible values if webhook `type`: **pending-notification**:\n\n* **PENDING**\n" items: type: string type: array type: object Webhook: properties: _links: description: References to resources connected with this webhook. $ref: '#/components/schemas/WebhookLinks' acceptsExpiredCertificate: description: 'Indicates if expired SSL certificates are accepted. Default value: **false**.' type: boolean acceptsSelfSignedCertificate: description: 'Indicates if self-signed SSL certificates are accepted. Default value: **false**.' type: boolean acceptsUntrustedRootCertificate: description: 'Indicates if untrusted SSL certificates are accepted. Default value: **false**.' type: boolean accountReference: description: Reference to the account the webook is set on. type: string active: description: Indicates if the webhook configuration is active. The field must be **true** for you to receive webhooks about events related an account. type: boolean additionalSettings: description: Additional shopper and transaction information to be included in your [standard notifications](https://docs.adyen.com/development-resources/webhooks/understand-notifications#event-codes). Find out more about the available [additional settings](https://docs.adyen.com/development-resources/webhooks/additional-settings). $ref: '#/components/schemas/AdditionalSettingsResponse' certificateAlias: description: The alias of our SSL certificate. When you receive a notification from us, the alias from the HMAC signature will match this alias. type: string communicationFormat: description: 'Format or protocol for receiving webhooks. Possible values: * **soap** * **http** * **json** ' enum: - http - json - soap example: soap type: string description: description: Your description for this webhook configuration. type: string encryptionProtocol: x-addedInVersion: '2' description: 'SSL version to access the public webhook URL specified in the `url` field. Possible values: * **TLSv1.3** * **TLSv1.2** * **HTTP** - Only allowed on Test environment. If not specified, the webhook will use `sslVersion`: **TLSv1.2**.' enum: - HTTP - TLSv1.2 - TLSv1.3 example: TLSv1.2 type: string filterMerchantAccountType: description: 'Shows how merchant accounts are included in company-level webhooks. Possible values: * **includeAccounts** * **excludeAccounts** * **allAccounts**: Includes all merchant accounts, and does not require specifying `filterMerchantAccounts`.' enum: - allAccounts - excludeAccounts - includeAccounts type: string filterMerchantAccounts: description: 'A list of merchant account names that are included or excluded from receiving the webhook. Inclusion or exclusion is based on the value defined for `filterMerchantAccountType`. Required if `filterMerchantAccountType` is either: * **includeAccounts** * **excludeAccounts** Not needed for `filterMerchantAccountType`: **allAccounts**.' items: type: string type: array hasError: description: Indicates if the webhook configuration has errors that need troubleshooting. If the value is **true**, troubleshoot the configuration using the [testing endpoint](https://docs.adyen.com/api-explorer/#/ManagementService/v1/post/companies/{companyId}/webhooks/{webhookid}/test). type: boolean hasPassword: description: Indicates if the webhook is password protected. type: boolean hmacKeyCheckValue: description: The [checksum](https://en.wikipedia.org/wiki/Key_checksum_value) of the HMAC key generated for this webhook. You can use this value to uniquely identify the HMAC key configured for this webhook. type: string id: description: Unique identifier for this webhook. type: string networkType: description: Network type for Terminal API details webhooks. enum: - local - public type: string populateSoapActionHeader: description: 'Indicates if the SOAP action header needs to be populated. Default value: **false**. Only applies if `communicationFormat`: **soap**.' type: boolean type: description: 'The type of webhook. Possible values are: - **standard** - **account-settings-notification** - **banktransfer-notification** - **boletobancario-notification** - **directdebit-notification** - **ach-notification-of-change-notification** - **pending-notification** - **ideal-notification** - **ideal-pending-notification** - **report-notification** - **terminal-api-notification** Find out more about [standard notification webhooks](https://docs.adyen.com/development-resources/webhooks/understand-notifications#event-codes) and [other types of notifications](https://docs.adyen.com/development-resources/webhooks/understand-notifications#other-notifications).' type: string url: description: Public URL where webhooks will be sent, for example **https://www.domain.com/webhook-endpoint**. example: http://www.adyen.com type: string username: description: Username to access the webhook URL. type: string required: - type - url - active - communicationFormat type: object TerminalOrdersResponse: properties: data: description: List of orders for payment terminal packages and parts. items: $ref: '#/components/schemas/TerminalOrder' type: array type: object AfterpayTouchInfo: properties: supportUrl: description: Support Url type: string required: - supportUrl type: object CreateMerchantResponse: properties: businessLineId: description: The unique identifier of the [business line](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/businessLines). type: string companyId: description: The unique identifier of the company account. type: string description: description: Your description for the merchant account, maximum 300 characters. maxLength: 300 type: string id: description: The unique identifier of the merchant account. If Adyen set up a template for the `reference`, then the `id` will have the same value as the `reference` that you sent in the request. Otherwise, the value is generated by Adyen. type: string legalEntityId: description: The unique identifier of the [legal entity](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/legalEntities). type: string pricingPlan: description: Partner pricing plan for the merchant, applicable for merchants under AfP managed company accounts. type: string reference: description: Your reference for the merchant account. type: string type: object AllowedOrigin: properties: _links: description: References to resources linked to the allowed origin. $ref: '#/components/schemas/Links' domain: description: Domain of the allowed origin. example: https://adyen.com type: string id: description: Unique identifier of the allowed origin. type: string required: - domain type: object GenerateApiKeyResponse: properties: apiKey: description: The generated API key. type: string required: - apiKey type: object AdditionalCommission: properties: balanceAccountId: description: Unique identifier of the balance account to which the additional commission is booked. type: string fixedAmount: description: A fixed commission fee, in minor units. format: int64 type: integer variablePercentage: description: A variable commission fee, in basis points. format: int64 type: integer type: object CustomNotification: properties: amount: description: The amount of the payment that the notification is about. Set the value in [minor units](https://docs.adyen.com/development-resources/currency-codes). $ref: '#/components/schemas/Amount' eventCode: description: 'The event that caused the notification to be sent.Currently supported values: * **AUTHORISATION** * **CANCELLATION** * **REFUND** * **CAPTURE** * **REPORT_AVAILABLE** * **CHARGEBACK** * **REQUEST_FOR_INFORMATION** * **NOTIFICATION_OF_CHARGEBACK** * **NOTIFICATIONTEST** * **ORDER_OPENED** * **ORDER_CLOSED** * **CHARGEBACK_REVERSED** * **REFUNDED_REVERSED** * **REFUND_WITH_DATA**' type: string eventDate: description: 'The time of the event. Format: [ISO 8601](http://www.w3.org/TR/NOTE-datetime), YYYY-MM-DDThh:mm:ssTZD.' format: date-time type: string merchantReference: description: Your reference for the custom test notification. type: string paymentMethod: description: "The payment method for the payment that the notification is about. Possible values:\n* **amex**\n* **visa**\n* **mc**\n* **maestro**\n* **bcmc**\n* **paypal**\n * **sms**\n * **bankTransfer_NL**\n* **bankTransfer_DE**\n* **bankTransfer_BE**\n* **ideal**\n* **elv**\n* **sepadirectdebit**\n" type: string reason: description: A descripton of what caused the notification. type: string success: description: 'The outcome of the event which the notification is about. Set to either **true** or **false**. ' type: boolean type: object NotificationUrl: properties: localUrls: description: One or more local URLs to send notifications to when using Terminal API. items: $ref: '#/components/schemas/Url' type: array publicUrls: description: One or more public URLs to send notifications to when using Terminal API. items: $ref: '#/components/schemas/Url' type: array type: object Name: properties: firstName: description: The first name. type: string lastName: description: The last name. type: string required: - firstName - lastName type: object TerminalProductsResponse: properties: data: description: Terminal products that can be ordered. items: $ref: '#/components/schemas/TerminalProduct' type: array type: object StoreCreationRequest: properties: address: description: The address of the store. $ref: '#/components/schemas/StoreLocation' businessLineIds: description: 'The unique identifiers of the [business lines](https://docs.adyen.com/api-explorer/legalentity/latest/post/businessLines#responses-200-id) that the store is associated with. If not specified, the business line of the merchant account is used. Required when there are multiple business lines under the merchant account.' items: type: string type: array description: description: Your description of the store. type: string externalReferenceId: description: 'The unique identifier of the store, used by certain payment methods and tax authorities. Accepts up to 14 digits. Required for CNPJ in Brazil, in the format 00.000.000/00git00-00 separated by dots, slashes, hyphens, or without separators. Optional for Zip in Australia and SIRET in France, required except for nonprofit organizations and incorporated associations. ' type: string phoneNumber: description: 'The phone number of the store, including ''+'' and country code in the [E.164](https://en.wikipedia.org/wiki/E.164) format. If passed in a different format, we convert and validate the phone number against E.164. ' type: string reference: description: "Your reference to recognize the store by. Also known as the store code.\n Allowed characters: lowercase and uppercase letters without diacritics, numbers 0 through 9, hyphen (-), and underscore (_).\n\nIf you do not provide a reference in your POST request, it is populated with the Adyen-generated [id](https://docs.adyen.com/api-explorer/Management/latest/post/stores#responses-200-id)." type: string shopperStatement: description: 'The store name to be shown on the shopper''s bank or credit card statement and on the shopper receipt. Maximum length: 22 characters; can''t be all numbers.' type: string splitConfiguration: description: Rules for Adyen for Platforms merchants to split the transaction amount and fees. $ref: '#/components/schemas/StoreSplitConfiguration' required: - description - shopperStatement - phoneNumber - address type: object TerminalOrderRequest: properties: billingEntityId: description: The identification of the billing entity to use for the order. type: string customerOrderReference: description: The merchant-defined purchase order reference. type: string items: description: The products included in the order. items: $ref: '#/components/schemas/OrderItem' type: array orderType: description: Type of order type: string shippingLocationId: description: The identification of the shipping location to use for the order. type: string taxId: description: The tax number of the billing entity. type: string type: object UpdateSplitConfigurationRequest: properties: description: description: Your description for the split configuration. maxLength: 300 type: string required: - description type: object ListWebhooksResponse: properties: _links: description: Pagination references. $ref: '#/components/schemas/PaginationLinks' accountReference: description: Reference to the account. type: string data: description: The list of webhooks configured for this account. items: $ref: '#/components/schemas/Webhook' type: array itemsTotal: description: Total number of items. format: int32 type: integer pagesTotal: description: Total number of pages. format: int32 type: integer required: - itemsTotal - pagesTotal type: object ListMerchantUsersResponse: properties: _links: description: Pagination references. $ref: '#/components/schemas/PaginationLinks' data: description: The list of users. items: $ref: '#/components/schemas/User' type: array itemsTotal: description: Total number of items. format: int32 type: integer pagesTotal: description: Total number of pages. format: int32 type: integer required: - itemsTotal - pagesTotal type: object TerminalOrder: properties: billingEntity: description: The details of the entity that the order is billed to. $ref: '#/components/schemas/BillingEntity' customerOrderReference: description: The merchant-defined purchase order number. This will be printed on the packing list. type: string id: description: The unique identifier of the order. type: string items: description: The products included in the order. items: $ref: '#/components/schemas/OrderItem' type: array orderDate: description: The date and time that the order was placed, in UTC ISO 8601 format. For example, "2011-12-03T10:15:30Z". type: string shippingLocation: description: The details of the location where the order is shipped to. $ref: '#/components/schemas/ShippingLocation' status: description: The processing status of the order. type: string trackingUrl: description: The URL, provided by the carrier company, where the shipment can be tracked. type: string type: object ApiCredential: properties: _links: description: References to resources linked to the API credential. $ref: '#/components/schemas/ApiCredentialLinks' active: description: Indicates if the API credential is enabled. Must be set to **true** to use the credential in your integration. type: boolean allowedIpAddresses: description: 'List of IP addresses from which your client can make requests. If the list is empty, we allow requests from any IP. If the list is not empty and we get a request from an IP which is not on the list, you get a security error.' items: type: string type: array allowedOrigins: description: List containing the [allowed origins](https://docs.adyen.com/development-resources/client-side-authentication#allowed-origins) linked to the API credential. items: $ref: '#/components/schemas/AllowedOrigin' type: array clientKey: description: Public key used for [client-side authentication](https://docs.adyen.com/development-resources/client-side-authentication). The client key is required for Drop-in and Components integrations. type: string description: description: Description of the API credential. maxLength: 50 type: string id: description: Unique identifier of the API credential. type: string roles: description: List of [roles](https://docs.adyen.com/development-resources/api-credentials#roles-1) for the API credential. items: type: string type: array username: description: The name of the [API credential](https://docs.adyen.com/development-resources/api-credentials), for example **ws@Company.TestCompany**. type: string required: - id - username - clientKey - allowedIpAddresses - roles - active type: object Amount: properties: currency: description: The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes). maxLength: 3 minLength: 3 type: string value: description: The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes). format: int64 type: integer required: - value - currency type: object StoreSplitConfiguration: properties: balanceAccountId: description: The [unique identifier of the balance account](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/get/balanceAccounts/{id}__queryParam_id) to which the split amount must be booked, depending on the defined [split logic](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/_merchantId_/splitConfigurations#request-rules-splitLogic). type: string splitConfigurationId: description: The unique identifier of the [split configuration profile](https://docs.adyen.com/marketplaces-and-platforms/automatic-split-configuration/create-split-configuration/). type: string type: object DataCenter: properties: livePrefix: description: 'The unique [live URL prefix](https://docs.adyen.com/development-resources/live-endpoints#live-url-prefix) for your live endpoint. Each data center has its own live URL prefix. This field is empty for requests made in the test environment.' type: string name: description: "The name assigned to a data center, for example **EU** for the European data center. Possible values are:\n\n* **default**: the European data center. This value is always returned in the test environment. \n* **AU**\n* **EU**\n* **US**" type: string type: object Refunds: properties: referenced: description: Settings for referenced refunds. $ref: '#/components/schemas/Referenced' type: object Commission: properties: fixedAmount: description: A fixed commission fee, in minor units. format: int64 type: integer variablePercentage: description: A variable commission fee, in basis points. format: int64 type: integer type: object Settings: properties: band: description: 'The preferred Wi-Fi band, for use if the terminals support multiple bands. Possible values: All, 2.4GHz, 5GHz.' type: string roaming: description: Indicates whether roaming is enabled on the terminals. type: boolean timeout: description: 'The connection time-out in seconds. Minimum value: 0.' format: int32 type: integer type: object UpdateSplitConfigurationRuleRequest: properties: currency: description: 'The currency condition that defines whether the split logic applies. Its value must be a three-character [ISO currency code](https://en.wikipedia.org/wiki/ISO_4217).' type: string fundingSource: description: 'The funding source condition of the payment method (only for cards). Possible values: **credit**, **debit**, or **ANY**.' type: string paymentMethod: description: 'The payment method condition that defines whether the split logic applies. Possible values: * [Payment method variant](https://docs.adyen.com/development-resources/paymentmethodvariant): Apply the split logic for a specific payment method. * **ANY**: Apply the split logic for all available payment methods.' type: string shopperInteraction: description: 'The sales channel condition that defines whether the split logic applies. Possible values: * **Ecommerce**: Online transactions where the cardholder is present. * **ContAuth**: Card on file and/or subscription transactions, where the cardholder is known to the merchant (returning customer). * **Moto**: Mail-order and telephone-order transactions where the customer is in contact with the merchant via email or telephone. * **POS**: Point-of-sale transactions where the customer is physically present to make a payment using a secure payment terminal. * **ANY**: All sales channels.' type: string required: - paymentMethod - shopperInteraction - currency type: object UpdatableAddress: properties: city: description: The name of the city. type: string line1: description: The street address. type: string line2: description: Second address line. type: string line3: description: Third address line. type: string postalCode: description: The postal code. type: string stateOrProvince: description: "The state or province code as defined in [ISO 3166-2](https://www.iso.org/standard/72483.html). For example, **ON** for Ontario, Canada.\n\nRequired for the following countries:\n - Australia\n- Brazil\n- Canada\n- India\n- Mexico\n- New Zealand\n- United States" type: string type: object Contact: properties: email: description: The individual's email address. type: string firstName: description: The individual's first name. type: string infix: description: The infix in the individual's name, if any. type: string lastName: description: The individual's last name. type: string phoneNumber: description: The individual's phone number, specified as 10-14 digits with an optional `+` prefix. type: string type: object UpdateMerchantUserRequest: properties: accountGroups: description: The list of [account groups](https://docs.adyen.com/account/account-structure#account-groups) associated with this user. items: type: string type: array active: description: Sets the status of the user to active (**true**) or inactive (**false**). type: boolean email: description: The email address of the user. type: string name: description: The user's full name. maxLength: 80 minLength: 1 $ref: '#/components/schemas/Name2' roles: description: The list of [roles](https://docs.adyen.com/account/user-roles) for this user. items: type: string type: array timeZoneCode: description: The [tz database name](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) of the time zone of the user. For example, **Europe/Amsterdam**. type: string type: object StoreLocation: properties: city: description: The name of the city. type: string country: description: The two-letter country code in [ISO_3166-1_alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format. type: string line1: description: The street address. type: string line2: description: Second address line. type: string line3: description: Third address line. type: string postalCode: description: The postal code. type: string stateOrProvince: description: "The state or province code as defined in [ISO 3166-2](https://www.iso.org/standard/72483.html). For example, **ON** for Ontario, Canada.\n\nRequired for the following countries:\n - Australia\n- Brazil\n- Canada\n- India\n- Mexico\n- New Zealand\n- United States" type: string required: - country type: object UpdateMerchantWebhookRequest: properties: acceptsExpiredCertificate: description: 'Indicates if expired SSL certificates are accepted. Default value: **false**.' type: boolean acceptsSelfSignedCertificate: description: 'Indicates if self-signed SSL certificates are accepted. Default value: **false**.' type: boolean acceptsUntrustedRootCertificate: description: 'Indicates if untrusted SSL certificates are accepted. Default value: **false**.' type: boolean active: description: Indicates if the webhook configuration is active. The field must be **true** for us to send webhooks about events related an account. type: boolean additionalSettings: description: Additional shopper and transaction information to be included in your [standard notifications](https://docs.adyen.com/development-resources/webhooks/understand-notifications#event-codes). Find out more about the available [additional settings](https://docs.adyen.com/development-resources/webhooks/additional-settings). $ref: '#/components/schemas/AdditionalSettings' communicationFormat: description: 'Format or protocol for receiving webhooks. Possible values: * **soap** * **http** * **json** ' enum: - http - json - soap example: soap type: string description: description: Your description for this webhook configuration. type: string encryptionProtocol: x-addedInVersion: '2' description: 'SSL version to access the public webhook URL specified in the `url` field. Possible values: * **TLSv1.3** * **TLSv1.2** * **HTTP** - Only allowed on Test environment. If not specified, the webhook will use `sslVersion`: **TLSv1.2**.' enum: - HTTP - TLSv1.2 - TLSv1.3 example: TLSv1.2 type: string networkType: description: 'Network type for Terminal API notification webhooks. Possible values: * **public** * **local** Default Value: **public**.' enum: - local - public type: string password: description: Password to access the webhook URL. type: string populateSoapActionHeader: description: 'Indicates if the SOAP action header needs to be populated. Default value: **false**. Only applies if `communicationFormat`: **soap**.' type: boolean url: description: Public URL where webhooks will be sent, for example **https://www.domain.com/webhook-endpoint**. example: http://www.adyen.com type: string username: description: Username to access the webhook URL. maxLength: 255 type: string type: object Merchant: properties: _links: description: References to resources connected with this merchant. $ref: '#/components/schemas/MerchantLinks' captureDelay: description: 'The [capture delay](https://docs.adyen.com/online-payments/capture#capture-delay) set for the merchant account. Possible values: * **Immediate** * **Manual** * Number of days from **1** to **29**' type: string companyId: description: The unique identifier of the company account this merchant belongs to type: string dataCenters: description: 'List of available data centers. Adyen has several data centers around the world.In the URL that you use for making API requests, we recommend you use the live URL prefix from the data center closest to your shoppers.' items: $ref: '#/components/schemas/DataCenter' type: array defaultShopperInteraction: description: The default [`shopperInteraction`](https://docs.adyen.com/api-explorer/#/CheckoutService/v68/post/payments__reqParam_shopperInteraction) value used when processing payments through this merchant account. type: string description: description: Your description for the merchant account, maximum 300 characters type: string id: description: The unique identifier of the merchant account. type: string merchantCity: description: The city where the legal entity of this merchant account is registered. type: string name: description: The name of the legal entity associated with the merchant account. type: string pricingPlan: description: Only applies to merchant accounts managed by Adyen's partners. The name of the pricing plan assigned to the merchant account. type: string primarySettlementCurrency: description: 'The currency of the country where the legal entity of this merchant account is registered. Format: [ISO currency code](https://docs.adyen.com/development-resources/currency-codes). For example, a legal entity based in the United States has USD as the primary settlement currency.' type: string reference: description: Reference of the merchant account. type: string shopWebAddress: description: The URL for the ecommerce website used with this merchant account. type: string status: description: 'The status of the merchant account. Possible values: * **PreActive**: The merchant account has been created. Users cannot access the merchant account in the Customer Area. The account cannot process payments. * **Active**: Users can access the merchant account in the Customer Area. If the company account is also **Active**, then payment processing and payouts are enabled. * **InactiveWithModifications**: Users can access the merchant account in the Customer Area. You cannot process new payments but you can still modify payments, for example issue refunds. You can still receive payouts. * **Inactive**: Users can access the merchant account in the Customer Area. Payment processing and payouts are disabled. * **Closed**: The account is closed and this cannot be reversed. Users cannot log in. Payment processing and payouts are disabled.' type: string type: object PaginationLinks: properties: first: description: The first page. $ref: '#/components/schemas/LinksElement' last: description: The last page. $ref: '#/components/schemas/LinksElement' next: description: The next page. Only present if there is a next page. $ref: '#/components/schemas/LinksElement' prev: description: The previous page. Only present if there is a previous page. $ref: '#/components/schemas/LinksElement' self: description: The current page. $ref: '#/components/schemas/LinksElement' required: - self - first - last type: object PayoutSettings: properties: allowed: description: 'Indicates if payouts to the bank account are allowed. This value is set automatically based on the status of the verification process. The value is: * **true** if `verificationStatus` is **valid**. * **false** for all other values.' type: boolean enabled: description: 'Indicates if payouts to this bank account are enabled. Default: **true**. To receive payouts into this bank account, both `enabled` and `allowed` must be **true**.' type: boolean enabledFromDate: description: 'The date when Adyen starts paying out to this bank account. Format: [ISO 8601](https://www.w3.org/TR/NOTE-datetime), for example, **2019-11-23T12:25:28Z** or **2020-05-27T20:25:28+08:00**. If not specified, the `enabled` field indicates if payouts are enabled for this bank account. If a date is specified and: * `enabled`: **true**, payouts are enabled starting the specified date. * `enabled`: **false**, payouts are disabled until the specified date. On the specified date, `enabled` changes to **true** and this field is reset to **null**.' type: string id: description: The unique identifier of the payout setting. type: string priority: description: "Determines how long it takes for the funds to reach the bank account. Adyen pays out based on the [payout frequency](https://docs.adyen.com/account/getting-paid#payout-frequency). Depending on the currencies and banks involved in transferring the money, it may take up to three days for the payout funds to arrive in the bank account.\n\n Possible values:\n* **first**: same day.\n* **urgent**: the next day.\n* **normal**: between 1 and 3 days." enum: - first - normal - urgent type: string transferInstrumentId: description: The unique identifier of the [transfer instrument](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/transferInstruments) that contains the details of the bank account. type: string verificationStatus: description: 'The status of the verification process for the bank account. Possible values: * **valid**: the verification was successful. * **pending**: the verification is in progress. * **invalid**: the information provided is not complete. * **rejected**: there are reasons to refuse working with this entity.' enum: - invalid - pending - rejected - valid type: string required: - transferInstrumentId - id type: object Connectivity: properties: simcardStatus: description: 'Indicates the status of the SIM card in the payment terminal. Can be updated and received only at terminal level, and only for models that support cellular connectivity. Possible values: * **ACTIVATED**: the SIM card is activated. Cellular connectivity may still need to be enabled on the terminal itself, in the **Network** settings. * **INVENTORY**: the SIM card is not activated. The terminal can''t use cellular connectivity.' enum: - ACTIVATED - INVENTORY type: string type: object Profile: properties: authType: description: 'The type of Wi-Fi network. Possible values: **wpa-psk**, **wpa2-psk**, **wpa-eap**, **wpa2-eap**.' type: string autoWifi: description: Indicates whether to automatically select the best authentication method available. Does not work on older terminal models. type: boolean bssType: description: Use **infra** for infrastructure-based networks. This applies to most networks. Use **adhoc** only if the communication is p2p-based between base stations. type: string channel: description: The channel number of the Wi-Fi network. The recommended setting is **0** for automatic channel selection. format: int32 type: integer defaultProfile: description: Indicates whether this is your preferred wireless network. If **true**, the terminal will try connecting to this network first. type: boolean eap: description: 'For `authType` **wpa-eap** or **wpa2-eap**. Possible values: **tls**, **peap**, **leap**, **fast**' type: string eapCaCert: description: For `authType` **wpa-eap** or **wpa2-eap**. The root certificate from the CA that signed the certificate of the RADIUS server that is part of your wireless network. $ref: '#/components/schemas/File' eapClientCert: description: For `eap` **tls**. The certificate chain for the terminals. All terminals in the same network will use the same EAP client certificate. $ref: '#/components/schemas/File' eapClientKey: description: For `eap` **tls**. The RSA private key for the client. Include the lines BEGIN RSA PRIVATE KEY and END RSA PRIVATE KEY. $ref: '#/components/schemas/File' eapClientPwd: description: For `eap` **tls**. The password of the RSA key file, if that file is password-protected. type: string eapIdentity: description: For `authType` **wpa-eap** or **wpa2-eap**. The EAP-PEAP username from your MS-CHAP account. Must match the configuration of your RADIUS server. type: string eapIntermediateCert: description: For `eap` **tls**. The EAP intermediate certificate. $ref: '#/components/schemas/File' eapPwd: description: For `eap` **peap**. The EAP-PEAP password from your MS-CHAP account. Must match the configuration of your RADIUS server. type: string hiddenSsid: description: Indicates if the network doesn't broadcast its SSID. Mandatory for Android terminals, because these terminals rely on this setting to be able to connect to any network. type: boolean name: description: Your name for the Wi-Fi profile. type: string psk: description: For `authType` **wpa-psk or **wpa2-psk**. The password to the wireless network. type: string ssid: description: The name of the wireless network. type: string wsec: description: 'The type of encryption. Possible values: **auto**, **ccmp** (recommended), **tkip**' type: string required: - ssid - bssType - authType - wsec type: object Currency: properties: amount: description: Surcharge amount per transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes). format: int32 type: integer currencyCode: description: Three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes). For example, **AUD**. type: string percentage: description: Surcharge percentage per transaction. The maximum number of decimal places is two. For example, **1%** or **2.27%**. format: double type: number required: - currencyCode type: object Localization: properties: language: description: Language of the terminal. type: string secondaryLanguage: description: Secondary language of the terminal. type: string timezone: description: The time zone of the terminal. type: string type: object UpdateSplitConfigurationLogicRequest: properties: acquiringFees: description: 'Specifies the logic to apply when booking the transaction fees. Should be combined with adyenFees. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.' enum: - deductFromLiableAccount - deductFromOneBalanceAccount type: string additionalCommission: description: Contains the logic used to calculate your user's commission, booked directly to their balance account. $ref: '#/components/schemas/AdditionalCommission' adyenCommission: description: 'Specifies the logic to apply when booking the transaction fees. Should be combined with schemeFee, interchange & adyenMarkup. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.' enum: - deductFromLiableAccount - deductFromOneBalanceAccount type: string adyenFees: description: 'Specifies the logic to apply when booking the transaction fees. Should be combined with acquiringFees. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.' enum: - deductFromLiableAccount - deductFromOneBalanceAccount type: string adyenMarkup: description: 'Specifies the logic to apply when booking the transaction fees. Should be combined with schemeFee, adyenCommission & interchange. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.' enum: - deductFromLiableAccount - deductFromOneBalanceAccount type: string chargeback: description: 'Specifies the logic to apply when booking the chargeback amount. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**, **deductAccordingToSplitRatio**.' enum: - deductFromLiableAccount - deductFromOneBalanceAccount - deductAccordingToSplitRatio type: string chargebackCostAllocation: description: 'Specifies the logic to apply when allocating the chargeback costs. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**' enum: - deductFromLiableAccount - deductFromOneBalanceAccount type: string commission: description: Contains the logic used to the calculate your platform's commission, booked to your liable balance account. $ref: '#/components/schemas/Commission' interchange: description: 'Specifies the logic to apply when booking the transaction fees. Should be combined with schemeFee, adyenCommission & adyenMarkup. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.' enum: - deductFromLiableAccount - deductFromOneBalanceAccount type: string paymentFee: description: 'Specifies the logic to apply when booking the transaction fees. Cannot be combined with other fees. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.' enum: - deductFromLiableAccount - deductFromOneBalanceAccount type: string remainder: description: 'Specifies the logic to apply when booking the amount left over after currency conversion. Possible values: **addToLiableAccount**, **addToOneBalanceAccount**.' enum: - addToLiableAccount - addToOneBalanceAccount type: string schemeFee: description: 'Specifies the logic to apply when booking the transaction fees. Should be combined with interchange, adyenCommission & adyenMarkup. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.' enum: - deductFromLiableAccount - deductFromOneBalanceAccount type: string splitLogicId: description: Unique identifier of the split logic that is applied when the split configuration conditions are met. readOnly: true type: string surcharge: description: 'Specifies the logic to apply when booking the surcharge amount. Possible values: **addToLiableAccount**, **addToOneBalanceAccount**' enum: - addToLiableAccount - addToOneBalanceAccount type: string tip: description: 'Specifies the logic to apply when booking tips (gratuity). Possible values: **addToLiableAccount**, **addToOneBalanceAccount**.' enum: - addToLiableAccount - addToOneBalanceAccount type: string required: - commission type: object SplitConfigurationRule: properties: currency: description: 'The currency condition that defines whether the split logic applies. Its value must be a three-character [ISO currency code](https://en.wikipedia.org/wiki/ISO_4217).' type: string fundingSource: description: 'The funding source condition of the payment method (only for cards). Possible values: **credit**, **debit**, or **ANY**.' enum: - credit - debit - ANY type: string paymentMethod: description: 'The payment method condition that defines whether the split logic applies. Possible values: * [Payment method variant](https://docs.adyen.com/development-resources/paymentmethodvariant): Apply the split logic for a specific payment method. * **ANY**: Apply the split logic for all available payment methods.' type: string ruleId: description: The unique identifier of the split configuration rule. readOnly: true type: string shopperInteraction: description: 'The sales channel condition that defines whether the split logic applies. Possible values: * **Ecommerce**: Online transactions where the cardholder is present. * **ContAuth**: Card on file and/or subscription transactions, where the cardholder is known to the merchant (returning customer). * **Moto**: Mail-order and telephone-order transactions where the customer is in contact with the merchant via email or telephone. * **POS**: Point-of-sale transactions where the customer is physically present to make a payment using a secure payment terminal. * **ANY**: All sales channels.' enum: - Ecommerce - ContAuth - Moto - POS - ANY type: string splitLogic: description: Contains the split logic that is applied if the rule conditions are met. $ref: '#/components/schemas/SplitConfigurationLogic' required: - paymentMethod - shopperInteraction - currency - splitLogic type: object File: properties: data: description: The certificate content converted to a Base64-encoded string. type: string name: description: The name of the certificate. Must be unique across Wi-Fi profiles. type: string required: - name - data type: object CreateMerchantRequest: properties: businessLineId: description: The unique identifier of the [business line](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/businessLines). Required for an Adyen for Platforms Manage integration. type: string companyId: description: The unique identifier of the company account. type: string description: description: Your description for the merchant account, maximum 300 characters. maxLength: 300 type: string legalEntityId: description: The unique identifier of the [legal entity](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/legalEntities). Required for an Adyen for Platforms Manage integration. type: string pricingPlan: description: Sets the pricing plan for the merchant account. Required for an Adyen for Platforms Manage integration. Your Adyen contact will provide the values that you can use. type: string reference: description: Your reference for the merchant account. To make this reference the unique identifier of the merchant account, your Adyen contact can set up a template on your company account. The template can have 6 to 255 characters with upper- and lower-case letters, underscores, and numbers. When your company account has a template, then the `reference` is required and must be unique within the company account. type: string salesChannels: description: List of sales channels that the merchant will process payments with items: type: string type: array required: - companyId type: object MerchantLinks: properties: apiCredentials: $ref: '#/components/schemas/LinksElement' self: description: Link to the resource itself. $ref: '#/components/schemas/LinksElement' users: $ref: '#/components/schemas/LinksElement' webhooks: $ref: '#/components/schemas/LinksElement' required: - self type: object CartesBancairesInfo: properties: siret: description: 'Cartes Bancaires SIRET. Format: 14 digits.' type: string transactionDescription: description: Information regarding the transaction description. $ref: '#/components/schemas/TransactionDescriptionInfo' required: - siret type: object ApplePayInfo: properties: domains: description: 'The list of merchant domains. Maximum: 99 domains per request. For more information, see [Apple Pay documentation](https://docs.adyen.com/payment-methods/apple-pay/web-drop-in?tab=adyen-certificate-live_1#going-live).' items: type: string type: array required: - domains type: object BillingEntitiesResponse: properties: data: description: List of legal entities that can be used for the billing of orders. items: $ref: '#/components/schemas/BillingEntity' type: array type: object Signature: properties: askSignatureOnScreen: description: If `skipSignature` is false, indicates whether the shopper should provide a signature on the display (**true**) or on the merchant receipt (**false**). type: boolean deviceName: description: Name that identifies the terminal. type: string deviceSlogan: description: Slogan shown on the start screen of the device. maxLength: 50 type: string skipSignature: description: Skip asking for a signature. This is possible because all global card schemes (American Express, Diners, Discover, JCB, MasterCard, VISA, and UnionPay) regard a signature as optional. type: boolean type: object PayPalInfo: properties: directCapture: description: 'Indicates if direct (immediate) capture for PayPal is enabled. If set to **true**, this setting overrides the [capture](https://docs.adyen.com/online-payments/capture) settings of your merchant account. Default value: **true**.' type: boolean payerId: description: 'PayPal Merchant ID. Character length and limitations: 13 single-byte alphanumeric characters.' maxLength: 13 minLength: 13 type: string subject: description: Your business email address. type: string required: - subject - payerId type: object Hardware: properties: displayMaximumBackLight: description: The brightness of the display when the terminal is being used, expressed as a percentage. format: int32 type: integer resetTotalsHour: description: 'The hour of the day when the terminal is set to reset the Totals report. By default, the reset hour is at 6:00 AM in the timezone of the terminal. Minimum value: 0, maximum value: 23.' format: int32 type: integer restartHour: description: 'The hour of the day when the terminal is set to reboot to apply the configuration and software updates. By default, the restart hour is at 6:00 AM in the timezone of the terminal. Minimum value: 0, maximum value: 23.' format: int32 type: integer type: object AdditionalSettingsResponse: properties: excludeEventCodes: description: 'Object containing list of event codes for which the notifcation will not be sent. ' items: type: string type: array includeEventCodes: description: 'Object containing list of event codes for which the notifcation will be sent. ' items: type: string type: array properties: additionalProperties: type: boolean description: 'Object containing boolean key-value pairs. The key can be any [standard webhook additional setting](https://docs.adyen.com/development-resources/webhooks/additional-settings), and the value indicates if the setting is enabled. For example, `captureDelayHours`: **true** means the standard notifications you get will contain the number of hours remaining until the payment will be captured.' type: object type: object Surcharge: properties: askConfirmation: description: Show the surcharge details on the terminal, so the shopper can confirm. type: boolean configurations: description: Surcharge fees or percentages for specific payment methods, funding sources (credit or debit), and currencies. items: $ref: '#/components/schemas/Configuration' type: array type: object Referenced: properties: enableStandaloneRefunds: description: Indicates whether referenced refunds are enabled on the standalone terminal. type: boolean type: object CardholderReceipt: properties: headerForAuthorizedReceipt: description: A custom header to show on the shopper receipt for an authorised transaction. Allows one or two comma-separated header lines, and blank lines. For example, `header,header,filler` type: string type: object CreateUserResponse: properties: _links: description: References to resources connected with this user. $ref: '#/components/schemas/Links' accountGroups: description: The list of [account groups](https://docs.adyen.com/account/account-structure#account-groups) associated with this user. items: type: string type: array active: description: Indicates whether this user is active. type: boolean apps: description: Set of apps available to this user items: type: string type: array email: description: The email address of the user. type: string id: description: The unique identifier of the user. type: string name: description: The user's full name. $ref: '#/components/schemas/Name' roles: description: The list of [roles](https://docs.adyen.com/account/user-roles) for this user. items: type: string type: array timeZoneCode: description: The [tz database name](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) of the time zone of the user. For example, **Europe/Amsterdam**. type: string username: description: The username for this user. maxLength: 255 minLength: 1 type: string required: - id - email - timeZoneCode - username - roles type: object PayoutSettingsResponse: properties: data: description: The list of payout accounts. items: $ref: '#/components/schemas/PayoutSettings' type: array type: object securitySchemes: ApiKeyAuth: in: header name: X-API-Key type: apiKey BasicAuth: scheme: basic type: http x-groups: - Account holders - Accounts - Verification