mirror of
https://github.com/gcatanese/adyen-openapi.git
synced 2026-03-10 08:01:24 +00:00
22394 lines
862 KiB
YAML
22394 lines
862 KiB
YAML
openapi: 3.1.0
|
|
servers:
|
|
- url: https://management-test.adyen.com/v3
|
|
info:
|
|
version: '3'
|
|
x-publicVersion: true
|
|
title: Management API
|
|
description: 'Configure and manage your Adyen company and merchant accounts, stores,
|
|
and payment terminals.
|
|
|
|
## Authentication
|
|
|
|
Each request to the Management API must be signed with an API key. [Generate your
|
|
API key](https://docs.adyen.com/development-resources/api-credentials#generate-api-key)
|
|
in the Customer Area and then set this key to the `X-API-Key` header value.
|
|
|
|
|
|
To access the live endpoints, you need to generate a new API key in your live
|
|
Customer Area.
|
|
|
|
## Versioning
|
|
|
|
|
|
Management API handles versioning as part of the endpoint URL. For example, to
|
|
send a request to this version of the `/companies/{companyId}/webhooks` endpoint,
|
|
use:
|
|
|
|
|
|
```text
|
|
|
|
https://management-test.adyen.com/v3/companies/{companyId}/webhooks
|
|
|
|
```
|
|
|
|
|
|
## Going live
|
|
|
|
|
|
To access the live endpoints, you need an API key from your live Customer Area.
|
|
Use this API key to make requests to:
|
|
|
|
|
|
```text
|
|
|
|
https://management-live.adyen.com/v3
|
|
|
|
```
|
|
|
|
|
|
## Release notes
|
|
|
|
Have a look at the [release notes](https://docs.adyen.com/release-notes/management-api)
|
|
to find out what changed in this version!'
|
|
termsOfService: https://www.adyen.com/legal/terms-and-conditions
|
|
contact:
|
|
name: Adyen Developer Experience team
|
|
url: https://github.com/Adyen/adyen-openapi
|
|
tags:
|
|
- name: Account - company level
|
|
- name: Account - merchant level
|
|
- name: Account - store level
|
|
- name: Payout settings - merchant level
|
|
- name: Users - company level
|
|
- name: Users - merchant level
|
|
- name: My API credential
|
|
- name: API credentials - company level
|
|
- name: API credentials - merchant level
|
|
- name: API key - company level
|
|
- name: API key - merchant level
|
|
- name: Client key - company level
|
|
- name: Client key - merchant level
|
|
- name: Allowed origins - company level
|
|
- name: Allowed origins - merchant level
|
|
- name: Webhooks - company level
|
|
- name: Webhooks - merchant level
|
|
- name: Payment methods - merchant level
|
|
- name: Terminals - terminal level
|
|
- name: Terminal actions - company level
|
|
- name: Terminal actions - terminal level
|
|
- name: Terminal orders - company level
|
|
- name: Terminal orders - merchant level
|
|
- name: Terminal settings - company level
|
|
- name: Terminal settings - merchant level
|
|
- name: Terminal settings - store level
|
|
- name: Terminal settings - terminal level
|
|
- name: Android files - company level
|
|
- name: Split configuration - merchant level
|
|
paths:
|
|
/companies:
|
|
get:
|
|
tags:
|
|
- Account - company level
|
|
summary: Get a list of company accounts
|
|
description: "Returns the list of company 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\
|
|
\n* Management API\u2014Account read"
|
|
operationId: get-companies
|
|
x-sortIndex: 0
|
|
x-methodName: listCompanyAccounts
|
|
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-companies-success-200'
|
|
schema:
|
|
$ref: '#/components/schemas/ListCompanyResponse'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/companies/{companyId}:
|
|
get:
|
|
tags:
|
|
- Account - company level
|
|
summary: Get a company account
|
|
description: "Returns the company account specified in the path. Your API credential\
|
|
\ must have access to the company account. \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\u2014Account read"
|
|
operationId: get-companies-companyId
|
|
x-sortIndex: 0
|
|
x-methodName: getCompanyAccount
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
examples:
|
|
success:
|
|
$ref: '#/components/examples/get-companies-companyId-success-200'
|
|
schema:
|
|
$ref: '#/components/schemas/Company'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/companies/{companyId}/androidApps:
|
|
get:
|
|
tags:
|
|
- Android files - company level
|
|
summary: Get a list of Android apps
|
|
description: "Returns a list of the Android apps that are available for the\
|
|
\ company identified in the path. \nThese apps have been uploaded to Adyen\
|
|
\ and can be installed or uninstalled on Android payment terminals through\
|
|
\ [terminal actions](https://docs.adyen.com/point-of-sale/automating-terminal-management/terminal-actions-api).\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\u2014Android files read\n* Management API\u2014Android files\
|
|
\ read and write\n* Management API\u2014Terminal actions read\n* Management\
|
|
\ API\u2014Terminal actions read and write\n\nIn the live environment, requests\
|
|
\ to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: get-companies-companyId-androidApps
|
|
x-sortIndex: 1
|
|
x-methodName: listAndroidApps
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
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 20 items on a page.
|
|
name: pageSize
|
|
in: query
|
|
required: false
|
|
schema:
|
|
format: int32
|
|
type: integer
|
|
- description: The package name that uniquely identifies the Android app.
|
|
name: packageName
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: string
|
|
- description: The version number of the app.
|
|
name: versionCode
|
|
in: query
|
|
required: false
|
|
schema:
|
|
format: int32
|
|
type: integer
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
examples:
|
|
success:
|
|
$ref: '#/components/examples/get-companies-companyId-androidApps-success-200'
|
|
schema:
|
|
$ref: '#/components/schemas/AndroidAppsResponse'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
post:
|
|
tags:
|
|
- Android files - company level
|
|
summary: Upload Android App
|
|
description: "Uploads an Android APK file to Adyen.\nThe maximum APK file size\
|
|
\ is 200 MB.\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\u2014Android files read and write\n\nIn the live environment,\
|
|
\ requests to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment).\n\
|
|
>By choosing to upload, install, or run any third-party applications on an\
|
|
\ Adyen payment terminal, you accept full responsibility and liability for\
|
|
\ any consequences of uploading, installing, or running any such applications."
|
|
x-addedInVersion: '3'
|
|
operationId: post-companies-companyId-androidApps
|
|
x-sortIndex: 4
|
|
x-methodName: uploadAndroidApp
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/UploadAndroidAppResponse'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/companies/{companyId}/androidApps/{id}:
|
|
get:
|
|
tags:
|
|
- Android files - company level
|
|
summary: Get Android app
|
|
description: "Returns the details of the Android app identified in the path.\
|
|
\ \nThese apps have been uploaded to Adyen and can be installed or uninstalled\
|
|
\ on Android payment terminals through [terminal actions](https://docs.adyen.com/point-of-sale/automating-terminal-management/terminal-actions-api).\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\u2014Android files read\n* Management API\u2014Android files\
|
|
\ read and write\n\nIn the live environment, requests to this endpoint are\
|
|
\ subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: get-companies-companyId-androidApps-id
|
|
x-sortIndex: 3
|
|
x-methodName: getAndroidApp
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- description: The unique identifier of the app.
|
|
name: id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AndroidApp'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
patch:
|
|
tags:
|
|
- Android files - company level
|
|
summary: Reprocess Android App
|
|
description: "Reuploads the Android app identified in the path. \nTo make this\
|
|
\ request, your API credential must have this [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions):\n\
|
|
* Management API\u2014Android files read and write\n\nIn the live environment,\
|
|
\ requests to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment).\n\
|
|
>By choosing to upload, install, or run any third-party applications on an\
|
|
\ Adyen payment terminal, you accept full responsibility and liability for\
|
|
\ any consequences of uploading, installing, or running any such applications."
|
|
x-addedInVersion: '3'
|
|
operationId: patch-companies-companyId-androidApps-id
|
|
x-sortIndex: 6
|
|
x-methodName: reprocessAndroidApp
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- description: The unique identifier of the app.
|
|
name: id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/ReprocessAndroidAppResponse'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/companies/{companyId}/androidCertificates:
|
|
get:
|
|
tags:
|
|
- Android files - company level
|
|
summary: Get a list of Android certificates
|
|
description: "Returns a list of the Android certificates that are available\
|
|
\ for the company identified in the path.\nTypically, these certificates enable\
|
|
\ running apps on Android payment terminals. The certificates in the list\
|
|
\ have been uploaded to Adyen and can be installed or uninstalled on Android\
|
|
\ terminals through [terminal actions](https://docs.adyen.com/point-of-sale/automating-terminal-management/terminal-actions-api).\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\u2014Android files read\n* Management API\u2014Android files\
|
|
\ read and write\n* Management API\u2014Terminal actions read\n* Management\
|
|
\ API\u2014Terminal actions read and write\n\nIn the live environment, requests\
|
|
\ to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: get-companies-companyId-androidCertificates
|
|
x-sortIndex: 2
|
|
x-methodName: listAndroidCertificates
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
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 20 items on a page.
|
|
name: pageSize
|
|
in: query
|
|
required: false
|
|
schema:
|
|
format: int32
|
|
type: integer
|
|
- description: The name of the certificate.
|
|
name: certificateName
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: string
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
examples:
|
|
success:
|
|
$ref: '#/components/examples/get-companies-companyId-androidCertificates-success-200'
|
|
schema:
|
|
$ref: '#/components/schemas/AndroidCertificatesResponse'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
post:
|
|
tags:
|
|
- Android files - company level
|
|
summary: Upload Android Certificate
|
|
description: 'Uploads an Android Certificate file to Adyen.
|
|
|
|
|
|
In the live environment, requests to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment).'
|
|
x-addedInVersion: '3'
|
|
operationId: post-companies-companyId-androidCertificates
|
|
x-sortIndex: 5
|
|
x-methodName: uploadAndroidCertificate
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/UploadAndroidCertificateResponse'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/companies/{companyId}/apiCredentials:
|
|
get:
|
|
tags:
|
|
- API credentials - company level
|
|
summary: Get a list of API credentials
|
|
description: "Returns the list of [API credentials](https://docs.adyen.com/development-resources/api-credentials)\
|
|
\ for the company account. 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\u2014API credentials read and write"
|
|
operationId: get-companies-companyId-apiCredentials
|
|
x-sortIndex: 0
|
|
x-methodName: listApiCredentials
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
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-companies-companyId-apiCredentials-success-200'
|
|
schema:
|
|
$ref: '#/components/schemas/ListCompanyApiCredentialsResponse'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
post:
|
|
tags:
|
|
- API credentials - company level
|
|
summary: 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 which merchant accounts the new API credential will have access\
|
|
\ to, as well as its roles and allowed origins.\n\nThe response includes several\
|
|
\ types of authentication details:\n* [API key](https://docs.adyen.com/development-resources/api-authentication#api-key-authentication):\
|
|
\ used for API request authentication.\n* [Client key](https://docs.adyen.com/development-resources/client-side-authentication#how-it-works):\
|
|
\ public key used for client-side authentication.\n* [Username and password](https://docs.adyen.com/development-resources/api-authentication#using-basic-authentication):\
|
|
\ used for basic authentication.\n\n> Make sure you store the API key securely\
|
|
\ in your system. You won't be able to retrieve it later.\n\nIf your API key\
|
|
\ is lost or compromised, you need to [generate a new API key](https://docs.adyen.com/api-explorer/#/ManagementService/v1/post/companies/{companyId}/apiCredentials/{apiCredentialId}/generateApiKey).\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\u2014API credentials read and write"
|
|
operationId: post-companies-companyId-apiCredentials
|
|
x-sortIndex: 0
|
|
x-methodName: createApiCredential
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
examples:
|
|
post-company-credential:
|
|
$ref: '#/components/examples/post-companies-companyId-apiCredentials-post-company-credential'
|
|
schema:
|
|
$ref: '#/components/schemas/CreateCompanyApiCredentialRequest'
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
examples:
|
|
post-company-credential:
|
|
$ref: '#/components/examples/post-companies-companyId-apiCredentials-post-company-credential-200'
|
|
schema:
|
|
$ref: '#/components/schemas/CreateCompanyApiCredentialResponse'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/companies/{companyId}/apiCredentials/{apiCredentialId}:
|
|
get:
|
|
tags:
|
|
- API credentials - company level
|
|
summary: Get an API credential
|
|
description: "Returns the [API credential](https://docs.adyen.com/development-resources/api-credentials)\
|
|
\ identified in the path.\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\u2014API credentials read and write"
|
|
operationId: get-companies-companyId-apiCredentials-apiCredentialId
|
|
x-sortIndex: 0
|
|
x-methodName: getApiCredential
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
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-companies-companyId-apiCredentials-apiCredentialId-success-200'
|
|
schema:
|
|
$ref: '#/components/schemas/CompanyApiCredential'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
patch:
|
|
tags:
|
|
- API credentials - company level
|
|
summary: Update an API credential.
|
|
description: "Changes the API credential's roles, merchant account access, 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\u2014API credentials read and write"
|
|
operationId: patch-companies-companyId-apiCredentials-apiCredentialId
|
|
x-sortIndex: 0
|
|
x-methodName: updateApiCredential
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
examples:
|
|
patch-company-credential:
|
|
$ref: '#/components/examples/patch-companies-companyId-apiCredentials-apiCredentialId-patch-company-credential'
|
|
schema:
|
|
$ref: '#/components/schemas/UpdateCompanyApiCredentialRequest'
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
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-company-credential:
|
|
$ref: '#/components/examples/patch-companies-companyId-apiCredentials-apiCredentialId-patch-company-credential-200'
|
|
schema:
|
|
$ref: '#/components/schemas/CompanyApiCredential'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/companies/{companyId}/apiCredentials/{apiCredentialId}/allowedOrigins:
|
|
get:
|
|
tags:
|
|
- Allowed origins - company level
|
|
summary: 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.\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\u2014API credentials read and write"
|
|
operationId: get-companies-companyId-apiCredentials-apiCredentialId-allowedOrigins
|
|
x-sortIndex: 0
|
|
x-methodName: listAllowedOrigins
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
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-origins:
|
|
$ref: '#/components/examples/get-companies-companyId-apiCredentials-apiCredentialId-allowedOrigins-get-allowed-origins-200'
|
|
schema:
|
|
$ref: '#/components/schemas/AllowedOriginsResponse'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
post:
|
|
tags:
|
|
- Allowed origins - company level
|
|
summary: 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.\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\u2014API credentials read and write"
|
|
operationId: post-companies-companyId-apiCredentials-apiCredentialId-allowedOrigins
|
|
x-sortIndex: 0
|
|
x-methodName: createAllowedOrigin
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
examples:
|
|
add-allowed-origin:
|
|
$ref: '#/components/examples/post-companies-companyId-apiCredentials-apiCredentialId-allowedOrigins-add-allowed-origin'
|
|
schema:
|
|
$ref: '#/components/schemas/AllowedOrigin'
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
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-companies-companyId-apiCredentials-apiCredentialId-allowedOrigins-add-allowed-origin-200'
|
|
schema:
|
|
$ref: '#/components/schemas/AllowedOrigin'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/companies/{companyId}/apiCredentials/{apiCredentialId}/allowedOrigins/{originId}:
|
|
delete:
|
|
tags:
|
|
- Allowed origins - company level
|
|
summary: 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.\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\u2014API credentials read and write"
|
|
operationId: delete-companies-companyId-apiCredentials-apiCredentialId-allowedOrigins-originId
|
|
x-sortIndex: 0
|
|
x-methodName: deleteAllowedOrigin
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
get:
|
|
tags:
|
|
- Allowed origins - company level
|
|
summary: Get an allowed origin
|
|
description: "Returns the [allowed origin](https://docs.adyen.com/development-resources/client-side-authentication#allowed-origins)\
|
|
\ identified in the path.\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\u2014API credentials read and write"
|
|
operationId: get-companies-companyId-apiCredentials-apiCredentialId-allowedOrigins-originId
|
|
x-sortIndex: 0
|
|
x-methodName: getAllowedOrigin
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
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-origin:
|
|
$ref: '#/components/examples/get-companies-companyId-apiCredentials-apiCredentialId-allowedOrigins-originId-get-allowed-origin-200'
|
|
schema:
|
|
$ref: '#/components/schemas/AllowedOrigin'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/companies/{companyId}/apiCredentials/{apiCredentialId}/generateApiKey:
|
|
post:
|
|
tags:
|
|
- API key - company level
|
|
summary: 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.\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\u2014API credentials read and write"
|
|
operationId: post-companies-companyId-apiCredentials-apiCredentialId-generateApiKey
|
|
x-sortIndex: 0
|
|
x-methodName: generateNewApiKey
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
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'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/companies/{companyId}/apiCredentials/{apiCredentialId}/generateClientKey:
|
|
post:
|
|
tags:
|
|
- Client key - company level
|
|
summary: 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.\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\u2014API credentials read and write"
|
|
operationId: post-companies-companyId-apiCredentials-apiCredentialId-generateClientKey
|
|
x-sortIndex: 0
|
|
x-methodName: generateNewClientKey
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
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'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/companies/{companyId}/billingEntities:
|
|
get:
|
|
tags:
|
|
- Terminal orders - company level
|
|
summary: Get a list of billing entities
|
|
description: "Returns the billing entities of the company identified in the\
|
|
\ path and all merchant accounts belonging to the company.\nA billing entity\
|
|
\ is a legal entity where we charge orders to. An order for terminal products\
|
|
\ must contain the ID of a billing entity.\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\u2014Terminal ordering read\n* Management API\u2014Terminal\
|
|
\ ordering read and write\n\nIn the live environment, requests to this endpoint\
|
|
\ are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: get-companies-companyId-billingEntities
|
|
x-sortIndex: 3
|
|
x-methodName: listBillingEntities
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
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-companies-companyId-billingEntities-success-200'
|
|
schema:
|
|
$ref: '#/components/schemas/BillingEntitiesResponse'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/companies/{companyId}/merchants:
|
|
get:
|
|
tags:
|
|
- Account - company level
|
|
summary: Get a list of merchant accounts
|
|
description: "Returns the list of merchant accounts under the company account\
|
|
\ specified in the path. The list only includes 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\u2014Account read"
|
|
operationId: get-companies-companyId-merchants
|
|
x-sortIndex: 0
|
|
x-methodName: listMerchantAccounts
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
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-companies-companyId-merchants-success-200'
|
|
schema:
|
|
$ref: '#/components/schemas/ListMerchantResponse'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/companies/{companyId}/shippingLocations:
|
|
get:
|
|
tags:
|
|
- Terminal orders - company level
|
|
summary: Get a list of shipping locations
|
|
description: "Returns the shipping locations for the company identified in the\
|
|
\ path and all merchant accounts belonging to the company.\nA shipping location\
|
|
\ includes the address where orders can be delivered, and an ID which you\
|
|
\ need to specify when ordering terminal products.\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\u2014Terminal ordering read\n* Management API\u2014Terminal\
|
|
\ ordering read and write\n\nIn the live environment, requests to this endpoint\
|
|
\ are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: get-companies-companyId-shippingLocations
|
|
x-sortIndex: 4
|
|
x-methodName: listShippingLocations
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
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-companies-companyId-shippingLocations-success-200'
|
|
schema:
|
|
$ref: '#/components/schemas/ShippingLocationsResponse'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
post:
|
|
tags:
|
|
- Terminal orders - company level
|
|
summary: Create a shipping location
|
|
description: "Creates a shipping location for the company identified in the\
|
|
\ path. A shipping location defines an address where orders can be delivered.\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\u2014Terminal ordering read and write\n\nIn the live environment,\
|
|
\ requests to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: post-companies-companyId-shippingLocations
|
|
x-sortIndex: 5
|
|
x-methodName: createShippingLocation
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
examples:
|
|
create-shipping-location:
|
|
$ref: '#/components/examples/post-companies-companyId-shippingLocations-create-shipping-location'
|
|
schema:
|
|
$ref: '#/components/schemas/ShippingLocation'
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
examples:
|
|
create-shipping-location:
|
|
$ref: '#/components/examples/post-companies-companyId-shippingLocations-create-shipping-location-200'
|
|
schema:
|
|
$ref: '#/components/schemas/ShippingLocation'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/companies/{companyId}/terminalActions:
|
|
get:
|
|
tags:
|
|
- Terminal actions - company level
|
|
summary: Get a list of terminal actions
|
|
description: "Returns the [terminal actions](https://docs.adyen.com/point-of-sale/automating-terminal-management/terminal-actions-api)\
|
|
\ that have been scheduled for the company identified in the path.The response\
|
|
\ doesn't include actions that are scheduled by Adyen.\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\u2014Terminal actions read\n* Management API\u2014Terminal\
|
|
\ actions read and write\n\nIn the live environment, requests to this endpoint\
|
|
\ are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: get-companies-companyId-terminalActions
|
|
x-sortIndex: 1
|
|
x-methodName: listTerminalActions
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
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 20 items on a page.
|
|
name: pageSize
|
|
in: query
|
|
required: false
|
|
schema:
|
|
format: int32
|
|
type: integer
|
|
- description: "Returns terminal actions with the specified status. \nAllowed\
|
|
\ values: **pending**, **successful**, **failed**, **cancelled**, **tryLater**."
|
|
name: status
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: string
|
|
- description: "Returns terminal actions of the specified type. \nAllowed values:\
|
|
\ **InstallAndroidApp**, **UninstallAndroidApp**, **InstallAndroidCertificate**,\
|
|
\ **UninstallAndroidCertificate**."
|
|
name: type
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: string
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
examples:
|
|
success:
|
|
$ref: '#/components/examples/get-companies-companyId-terminalActions-success-200'
|
|
schema:
|
|
$ref: '#/components/schemas/ListExternalTerminalActionsResponse'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/companies/{companyId}/terminalActions/{actionId}:
|
|
get:
|
|
tags:
|
|
- Terminal actions - company level
|
|
summary: Get terminal action
|
|
description: "Returns the details of the [terminal action](https://docs.adyen.com/point-of-sale/automating-terminal-management/terminal-actions-api)\
|
|
\ identified in the path.\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\u2014Terminal actions read\n* Management API\u2014Terminal\
|
|
\ actions read and write\n\nIn the live environment, requests to this endpoint\
|
|
\ are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: get-companies-companyId-terminalActions-actionId
|
|
x-sortIndex: 2
|
|
x-methodName: getTerminalAction
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- description: The unique identifier of the terminal action.
|
|
name: actionId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
examples:
|
|
success:
|
|
$ref: '#/components/examples/get-companies-companyId-terminalActions-actionId-success-200'
|
|
schema:
|
|
$ref: '#/components/schemas/ExternalTerminalAction'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/companies/{companyId}/terminalLogos:
|
|
get:
|
|
tags:
|
|
- Terminal settings - company level
|
|
summary: Get the terminal logo
|
|
description: "Returns the logo that is configured for a specific payment terminal\
|
|
\ model at the company identified in the path. \n\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 company, unless a different logo is configured at a lower\
|
|
\ level (merchant account, 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\u2014Terminal settings read\n* Management API\u2014Terminal\
|
|
\ settings read and write\n\nIn the live environment, requests to this endpoint\
|
|
\ are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: get-companies-companyId-terminalLogos
|
|
x-sortIndex: 2
|
|
x-methodName: getTerminalLogo
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
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-companies-companyId-terminalLogos-success-200'
|
|
schema:
|
|
$ref: '#/components/schemas/Logo'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
patch:
|
|
tags:
|
|
- Terminal settings - company level
|
|
summary: Update the terminal logo
|
|
description: "Updates the logo that is configured for a specific payment terminal\
|
|
\ model at the company 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 company, unless a different logo is configured\
|
|
\ at a lower level (merchant account, store, or individual terminal). \n*\
|
|
\ To change the logo, specify the image file as a Base64-encoded string.\n\
|
|
* To restore the logo inherited from the Adyen PSP level, 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\u2014Terminal settings read and write\n\nIn the live environment,\
|
|
\ requests to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: patch-companies-companyId-terminalLogos
|
|
x-sortIndex: 4
|
|
x-methodName: updateTerminalLogo
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
examples:
|
|
remove-logo:
|
|
$ref: '#/components/examples/patch-companies-companyId-terminalLogos-remove-logo'
|
|
upload-logo:
|
|
$ref: '#/components/examples/patch-companies-companyId-terminalLogos-upload-logo'
|
|
schema:
|
|
$ref: '#/components/schemas/Logo'
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
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-companies-companyId-terminalLogos-remove-logo-200'
|
|
upload-logo:
|
|
$ref: '#/components/examples/patch-companies-companyId-terminalLogos-upload-logo-200'
|
|
schema:
|
|
$ref: '#/components/schemas/Logo'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/companies/{companyId}/terminalModels:
|
|
get:
|
|
tags:
|
|
- Terminal orders - company level
|
|
summary: Get a list of terminal models
|
|
description: "Returns a list of payment terminal models that the company identified\
|
|
\ in the path has access to.\nThe 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.\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\u2014Terminal ordering read\n* Management API\u2014Terminal\
|
|
\ ordering read and write\n\nIn the live environment, requests to this endpoint\
|
|
\ are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: get-companies-companyId-terminalModels
|
|
x-sortIndex: 1
|
|
x-methodName: listTerminalModels
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
examples:
|
|
success:
|
|
$ref: '#/components/examples/get-companies-companyId-terminalModels-success-200'
|
|
schema:
|
|
$ref: '#/components/schemas/TerminalModelsResponse'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/companies/{companyId}/terminalOrders:
|
|
get:
|
|
tags:
|
|
- Terminal orders - company level
|
|
summary: Get a list of orders
|
|
description: "Returns a lists of terminal products orders for the company identified\
|
|
\ in the path.\nTo filter the list, use one or more of the query parameters.\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\u2014Terminal ordering read\n* Management API\u2014Terminal\
|
|
\ ordering read and write\n\nIn the live environment, requests to this endpoint\
|
|
\ are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: get-companies-companyId-terminalOrders
|
|
x-sortIndex: 7
|
|
x-methodName: listOrders
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
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-companies-companyId-terminalOrders-success-200'
|
|
schema:
|
|
$ref: '#/components/schemas/TerminalOrdersResponse'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
post:
|
|
tags:
|
|
- Terminal orders - company level
|
|
summary: Create an order
|
|
description: "Creates an order for payment terminal products for the company\
|
|
\ identified in the path.\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\u2014Terminal ordering read and write\n>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.\n\nIn the live environment, requests to this endpoint\
|
|
\ are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: post-companies-companyId-terminalOrders
|
|
x-sortIndex: 6
|
|
x-methodName: createOrder
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
examples:
|
|
create-order:
|
|
$ref: '#/components/examples/post-companies-companyId-terminalOrders-create-order'
|
|
schema:
|
|
$ref: '#/components/schemas/TerminalOrderRequest'
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
examples:
|
|
create-order:
|
|
$ref: '#/components/examples/post-companies-companyId-terminalOrders-create-order-200'
|
|
schema:
|
|
$ref: '#/components/schemas/TerminalOrder'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/companies/{companyId}/terminalOrders/{orderId}:
|
|
get:
|
|
tags:
|
|
- Terminal orders - company level
|
|
summary: Get an order
|
|
description: "Returns the details of the terminal products order identified\
|
|
\ in the path.\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\u2014Terminal ordering read\n* Management API\u2014Terminal\
|
|
\ ordering read and write\n\nIn the live environment, requests to this endpoint\
|
|
\ are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: get-companies-companyId-terminalOrders-orderId
|
|
x-sortIndex: 8
|
|
x-methodName: getOrder
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
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-companies-companyId-terminalOrders-orderId-success-200'
|
|
schema:
|
|
$ref: '#/components/schemas/TerminalOrder'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
patch:
|
|
tags:
|
|
- Terminal orders - company level
|
|
summary: Update an order
|
|
description: "Updates the terminal products order identified in the path.\n\
|
|
Updating 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\u2014Terminal ordering read and write\n\nIn the live environment,\
|
|
\ requests to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: patch-companies-companyId-terminalOrders-orderId
|
|
x-sortIndex: 9
|
|
x-methodName: updateOrder
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
examples:
|
|
update-order:
|
|
$ref: '#/components/examples/patch-companies-companyId-terminalOrders-orderId-update-order'
|
|
schema:
|
|
$ref: '#/components/schemas/TerminalOrderRequest'
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
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-companies-companyId-terminalOrders-orderId-update-order-200'
|
|
schema:
|
|
$ref: '#/components/schemas/TerminalOrder'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/companies/{companyId}/terminalOrders/{orderId}/cancel:
|
|
post:
|
|
tags:
|
|
- Terminal orders - company level
|
|
summary: Cancel an order
|
|
description: "Cancels the terminal products order identified in the path.\n\
|
|
Cancelling is only possible while the order has the status **Placed**.\nTo\
|
|
\ 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**.\n\n\
|
|
To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions):\n\
|
|
* Management API\u2014Terminal ordering read and write\n\nIn the live environment,\
|
|
\ requests to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: post-companies-companyId-terminalOrders-orderId-cancel
|
|
x-sortIndex: 10
|
|
x-methodName: cancelOrder
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
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-companies-companyId-terminalOrders-orderId-cancel-cancel-order-200'
|
|
schema:
|
|
$ref: '#/components/schemas/TerminalOrder'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/companies/{companyId}/terminalProducts:
|
|
get:
|
|
tags:
|
|
- Terminal orders - company level
|
|
summary: Get a list of terminal products
|
|
description: "Returns a country-specific list of payment terminal packages and\
|
|
\ parts that the company identified in the path has access to.\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\u2014Terminal ordering read\n* Management API\u2014Terminal\
|
|
\ ordering read and write\n\nIn the live environment, requests to this endpoint\
|
|
\ are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: get-companies-companyId-terminalProducts
|
|
x-sortIndex: 2
|
|
x-methodName: listTerminalProducts
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
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/companies/{companyId}/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-companies-companyId-terminalProducts-success-200'
|
|
schema:
|
|
$ref: '#/components/schemas/TerminalProductsResponse'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/companies/{companyId}/terminalSettings:
|
|
get:
|
|
tags:
|
|
- Terminal settings - company level
|
|
summary: Get terminal settings
|
|
description: "Returns the payment terminal settings that are configured for\
|
|
\ the company identified in the path. These settings apply to all terminals\
|
|
\ under the company, unless different values are configured at a lower level\
|
|
\ (merchant account, 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\u2014Terminal settings read\n* Management API\u2014Terminal\
|
|
\ settings read and write\n\nFor [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:\n* Management API\u2014\
|
|
Terminal settings Advanced read and write\n\nIn the live environment, requests\
|
|
\ to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: get-companies-companyId-terminalSettings
|
|
x-sortIndex: 1
|
|
x-methodName: getTerminalSettings
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
examples:
|
|
success:
|
|
$ref: '#/components/examples/get-companies-companyId-terminalSettings-success-200'
|
|
schema:
|
|
$ref: '#/components/schemas/TerminalSettings'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
patch:
|
|
tags:
|
|
- Terminal settings - company level
|
|
summary: Update terminal settings
|
|
description: "Updates payment terminal settings for the company identified in\
|
|
\ the path. These settings apply to all terminals under the company, unless\
|
|
\ different values are configured at a lower level (merchant account, store,\
|
|
\ or individual terminal).\n\n* 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.\n* To restore a parameter value inherited from\
|
|
\ the Adyen PSP level, include the full object that contains the parameter,\
|
|
\ and specify an empty value for the parameter or omit the parameter.\n* Objects\
|
|
\ that are not included in the request are not updated.\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\u2014Terminal settings read and write\n\nFor [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:\n* Management API\u2014\
|
|
Terminal settings Advanced read and write\n\nIn the live environment, requests\
|
|
\ to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: patch-companies-companyId-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-companies-companyId-terminalSettings-add-eap-peap-and-psk-wifi-profiles'
|
|
add-eap-tls-wifi-profile:
|
|
$ref: '#/components/examples/patch-companies-companyId-terminalSettings-add-eap-tls-wifi-profile'
|
|
schema:
|
|
$ref: '#/components/schemas/TerminalSettings'
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
examples:
|
|
add-eap-peap-and-psk-wifi-profiles:
|
|
$ref: '#/components/examples/patch-companies-companyId-terminalSettings-add-eap-peap-and-psk-wifi-profiles-200'
|
|
add-eap-tls-wifi-profile:
|
|
$ref: '#/components/examples/patch-companies-companyId-terminalSettings-add-eap-tls-wifi-profile-200'
|
|
schema:
|
|
$ref: '#/components/schemas/TerminalSettings'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/companies/{companyId}/users:
|
|
get:
|
|
tags:
|
|
- Users - company level
|
|
summary: Get a list of users
|
|
description: "Returns the list of users for the `companyId` identified in the\
|
|
\ path.\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\u2014Users read and write\n"
|
|
operationId: get-companies-companyId-users
|
|
x-sortIndex: 0
|
|
x-methodName: listUsers
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- description: The number of the page to return.
|
|
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/ListCompanyUsersResponse'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
post:
|
|
tags:
|
|
- Users - company level
|
|
summary: Create a new user
|
|
description: "Creates the user for the `companyId` identified in the path.\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\u2014Users read and write\n"
|
|
operationId: post-companies-companyId-users
|
|
x-sortIndex: 0
|
|
x-methodName: createNewUser
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
examples:
|
|
create-email-user:
|
|
$ref: '#/components/examples/post-companies-companyId-users-create-email-user'
|
|
create-sso-user:
|
|
$ref: '#/components/examples/post-companies-companyId-users-create-sso-user'
|
|
create-user:
|
|
$ref: '#/components/examples/post-companies-companyId-users-create-user'
|
|
schema:
|
|
$ref: '#/components/schemas/CreateCompanyUserRequest'
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
examples:
|
|
create-user:
|
|
$ref: '#/components/examples/post-companies-companyId-users-create-user-200'
|
|
schema:
|
|
$ref: '#/components/schemas/CreateCompanyUserResponse'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/companies/{companyId}/users/{userId}:
|
|
get:
|
|
tags:
|
|
- Users - company level
|
|
summary: Get user details
|
|
description: "Returns user details for the `userId` and the `companyId` identified\
|
|
\ in the path.\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\u2014Users read and write\n"
|
|
operationId: get-companies-companyId-users-userId
|
|
x-sortIndex: 0
|
|
x-methodName: getUserDetails
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- description: The unique identifier of the user.
|
|
name: userId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/CompanyUser'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
patch:
|
|
tags:
|
|
- Users - company level
|
|
summary: Update user details
|
|
description: "Updates user details for the `userId` and the `companyId` identified\
|
|
\ in the path.\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\u2014Users read and write\n"
|
|
operationId: patch-companies-companyId-users-userId
|
|
x-sortIndex: 0
|
|
x-methodName: updateUserDetails
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/UpdateCompanyUserRequest'
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- description: The unique identifier of the user.
|
|
name: userId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/CompanyUser'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/companies/{companyId}/webhooks:
|
|
get:
|
|
tags:
|
|
- Webhooks - company level
|
|
summary: List all webhooks
|
|
description: "Lists all webhook configurations for the company account.\n\n\
|
|
To 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\u2014Webhooks read\n* Management API\u2014Webhooks read and\
|
|
\ write"
|
|
operationId: get-companies-companyId-webhooks
|
|
x-sortIndex: 2
|
|
x-methodName: listAllWebhooks
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: Unique identifier of the [company account](https://docs.adyen.com/account/account-structure#company-account).
|
|
name: companyId
|
|
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-company-webhooks:
|
|
$ref: '#/components/examples/get-companies-companyId-webhooks-get-company-webhooks-200'
|
|
schema:
|
|
$ref: '#/components/schemas/ListWebhooksResponse'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
post:
|
|
tags:
|
|
- Webhooks - company level
|
|
summary: Set up a webhook
|
|
description: "Subscribe to receive webhook notifications about events related\
|
|
\ to your company account. You can add basic authentication to make sure the\
|
|
\ data is secure.\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\u2014Webhooks read and write"
|
|
operationId: post-companies-companyId-webhooks
|
|
x-sortIndex: 1
|
|
x-methodName: setUpWebhook
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
examples:
|
|
post-company-webhook:
|
|
$ref: '#/components/examples/post-companies-companyId-webhooks-post-company-webhook'
|
|
schema:
|
|
$ref: '#/components/schemas/CreateCompanyWebhookRequest'
|
|
parameters:
|
|
- description: Unique identifier of the [company account](https://docs.adyen.com/account/account-structure#company-account).
|
|
name: companyId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
examples:
|
|
post-company-webhook:
|
|
$ref: '#/components/examples/post-companies-companyId-webhooks-post-company-webhook-200'
|
|
schema:
|
|
$ref: '#/components/schemas/Webhook'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/companies/{companyId}/webhooks/{webhookId}:
|
|
delete:
|
|
tags:
|
|
- Webhooks - company level
|
|
summary: Remove a webhook
|
|
description: "Remove the configuration for the webhook identified in the path.\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\u2014Webhooks read and write"
|
|
operationId: delete-companies-companyId-webhooks-webhookId
|
|
x-sortIndex: 5
|
|
x-methodName: removeWebhook
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
get:
|
|
tags:
|
|
- Webhooks - company level
|
|
summary: Get a webhook
|
|
description: "Returns the configuration for the webhook identified in the path.\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\u2014Webhooks read\n* Management API\u2014Webhooks read and\
|
|
\ write"
|
|
operationId: get-companies-companyId-webhooks-webhookId
|
|
x-sortIndex: 3
|
|
x-methodName: getWebhook
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: Unique identifier of the [company account](https://docs.adyen.com/account/account-structure#company-account).
|
|
name: companyId
|
|
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-company-webhook:
|
|
$ref: '#/components/examples/get-companies-companyId-webhooks-webhookId-get-company-webhook-200'
|
|
schema:
|
|
$ref: '#/components/schemas/Webhook'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
patch:
|
|
tags:
|
|
- Webhooks - company level
|
|
summary: 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.\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\u2014Webhooks read and write"
|
|
operationId: patch-companies-companyId-webhooks-webhookId
|
|
x-sortIndex: 4
|
|
x-methodName: updateWebhook
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
examples:
|
|
patch-company-webhook:
|
|
$ref: '#/components/examples/patch-companies-companyId-webhooks-webhookId-patch-company-webhook'
|
|
schema:
|
|
$ref: '#/components/schemas/UpdateCompanyWebhookRequest'
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
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-company-webhook:
|
|
$ref: '#/components/examples/patch-companies-companyId-webhooks-webhookId-patch-company-webhook-200'
|
|
schema:
|
|
$ref: '#/components/schemas/Webhook'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/companies/{companyId}/webhooks/{webhookId}/generateHmac:
|
|
post:
|
|
tags:
|
|
- Webhooks - company level
|
|
summary: 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).\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\u2014Webhooks read and write"
|
|
operationId: post-companies-companyId-webhooks-webhookId-generateHmac
|
|
x-sortIndex: 6
|
|
x-methodName: generateHmacKey
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
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-company-webhook-generateHmac:
|
|
$ref: '#/components/examples/post-companies-companyId-webhooks-webhookId-generateHmac-post-company-webhook-generateHmac-200'
|
|
schema:
|
|
$ref: '#/components/schemas/GenerateHmacKeyResponse'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/companies/{companyId}/webhooks/{webhookId}/test:
|
|
post:
|
|
tags:
|
|
- Webhooks - company level
|
|
summary: Test a webhook
|
|
description: "Sends sample notifications to test if the webhook is set up correctly.\n\
|
|
\nWe send sample notifications for maximum 20 of the merchant accounts that\
|
|
\ the webhook is configured for. If the webhook is configured for more than\
|
|
\ 20 merchant accounts, use the `merchantIds` array to specify a subset of\
|
|
\ the merchant accounts for which to send test notifications.\n\nWe 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.\n\nThe response describes\
|
|
\ the result of the test. The `status` field tells you if the test was successful\
|
|
\ or not. You can use the other response fields to troubleshoot unsuccessful\
|
|
\ tests.\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\u2014Webhooks read and write"
|
|
operationId: post-companies-companyId-webhooks-webhookId-test
|
|
x-sortIndex: 7
|
|
x-methodName: testWebhook
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
examples:
|
|
post-company-webhook-test:
|
|
$ref: '#/components/examples/post-companies-companyId-webhooks-webhookId-test-post-company-webhook-test'
|
|
post-company-webhook-test-custom:
|
|
$ref: '#/components/examples/post-companies-companyId-webhooks-webhookId-test-post-company-webhook-test-custom'
|
|
schema:
|
|
$ref: '#/components/schemas/TestCompanyWebhookRequest'
|
|
parameters:
|
|
- description: The unique identifier of the company account.
|
|
name: companyId
|
|
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-company-webhook-test:
|
|
$ref: '#/components/examples/post-companies-companyId-webhooks-webhookId-test-post-company-webhook-test-200'
|
|
post-company-webhook-test-custom:
|
|
$ref: '#/components/examples/post-companies-companyId-webhooks-webhookId-test-post-company-webhook-test-custom-200'
|
|
schema:
|
|
$ref: '#/components/schemas/TestWebhookResponse'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/me:
|
|
get:
|
|
tags:
|
|
- My API credential
|
|
summary: Get API credential details
|
|
description: 'Returns your [API credential](https://docs.adyen.com/development-resources/api-credentials)
|
|
details based on the API Key you used in the request.
|
|
|
|
|
|
You can make this request with any of the Management API roles.'
|
|
operationId: get-me
|
|
x-sortIndex: 0
|
|
x-methodName: getApiCredentialDetails
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/MeApiCredential'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/me/allowedOrigins:
|
|
get:
|
|
tags:
|
|
- My API credential
|
|
summary: Get allowed origins
|
|
description: 'Returns the list of [allowed origins](https://docs.adyen.com/development-resources/client-side-authentication#allowed-origins)
|
|
of your [API credential](https://docs.adyen.com/development-resources/api-credentials)
|
|
based on the API key you used in the request.
|
|
|
|
|
|
You can make this request with any of the Management API roles.'
|
|
operationId: get-me-allowedOrigins
|
|
x-sortIndex: 0
|
|
x-methodName: getAllowedOrigins
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AllowedOriginsResponse'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
post:
|
|
tags:
|
|
- My API credential
|
|
summary: Add allowed origin
|
|
description: 'Adds an allowed origin to the list of [allowed origins](https://docs.adyen.com/development-resources/client-side-authentication#allowed-origins)
|
|
of your API credential.
|
|
|
|
The API key from the request is used to identify the [API credential](https://docs.adyen.com/development-resources/api-credentials).
|
|
|
|
|
|
You can make this request with any of the Management API roles.'
|
|
operationId: post-me-allowedOrigins
|
|
x-sortIndex: 0
|
|
x-methodName: addAllowedOrigin
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/CreateAllowedOriginRequest'
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AllowedOrigin'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/me/allowedOrigins/{originId}:
|
|
delete:
|
|
tags:
|
|
- My API credential
|
|
summary: Remove allowed origin
|
|
description: 'Removes the [allowed origin](https://docs.adyen.com/development-resources/client-side-authentication#allowed-origins)
|
|
specified in the path.
|
|
|
|
The API key from the request is used to identify the [API credential](https://docs.adyen.com/development-resources/api-credentials).
|
|
|
|
|
|
You can make this request with any of the Management API roles.'
|
|
operationId: delete-me-allowedOrigins-originId
|
|
x-sortIndex: 0
|
|
x-methodName: removeAllowedOrigin
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- 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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
get:
|
|
tags:
|
|
- My API credential
|
|
summary: Get allowed origin details
|
|
description: 'Returns the details of the [allowed origin](https://docs.adyen.com/development-resources/client-side-authentication#allowed-origins)
|
|
specified in the path.
|
|
|
|
The API key from the request is used to identify the [API credential](https://docs.adyen.com/development-resources/api-credentials).
|
|
|
|
|
|
You can make this request with any of the Management API roles.'
|
|
operationId: get-me-allowedOrigins-originId
|
|
x-sortIndex: 0
|
|
x-methodName: getAllowedOriginDetails
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: Unique identifier of the allowed origin.
|
|
name: originId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AllowedOrigin'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/me/generateClientKey:
|
|
post:
|
|
tags:
|
|
- My API credential
|
|
summary: Generate a client key
|
|
description: "Generates a new [client key](https://docs.adyen.com/development-resources/client-side-authentication/)\
|
|
\ used to authenticate requests from your payment environment.\nYou can use\
|
|
\ the new client key a few minutes after generating it.\nThe old client key\
|
|
\ stops working 24 hours after generating a new one.\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\u2014API credentials read and write"
|
|
operationId: post-me-generateClientKey
|
|
x-sortIndex: 0
|
|
x-methodName: generateClientKey
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/GenerateClientKeyResponse'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants:
|
|
get:
|
|
tags:
|
|
- Account - merchant level
|
|
summary: 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\u2014Account 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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
post:
|
|
tags:
|
|
- Account - merchant level
|
|
summary: Create a merchant account
|
|
description: "Creates a merchant account for the company account specified in\
|
|
\ the request.\n\nUse this endpoint if your integration requires it, such\
|
|
\ as Adyen for Platforms Manage. Your Adyen contact will set up your access.\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\u2014Accounts 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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}:
|
|
get:
|
|
tags:
|
|
- Account - merchant level
|
|
summary: Get a merchant account
|
|
description: "Returns the merchant account specified in the path. Your API credential\
|
|
\ must have access to the merchant account.\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\u2014Account 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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/activate:
|
|
post:
|
|
tags:
|
|
- Account - merchant level
|
|
summary: Request to activate a merchant account
|
|
description: "Sends a request to activate the merchant account identified in\
|
|
\ the path.\n\nYou 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.\n\nUse this endpoint if your integration\
|
|
\ requires it, such as Adyen for Platforms Manage. Your Adyen contact will\
|
|
\ set up your access.\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\u2014Accounts 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'
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/apiCredentials:
|
|
get:
|
|
tags:
|
|
- API credentials - merchant level
|
|
summary: 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.\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\u2014API 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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
post:
|
|
tags:
|
|
- API credentials - merchant level
|
|
summary: 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.\n\nThe\
|
|
\ response includes the:\n* [API key](https://docs.adyen.com/development-resources/api-authentication#api-key-authentication):\
|
|
\ used for API request authentication.\n* [Client key](https://docs.adyen.com/development-resources/client-side-authentication#how-it-works):\
|
|
\ public key used for client-side authentication.\n* [Username and password](https://docs.adyen.com/development-resources/api-authentication#using-basic-authentication):\
|
|
\ used for basic authentication.\n\n> Make sure you store the API key securely\
|
|
\ in your system. You won't be able to retrieve it later.\n\nIf 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).\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\u2014API 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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/apiCredentials/{apiCredentialId}:
|
|
get:
|
|
tags:
|
|
- API credentials - merchant level
|
|
summary: Get an API credential
|
|
description: "Returns the [API credential](https://docs.adyen.com/development-resources/api-credentials)\
|
|
\ identified in the path.\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\u2014API 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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
patch:
|
|
tags:
|
|
- API credentials - merchant level
|
|
summary: 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\u2014API 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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/apiCredentials/{apiCredentialId}/allowedOrigins:
|
|
get:
|
|
tags:
|
|
- Allowed origins - merchant level
|
|
summary: 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.\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\u2014API 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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
post:
|
|
tags:
|
|
- Allowed origins - merchant level
|
|
summary: 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.\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\u2014API 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/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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/apiCredentials/{apiCredentialId}/allowedOrigins/{originId}:
|
|
delete:
|
|
tags:
|
|
- Allowed origins - merchant level
|
|
summary: 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.\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\u2014API 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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
get:
|
|
tags:
|
|
- Allowed origins - merchant level
|
|
summary: Get an allowed origin
|
|
description: "Returns the [allowed origin](https://docs.adyen.com/development-resources/client-side-authentication#allowed-origins)\
|
|
\ identified in the path.\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\u2014API 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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/apiCredentials/{apiCredentialId}/generateApiKey:
|
|
post:
|
|
tags:
|
|
- API key - merchant level
|
|
summary: 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.\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\u2014API 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'
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/apiCredentials/{apiCredentialId}/generateClientKey:
|
|
post:
|
|
tags:
|
|
- Client key - merchant level
|
|
summary: 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.\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\u2014API 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'
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/billingEntities:
|
|
get:
|
|
tags:
|
|
- Terminal orders - merchant level
|
|
summary: Get a list of billing entities
|
|
description: "Returns the billing entities of the merchant account identified\
|
|
\ in the path.\nA billing entity is a legal entity where we charge orders\
|
|
\ to. An order for terminal products must contain the ID of a billing entity.\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\u2014Terminal ordering read\n* Management API\u2014Terminal\
|
|
\ ordering read and write\n\nIn the live environment, requests to this endpoint\
|
|
\ are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/paymentMethodSettings:
|
|
get:
|
|
tags:
|
|
- Payment methods - merchant level
|
|
summary: Get all payment methods
|
|
description: "Returns details for all payment methods of the merchant account\
|
|
\ identified in the path.\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\u2014Payment methods read\n"
|
|
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'
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'429':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: ''
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
post:
|
|
tags:
|
|
- Payment methods - merchant level
|
|
summary: Request a payment method
|
|
description: "Sends a request to add a new payment method to the merchant account\
|
|
\ identified in the path.\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\u2014Payment methods read and write\n"
|
|
operationId: post-merchants-merchantId-paymentMethodSettings
|
|
x-sortIndex: 1
|
|
x-methodName: requestPaymentMethod
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
examples:
|
|
add-payment-method:
|
|
$ref: '#/components/examples/post-merchants-merchantId-paymentMethodSettings-add-payment-method'
|
|
add-payment-method-partner-model:
|
|
$ref: '#/components/examples/post-merchants-merchantId-paymentMethodSettings-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:
|
|
add-payment-method:
|
|
$ref: '#/components/examples/post-merchants-merchantId-paymentMethodSettings-add-payment-method-200'
|
|
add-payment-method-partner-model:
|
|
$ref: '#/components/examples/post-merchants-merchantId-paymentMethodSettings-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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'429':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: ''
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/paymentMethodSettings/{paymentMethodId}:
|
|
get:
|
|
tags:
|
|
- Payment methods - merchant level
|
|
summary: Get payment method details
|
|
description: "Returns details for the merchant account and the payment method\
|
|
\ identified in the path.\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\u2014Payment methods read\n"
|
|
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'
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'429':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: ''
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
patch:
|
|
tags:
|
|
- Payment methods - merchant level
|
|
summary: Update a payment method
|
|
description: "Updates payment method details for the merchant account and the\
|
|
\ payment method identified in the path.\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\u2014Payment methods read and write\n"
|
|
operationId: patch-merchants-merchantId-paymentMethodSettings-paymentMethodId
|
|
x-sortIndex: 4
|
|
x-methodName: updatePaymentMethod
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
examples:
|
|
update-payment-method:
|
|
$ref: '#/components/examples/patch-merchants-merchantId-paymentMethodSettings-paymentMethodId-update-payment-method'
|
|
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:
|
|
examples:
|
|
update-payment-method:
|
|
$ref: '#/components/examples/patch-merchants-merchantId-paymentMethodSettings-paymentMethodId-update-payment-method-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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'429':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: ''
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/paymentMethodSettings/{paymentMethodId}/addApplePayDomains:
|
|
post:
|
|
tags:
|
|
- Payment methods - merchant level
|
|
summary: 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).\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\u2014Payment methods read and write\n"
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'429':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: ''
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/paymentMethodSettings/{paymentMethodId}/getApplePayDomains:
|
|
get:
|
|
tags:
|
|
- Payment methods - merchant level
|
|
summary: 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).\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\u2014Payment methods read\n"
|
|
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'
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/payoutSettings:
|
|
get:
|
|
tags:
|
|
- Payout settings - merchant level
|
|
summary: Get a list of payout settings
|
|
description: "Returns the list of payout settings for the merchant account identified\
|
|
\ in the path.\n\nUse this endpoint if your integration requires it, such\
|
|
\ as Adyen for Platforms Manage. Your Adyen contact will set up your access.\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\u2014Payout 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'
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
post:
|
|
tags:
|
|
- Payout settings - merchant level
|
|
summary: 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.\n\nIf you're\
|
|
\ accepting payments in multiple currencies, you may add multiple payout settings\
|
|
\ for the merchant account.\n\nUse this endpoint if your integration requires\
|
|
\ it, such as Adyen for Platforms Manage. Your Adyen contact will set up your\
|
|
\ access.\n\nTo make this request, your API credential must have the following\
|
|
\ [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions):\n\
|
|
\n* Management API\u2014Payout 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'
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/payoutSettings/{payoutSettingsId}:
|
|
delete:
|
|
tags:
|
|
- Payout settings - merchant level
|
|
summary: Delete a payout setting
|
|
description: "Deletes the payout setting identified in the path.\n\nUse this\
|
|
\ endpoint if your integration requires it, such as Adyen for Platforms Manage.\
|
|
\ Your Adyen contact will set up your access.\n\nTo make this request, your\
|
|
\ API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions):\n\
|
|
\n* Management API\u2014Payout 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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
get:
|
|
tags:
|
|
- Payout settings - merchant level
|
|
summary: Get a payout setting
|
|
description: "Returns the payout setting identified in the path.\n\nUse this\
|
|
\ endpoint if your integration requires it, such as Adyen for Platforms Manage.\
|
|
\ Your Adyen contact will set up your access.\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\u2014Payout 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'
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
patch:
|
|
tags:
|
|
- Payout settings - merchant level
|
|
summary: Update a payout setting
|
|
description: "Updates the payout setting identified in the path. You can enable\
|
|
\ or disable the payout setting.\n\nUse this endpoint if your integration\
|
|
\ requires it, such as Adyen for Platforms Manage. Your Adyen contact will\
|
|
\ set up your access.\n\nTo make this request, your API credential must have\
|
|
\ the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions):\n\
|
|
\n* Management API\u2014Payout 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'
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/shippingLocations:
|
|
get:
|
|
tags:
|
|
- Terminal orders - merchant level
|
|
summary: Get a list of shipping locations
|
|
description: "Returns the shipping locations for the merchant account identified\
|
|
\ in the path.\nA shipping location includes the address where orders can\
|
|
\ be delivered, and an ID which you need to specify when ordering terminal\
|
|
\ products.\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\u2014Terminal ordering read\n* Management API\u2014Terminal\
|
|
\ ordering read and write\n\nIn the live environment, requests to this endpoint\
|
|
\ are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
post:
|
|
tags:
|
|
- Terminal orders - merchant level
|
|
summary: 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\u2014Terminal ordering read and write\n\nIn the live environment,\
|
|
\ requests to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/splitConfigurations:
|
|
get:
|
|
tags:
|
|
- Split configuration - merchant level
|
|
summary: 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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
post:
|
|
tags:
|
|
- Split configuration - merchant level
|
|
summary: 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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/splitConfigurations/{splitConfigurationId}:
|
|
delete:
|
|
tags:
|
|
- Split configuration - merchant level
|
|
summary: 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'
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
get:
|
|
tags:
|
|
- Split configuration - merchant level
|
|
summary: 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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
patch:
|
|
tags:
|
|
- Split configuration - merchant level
|
|
summary: 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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
post:
|
|
tags:
|
|
- Split configuration - merchant level
|
|
summary: 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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/splitConfigurations/{splitConfigurationId}/rules/{ruleId}:
|
|
delete:
|
|
tags:
|
|
- Split configuration - merchant level
|
|
summary: 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'
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
patch:
|
|
tags:
|
|
- Split configuration - merchant level
|
|
summary: 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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/splitConfigurations/{splitConfigurationId}/rules/{ruleId}/splitLogic/{splitLogicId}:
|
|
patch:
|
|
tags:
|
|
- Split configuration - merchant level
|
|
summary: 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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/stores:
|
|
get:
|
|
tags:
|
|
- Account - store level
|
|
summary: 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.\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\u2014Stores read\n* Management API\u2014Stores read and write\n\
|
|
\nIn the live environment, requests to this endpoint are subject to [rate\
|
|
\ limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
post:
|
|
tags:
|
|
- Account - store level
|
|
summary: Create a store
|
|
description: "Creates a store for the merchant account identified in the path.\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\u2014Stores read and write\n\nIn the live environment, requests\
|
|
\ to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/stores/{reference}/terminalLogos:
|
|
get:
|
|
tags:
|
|
- Terminal settings - store level
|
|
summary: 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\u2014Terminal settings read\n* Management API\u2014Terminal\
|
|
\ settings read and write\n\nIn the live environment, requests to this endpoint\
|
|
\ are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
patch:
|
|
tags:
|
|
- Terminal settings - store level
|
|
summary: 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\u2014Terminal settings read and write\n\nIn the live environment,\
|
|
\ requests to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/stores/{reference}/terminalSettings:
|
|
get:
|
|
tags:
|
|
- Terminal settings - store level
|
|
summary: 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.\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\u2014Terminal settings read\n* Management API\u2014Terminal\
|
|
\ settings read and write\n\nFor [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:\n* Management API\u2014\
|
|
Terminal settings Advanced read and write\n\nIn the live environment, requests\
|
|
\ to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
patch:
|
|
tags:
|
|
- Terminal settings - store level
|
|
summary: 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.\n\n* 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.\n* 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.\n* Objects that are not included in the request are\
|
|
\ not updated.\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\u2014Terminal settings read and write\n\nFor [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:\n* Management API\u2014\
|
|
Terminal settings Advanced read and write\n\nIn the live environment, requests\
|
|
\ to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/stores/{storeId}:
|
|
get:
|
|
tags:
|
|
- Account - store level
|
|
summary: Get a store
|
|
description: "Returns the details of the store identified in the path.\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\u2014Stores read\n* Management API\u2014Stores read and write\n\
|
|
\nIn the live environment, requests to this endpoint are subject to [rate\
|
|
\ limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
patch:
|
|
tags:
|
|
- Account - store level
|
|
summary: Update a store
|
|
description: "Updates the store identified in the path. You can only update\
|
|
\ some store parameters.\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\u2014Stores read and write\n\nIn the live environment, requests\
|
|
\ to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/terminalLogos:
|
|
get:
|
|
tags:
|
|
- Terminal settings - merchant level
|
|
summary: 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\u2014Terminal settings read\n* Management API\u2014Terminal\
|
|
\ settings read and write\n\nIn the live environment, requests to this endpoint\
|
|
\ are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
patch:
|
|
tags:
|
|
- Terminal settings - merchant level
|
|
summary: 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\u2014Terminal settings read and write\n\nIn the live environment,\
|
|
\ requests to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/terminalModels:
|
|
get:
|
|
tags:
|
|
- Terminal orders - merchant level
|
|
summary: 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.\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\u2014Terminal ordering read\n* Management API\u2014Terminal\
|
|
\ ordering read and write\n\nIn the live environment, requests to this endpoint\
|
|
\ are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/terminalOrders:
|
|
get:
|
|
tags:
|
|
- Terminal orders - merchant level
|
|
summary: Get a list of orders
|
|
description: "Returns a list of terminal products orders for the merchant account\
|
|
\ identified in the path.\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\u2014Terminal ordering read\n* Management API\u2014Terminal\
|
|
\ ordering read and write\n\nIn the live environment, requests to this endpoint\
|
|
\ are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
post:
|
|
tags:
|
|
- Terminal orders - merchant level
|
|
summary: Create an order
|
|
description: "Creates an order for payment terminal products for the merchant\
|
|
\ account identified in the path.\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\u2014Terminal ordering read and write\n>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.\n\nIn the live environment, requests to this endpoint\
|
|
\ are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/terminalOrders/{orderId}:
|
|
get:
|
|
tags:
|
|
- Terminal orders - merchant level
|
|
summary: Get an order
|
|
description: "Returns the details of the terminal products order identified\
|
|
\ in the path.\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\u2014Terminal ordering read\n* Management API\u2014Terminal\
|
|
\ ordering read and write\n\nIn the live environment, requests to this endpoint\
|
|
\ are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
patch:
|
|
tags:
|
|
- Terminal orders - merchant level
|
|
summary: Update an order
|
|
description: "Updates the terminal products order identified in the path.\n\
|
|
Updating 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\u2014Terminal ordering read and write\n\nIn the live environment,\
|
|
\ requests to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/terminalOrders/{orderId}/cancel:
|
|
post:
|
|
tags:
|
|
- Terminal orders - merchant level
|
|
summary: Cancel an order
|
|
description: "Cancels the terminal products order identified in the path.\n\
|
|
Cancelling is only possible while the order has the status **Placed**.\nTo\
|
|
\ 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**.\n\n\
|
|
To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions):\n\
|
|
* Management API\u2014Terminal ordering read and write\n\nIn the live environment,\
|
|
\ requests to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/terminalProducts:
|
|
get:
|
|
tags:
|
|
- Terminal orders - merchant level
|
|
summary: 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.\n\n\
|
|
To 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\u2014Terminal ordering read\n* Management API\u2014Terminal\
|
|
\ ordering read and write\n\nIn the live environment, requests to this endpoint\
|
|
\ are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/terminalSettings:
|
|
get:
|
|
tags:
|
|
- Terminal settings - merchant level
|
|
summary: 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).\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\u2014Terminal settings read\n* Management API\u2014Terminal\
|
|
\ settings read and write\n\nFor [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:\n* Management API\u2014\
|
|
Terminal settings Advanced read and write\n\nIn the live environment, requests\
|
|
\ to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
patch:
|
|
tags:
|
|
- Terminal settings - merchant level
|
|
summary: Update terminal settings
|
|
description: "Updates payment terminal settings for the merchant account identified\
|
|
\ in the path.\nThese settings apply to all terminals under the merchant account,\
|
|
\ unless different values are configured at a lower level (store or individual\
|
|
\ terminal).\n\n* 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.\n* 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.\n* Objects that are not included\
|
|
\ in the request are not updated.\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\u2014Terminal settings read and write\n\n\n\nFor [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:\n* Management API\u2014\
|
|
Terminal settings Advanced read and write\n\nIn the live environment, requests\
|
|
\ to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/users:
|
|
get:
|
|
tags:
|
|
- Users - merchant level
|
|
summary: Get a list of users
|
|
description: "Returns a list of users associated with the `merchantId` specified\
|
|
\ in the path.\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\u2014Users read and write\n"
|
|
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'
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
post:
|
|
tags:
|
|
- Users - merchant level
|
|
summary: Create a new user
|
|
description: "Creates a user for the `merchantId` specified in the path.\n\n\
|
|
To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions):\n\
|
|
* Management API\u2014Users read and write\n"
|
|
operationId: post-merchants-merchantId-users
|
|
x-sortIndex: 0
|
|
x-methodName: createNewUser
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
examples:
|
|
create-email-user:
|
|
$ref: '#/components/examples/post-merchants-merchantId-users-create-email-user'
|
|
create-sso-user:
|
|
$ref: '#/components/examples/post-merchants-merchantId-users-create-sso-user'
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/users/{userId}:
|
|
get:
|
|
tags:
|
|
- Users - merchant level
|
|
summary: Get user details
|
|
description: "Returns user details for the `userId` and the `merchantId` specified\
|
|
\ in the path.\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\u2014Users read and write\n"
|
|
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'
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
patch:
|
|
tags:
|
|
- Users - merchant level
|
|
summary: Update a user
|
|
description: "Updates user details for the `userId` and the `merchantId` specified\
|
|
\ in the path.\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\u2014Users read and write\n"
|
|
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'
|
|
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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/webhooks:
|
|
get:
|
|
tags:
|
|
- Webhooks - merchant level
|
|
summary: List all webhooks
|
|
description: "Lists all webhook configurations for the merchant account.\n\n\
|
|
> This call does not return webhook configurations for the company account\
|
|
\ to which the specified merchant account belongs. You can see these in your\
|
|
\ Customer Area under **Developers** > **Webhooks**.\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\u2014Webhooks read\n* Management API\u2014Webhooks 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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
post:
|
|
tags:
|
|
- Webhooks - merchant level
|
|
summary: 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.\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\u2014Webhooks 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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/webhooks/{webhookId}:
|
|
delete:
|
|
tags:
|
|
- Webhooks - merchant level
|
|
summary: Remove a webhook
|
|
description: "Remove the configuration for the webhook identified in the path.\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\u2014Webhooks 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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
get:
|
|
tags:
|
|
- Webhooks - merchant level
|
|
summary: Get a webhook
|
|
description: "Returns the configuration for the webhook identified in the path.\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\u2014Webhooks read\n* Management API\u2014Webhooks 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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
patch:
|
|
tags:
|
|
- Webhooks - merchant level
|
|
summary: 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.\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\u2014Webhooks 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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/webhooks/{webhookId}/generateHmac:
|
|
post:
|
|
tags:
|
|
- Webhooks - merchant level
|
|
summary: 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).\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\u2014Webhooks 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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/merchants/{merchantId}/webhooks/{webhookId}/test:
|
|
post:
|
|
tags:
|
|
- Webhooks - merchant level
|
|
summary: Test a webhook
|
|
description: "Sends sample notifications to test if the webhook is set up correctly.\n\
|
|
\nWe 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.\n\nThe 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.\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\u2014Webhooks 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'
|
|
post-merchant-webhook-test-custom:
|
|
$ref: '#/components/examples/post-merchants-merchantId-webhooks-webhookId-test-post-merchant-webhook-test-custom'
|
|
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'
|
|
post-merchant-webhook-test-custom:
|
|
$ref: '#/components/examples/post-merchants-merchantId-webhooks-webhookId-test-post-merchant-webhook-test-custom-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'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/stores:
|
|
get:
|
|
tags:
|
|
- Account - store level
|
|
summary: Get a list of stores
|
|
description: "Returns a list of stores. The list is grouped into pages as defined\
|
|
\ by the query parameters.\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\u2014Stores read\n* Management API\u2014Stores read and write\n\
|
|
\nIn the live environment, requests to this endpoint are subject to [rate\
|
|
\ limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: get-stores
|
|
x-sortIndex: 4
|
|
x-methodName: listStores
|
|
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
|
|
- description: The reference of the store.
|
|
name: reference
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: string
|
|
- description: The unique identifier of the merchant account.
|
|
name: merchantId
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: string
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
examples:
|
|
success:
|
|
$ref: '#/components/examples/get-stores-success-200'
|
|
schema:
|
|
$ref: '#/components/schemas/ListStoresResponse'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
post:
|
|
tags:
|
|
- Account - store level
|
|
summary: Create a store
|
|
description: "Creates a store for the merchant account specified in the request.\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\u2014Stores read and write\n\nIn the live environment, requests\
|
|
\ to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: post-stores
|
|
x-sortIndex: 5
|
|
x-methodName: createStore
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
examples:
|
|
post-stores:
|
|
$ref: '#/components/examples/post-stores-post-stores'
|
|
schema:
|
|
$ref: '#/components/schemas/StoreCreationWithMerchantCodeRequest'
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
examples:
|
|
post-stores:
|
|
$ref: '#/components/examples/post-stores-post-stores-200'
|
|
schema:
|
|
$ref: '#/components/schemas/Store'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/stores/{storeId}:
|
|
get:
|
|
tags:
|
|
- Account - store level
|
|
summary: Get a store
|
|
description: "Returns the details of the store identified in the path.\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\u2014Stores read\n* Management API\u2014Stores read and write\n\
|
|
\nIn the live environment, requests to this endpoint are subject to [rate\
|
|
\ limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: get-stores-storeId
|
|
x-sortIndex: 6
|
|
x-methodName: getStoreById
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- 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-stores-storeId-success-200'
|
|
schema:
|
|
$ref: '#/components/schemas/Store'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
patch:
|
|
tags:
|
|
- Account - store level
|
|
summary: Update a store
|
|
description: "Updates the store identified in the path.\nYou can only update\
|
|
\ some store parameters.\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\u2014Stores read and write\n\nIn the live environment, requests\
|
|
\ to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: patch-stores-storeId
|
|
x-sortIndex: 7
|
|
x-methodName: updateStoreById
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
examples:
|
|
patch-stores:
|
|
$ref: '#/components/examples/patch-stores-storeId-patch-stores'
|
|
patch-stores-splitConfiguration:
|
|
$ref: '#/components/examples/patch-stores-storeId-patch-stores-splitConfiguration'
|
|
schema:
|
|
$ref: '#/components/schemas/UpdateStoreRequest'
|
|
parameters:
|
|
- 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-stores-storeId-patch-stores-200'
|
|
schema:
|
|
$ref: '#/components/schemas/Store'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/stores/{storeId}/terminalLogos:
|
|
get:
|
|
tags:
|
|
- Terminal settings - store level
|
|
summary: 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 that 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\u2014Terminal settings read\n* Management API\u2014Terminal\
|
|
\ settings read and write\n\nIn the live environment, requests to this endpoint\
|
|
\ are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: get-stores-storeId-terminalLogos
|
|
x-sortIndex: 2
|
|
x-methodName: getTerminalLogoByStoreId
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the store.
|
|
name: storeId
|
|
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-stores-storeId-terminalLogos-success-200'
|
|
schema:
|
|
$ref: '#/components/schemas/Logo'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
patch:
|
|
tags:
|
|
- Terminal settings - store level
|
|
summary: 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\u2014Terminal settings read and write\n\nIn the live environment,\
|
|
\ requests to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: patch-stores-storeId-terminalLogos
|
|
x-sortIndex: 4
|
|
x-methodName: updateTerminalLogoByStoreId
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
examples:
|
|
remove-logo:
|
|
$ref: '#/components/examples/patch-stores-storeId-terminalLogos-remove-logo'
|
|
upload-logo:
|
|
$ref: '#/components/examples/patch-stores-storeId-terminalLogos-upload-logo'
|
|
schema:
|
|
$ref: '#/components/schemas/Logo'
|
|
parameters:
|
|
- description: The unique identifier of the store.
|
|
name: storeId
|
|
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-stores-storeId-terminalLogos-remove-logo-200'
|
|
upload-logo:
|
|
$ref: '#/components/examples/patch-stores-storeId-terminalLogos-upload-logo-200'
|
|
schema:
|
|
$ref: '#/components/schemas/Logo'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/stores/{storeId}/terminalSettings:
|
|
get:
|
|
tags:
|
|
- Terminal settings - store level
|
|
summary: 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.\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\u2014Terminal settings read\n* Management API\u2014Terminal\
|
|
\ settings read and write\n\nFor [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:\n* Management API\u2014\
|
|
Terminal settings Advanced read and write\n\nIn the live environment, requests\
|
|
\ to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: get-stores-storeId-terminalSettings
|
|
x-sortIndex: 1
|
|
x-methodName: getTerminalSettingsByStoreId
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- 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-stores-storeId-terminalSettings-success-200'
|
|
schema:
|
|
$ref: '#/components/schemas/TerminalSettings'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
patch:
|
|
tags:
|
|
- Terminal settings - store level
|
|
summary: 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.\n\n* 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.\n* 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.\n* Objects that are not included in the request are\
|
|
\ not updated.\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\u2014Terminal settings read and write\n\nFor [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:\n* Management API\u2014\
|
|
Terminal settings Advanced read and write\n\nIn the live environment, requests\
|
|
\ to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: patch-stores-storeId-terminalSettings
|
|
x-sortIndex: 3
|
|
x-methodName: updateTerminalSettingsByStoreId
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
examples:
|
|
add-eap-peap-and-psk-wifi-profiles:
|
|
$ref: '#/components/examples/patch-stores-storeId-terminalSettings-add-eap-peap-and-psk-wifi-profiles'
|
|
add-eap-tls-wifi-profile:
|
|
$ref: '#/components/examples/patch-stores-storeId-terminalSettings-add-eap-tls-wifi-profile'
|
|
schema:
|
|
$ref: '#/components/schemas/TerminalSettings'
|
|
parameters:
|
|
- description: The unique identifier of the store.
|
|
name: storeId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
examples:
|
|
add-eap-peap-and-psk-wifi-profiles:
|
|
$ref: '#/components/examples/patch-stores-storeId-terminalSettings-add-eap-peap-and-psk-wifi-profiles-200'
|
|
add-eap-tls-wifi-profile:
|
|
$ref: '#/components/examples/patch-stores-storeId-terminalSettings-add-eap-tls-wifi-profile-200'
|
|
schema:
|
|
$ref: '#/components/schemas/TerminalSettings'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/terminals:
|
|
get:
|
|
tags:
|
|
- Terminals - terminal level
|
|
summary: Get a list of terminals
|
|
description: "Returns the payment terminals that the API credential has access\
|
|
\ to and that match the query parameters. \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 \u2014 Terminal actions read\n\nIn the live environment,\
|
|
\ requests to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: get-terminals
|
|
x-sortIndex: 1
|
|
x-methodName: listTerminals
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: Returns terminals with an ID that contains the specified string.
|
|
If present, other query parameters are ignored.
|
|
name: searchQuery
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: string
|
|
- description: Returns one or more terminals associated with the one-time passwords
|
|
specified in the request. If this query parameter is used, other query parameters
|
|
are ignored.
|
|
name: otpQuery
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: string
|
|
- description: Returns terminals located in the countries specified by their
|
|
[two-letter country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
|
|
name: countries
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: string
|
|
- description: Returns terminals that belong to the merchant accounts specified
|
|
by their unique merchant account ID.
|
|
name: merchantIds
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: string
|
|
- description: Returns terminals that are assigned to the [stores](https://docs.adyen.com/api-explorer/#/ManagementService/latest/get/stores)
|
|
specified by their unique store ID.
|
|
name: storeIds
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: string
|
|
- description: Returns terminals of the [models](https://docs.adyen.com/api-explorer/#/ManagementService/latest/get/companies/{companyId}/terminalModels)
|
|
specified in the format *brand.model*.
|
|
name: brandModels
|
|
in: query
|
|
required: false
|
|
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 20 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-terminals-success-200'
|
|
schema:
|
|
$ref: '#/components/schemas/ListTerminalsResponse'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/terminals/scheduleActions:
|
|
post:
|
|
tags:
|
|
- Terminal actions - terminal level
|
|
summary: Create a terminal action
|
|
description: "Schedules a [terminal action](https://docs.adyen.com/point-of-sale/automating-terminal-management/terminal-actions-api)\
|
|
\ by specifying the action and the terminals that the action must be applied\
|
|
\ to. \n\nThe following restrictions apply:\n* You can schedule only one action\
|
|
\ at a time. For example, to install a new app version and remove an old app\
|
|
\ version, you have to make two API requests. \n* The maximum number of terminals\
|
|
\ in a request is **100**. For example, to apply an action to 250 terminals,\
|
|
\ you have to divide the terminals over three API requests. \n* If there is\
|
|
\ an error with one or more terminal IDs in the request, the action is scheduled\
|
|
\ for none of the terminals. You need to fix the error and try again. \n\n\
|
|
To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions):\n\
|
|
* Management API\u2014Terminal actions read and write\n\nIn the live environment,\
|
|
\ requests to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: post-terminals-scheduleActions
|
|
x-sortIndex: 1
|
|
x-methodName: createTerminalAction
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
examples:
|
|
install-app:
|
|
$ref: '#/components/examples/post-terminals-scheduleActions-install-app'
|
|
uninstall-cert:
|
|
$ref: '#/components/examples/post-terminals-scheduleActions-uninstall-cert'
|
|
verification-error:
|
|
$ref: '#/components/examples/post-terminals-scheduleActions-verification-error'
|
|
schema:
|
|
$ref: '#/components/schemas/ScheduleTerminalActionsRequest'
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
examples:
|
|
install-app:
|
|
$ref: '#/components/examples/post-terminals-scheduleActions-install-app-200'
|
|
uninstall-cert:
|
|
$ref: '#/components/examples/post-terminals-scheduleActions-uninstall-cert-200'
|
|
schema:
|
|
$ref: '#/components/schemas/ScheduleTerminalActionsResponse'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
examples:
|
|
verification-error:
|
|
$ref: '#/components/examples/post-terminals-scheduleActions-verification-error-422'
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/terminals/{terminalId}/reassign:
|
|
post:
|
|
tags:
|
|
- Terminals - terminal level
|
|
summary: Reassign a terminal
|
|
description: "Reassigns a payment terminal to a company account, merchant account,\
|
|
\ merchant account inventory, or a store.\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\u2014Assign Terminal\n\nIn the live environment, requests\
|
|
\ to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
x-addedInVersion: '3'
|
|
operationId: post-terminals-terminalId-reassign
|
|
x-sortIndex: 2
|
|
x-methodName: reassignTerminal
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
examples:
|
|
post-terminals-terminalId-reassign-merchant:
|
|
$ref: '#/components/examples/post-terminals-terminalId-reassign-post-terminals-terminalId-reassign-merchant'
|
|
post-terminals-terminalId-reassign-store:
|
|
$ref: '#/components/examples/post-terminals-terminalId-reassign-post-terminals-terminalId-reassign-store'
|
|
schema:
|
|
$ref: '#/components/schemas/TerminalReassignmentRequest'
|
|
parameters:
|
|
- description: The unique identifier of the payment terminal.
|
|
name: terminalId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
responses:
|
|
'200':
|
|
description: 'No Content - look at the actual response code for the status
|
|
of the request. '
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/terminals/{terminalId}/terminalLogos:
|
|
get:
|
|
tags:
|
|
- Terminal settings - terminal level
|
|
summary: Get the terminal logo
|
|
description: "Returns the logo that is configured for the payment terminal 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.\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\u2014Terminal settings read\n* Management API\u2014Terminal\
|
|
\ settings read and write\n\nIn the live environment, requests to this endpoint\
|
|
\ are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: get-terminals-terminalId-terminalLogos
|
|
x-sortIndex: 4
|
|
x-methodName: getTerminalLogo
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the payment terminal.
|
|
name: terminalId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
examples:
|
|
success:
|
|
$ref: '#/components/examples/get-terminals-terminalId-terminalLogos-success-200'
|
|
schema:
|
|
$ref: '#/components/schemas/Logo'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
patch:
|
|
tags:
|
|
- Terminal settings - terminal level
|
|
summary: Update the logo
|
|
description: "Updates the logo for the payment terminal identified in the path.\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 (store, merchant account,\
|
|
\ 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\u2014Terminal settings read and write\n\nIn the live environment,\
|
|
\ requests to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: patch-terminals-terminalId-terminalLogos
|
|
x-sortIndex: 6
|
|
x-methodName: updateLogo
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
examples:
|
|
remove-logo:
|
|
$ref: '#/components/examples/patch-terminals-terminalId-terminalLogos-remove-logo'
|
|
upload-logo:
|
|
$ref: '#/components/examples/patch-terminals-terminalId-terminalLogos-upload-logo'
|
|
schema:
|
|
$ref: '#/components/schemas/Logo'
|
|
parameters:
|
|
- description: The unique identifier of the payment terminal.
|
|
name: terminalId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
examples:
|
|
remove-logo:
|
|
$ref: '#/components/examples/patch-terminals-terminalId-terminalLogos-remove-logo-200'
|
|
upload-logo:
|
|
$ref: '#/components/examples/patch-terminals-terminalId-terminalLogos-upload-logo-200'
|
|
schema:
|
|
$ref: '#/components/schemas/Logo'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
/terminals/{terminalId}/terminalSettings:
|
|
get:
|
|
tags:
|
|
- Terminal settings - terminal level
|
|
summary: Get terminal settings
|
|
description: "Returns the settings that are configured for the payment terminal\
|
|
\ identified in the path.\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\u2014Terminal settings read\n* Management API\u2014Terminal\
|
|
\ settings read and write\n\nFor [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:\n* Management API\u2014\
|
|
Terminal settings Advanced read and write\n\nIn the live environment, requests\
|
|
\ to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: get-terminals-terminalId-terminalSettings
|
|
x-sortIndex: 3
|
|
x-methodName: getTerminalSettings
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
parameters:
|
|
- description: The unique identifier of the payment terminal.
|
|
name: terminalId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
examples:
|
|
success:
|
|
$ref: '#/components/examples/get-terminals-terminalId-terminalSettings-success-200'
|
|
schema:
|
|
$ref: '#/components/schemas/TerminalSettings'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
patch:
|
|
tags:
|
|
- Terminal settings - terminal level
|
|
summary: Update terminal settings
|
|
description: "Updates the settings that are configured for the payment terminal\
|
|
\ identified in the path.\n\n* 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.\n* 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.\n* Objects\
|
|
\ that are not included in the request are not updated.\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\u2014Terminal settings read and write\n\nFor [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:\n* Management API\u2014\
|
|
Terminal settings Advanced read and write\n\nIn the live environment, requests\
|
|
\ to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment)."
|
|
operationId: patch-terminals-terminalId-terminalSettings
|
|
x-sortIndex: 5
|
|
x-methodName: updateTerminalSettings
|
|
security:
|
|
- BasicAuth: []
|
|
- ApiKeyAuth: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
examples:
|
|
add-eap-peap-and-psk-wifi-profiles:
|
|
$ref: '#/components/examples/patch-terminals-terminalId-terminalSettings-add-eap-peap-and-psk-wifi-profiles'
|
|
add-eap-tls-wifi-profile:
|
|
$ref: '#/components/examples/patch-terminals-terminalId-terminalSettings-add-eap-tls-wifi-profile'
|
|
schema:
|
|
$ref: '#/components/schemas/TerminalSettings'
|
|
parameters:
|
|
- description: The unique identifier of the payment terminal.
|
|
name: terminalId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/json:
|
|
examples:
|
|
add-eap-peap-and-psk-wifi-profiles:
|
|
$ref: '#/components/examples/patch-terminals-terminalId-terminalSettings-add-eap-peap-and-psk-wifi-profiles-200'
|
|
add-eap-tls-wifi-profile:
|
|
$ref: '#/components/examples/patch-terminals-terminalId-terminalSettings-add-eap-tls-wifi-profile-200'
|
|
schema:
|
|
$ref: '#/components/schemas/TerminalSettings'
|
|
description: OK - the request has succeeded.
|
|
'400':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Bad Request - a problem reading or understanding the request.
|
|
'401':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unauthorized - authentication required.
|
|
'403':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Forbidden - insufficient permissions to process the request.
|
|
'422':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Unprocessable Entity - a request validation error.
|
|
'500':
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RestServiceError'
|
|
description: Internal Server Error - the server could not process the request.
|
|
components:
|
|
schemas:
|
|
AccelInfo:
|
|
additionalProperties: false
|
|
properties:
|
|
processingType:
|
|
description: "The type of transactions processed over this payment method.\n\
|
|
\ Allowed values:\n- **pos** for in-person payments. \n- **billpay** for\
|
|
\ subscription payments, both the initial payment and the later recurring\
|
|
\ payments. These transactions have `recurringProcessingModel` **Subscription**.\
|
|
\ \n- **ecom** for all other card not present transactions. This includes\
|
|
\ non-recurring transactions and transactions with `recurringProcessingModel`\
|
|
\ **CardOnFile** or **UnscheduledCardOnFile**.\n"
|
|
enum:
|
|
- billpay
|
|
- ecom
|
|
- pos
|
|
type: string
|
|
transactionDescription:
|
|
description: 'Information regarding the transaction description.
|
|
|
|
> You cannot configure the transaction description in the test environment.'
|
|
$ref: '#/components/schemas/TransactionDescriptionInfo'
|
|
required:
|
|
- processingType
|
|
type: object
|
|
AdditionalCommission:
|
|
additionalProperties: false
|
|
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
|
|
AdditionalSettings:
|
|
additionalProperties: false
|
|
properties:
|
|
includeEventCodes:
|
|
description: 'Object containing list of event codes for which the notification
|
|
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
|
|
AdditionalSettingsResponse:
|
|
additionalProperties: false
|
|
properties:
|
|
excludeEventCodes:
|
|
description: 'Object containing list of event codes for which the notification
|
|
will not be sent. '
|
|
items:
|
|
type: string
|
|
type: array
|
|
includeEventCodes:
|
|
description: 'Object containing list of event codes for which the notification
|
|
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
|
|
Address:
|
|
additionalProperties: false
|
|
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
|
|
AffirmInfo:
|
|
additionalProperties: false
|
|
properties:
|
|
supportEmail:
|
|
description: Merchant support email
|
|
type: string
|
|
required:
|
|
- supportEmail
|
|
type: object
|
|
AfterpayTouchInfo:
|
|
additionalProperties: false
|
|
properties:
|
|
supportUrl:
|
|
description: Support Url
|
|
type: string
|
|
required:
|
|
- supportUrl
|
|
type: object
|
|
AllowedOrigin:
|
|
additionalProperties: false
|
|
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
|
|
AllowedOriginsResponse:
|
|
additionalProperties: false
|
|
properties:
|
|
data:
|
|
description: List of allowed origins.
|
|
items:
|
|
$ref: '#/components/schemas/AllowedOrigin'
|
|
type: array
|
|
type: object
|
|
AmexInfo:
|
|
additionalProperties: false
|
|
properties:
|
|
midNumber:
|
|
description: "Merchant ID (MID) number. Format: 10 numeric characters.\n\
|
|
\ You must provide this field when you request `gatewayContract` or `paymentDesignatorContract`\
|
|
\ service levels."
|
|
maxLength: 10
|
|
type: string
|
|
reuseMidNumber:
|
|
default: false
|
|
description: "Indicates whether the Amex Merchant ID is reused from a previously\
|
|
\ setup Amex payment method. \nThis is only applicable for `gatewayContract`\
|
|
\ and `paymentDesignatorContract` service levels. \nThe default value\
|
|
\ is **false**."
|
|
type: boolean
|
|
serviceLevel:
|
|
description: 'Specifies the service level (settlement type) of this payment
|
|
method. Possible values:
|
|
|
|
* **noContract**: Adyen holds the contract with American Express.
|
|
|
|
* **gatewayContract**: American Express receives the settlement and handles
|
|
disputes, then pays out to you or your sub-merchant directly.
|
|
|
|
* **paymentDesignatorContract**: Adyen receives the settlement, and handles
|
|
disputes and payouts.'
|
|
enum:
|
|
- noContract
|
|
- gatewayContract
|
|
- paymentDesignatorContract
|
|
type: string
|
|
required:
|
|
- serviceLevel
|
|
type: object
|
|
Amount:
|
|
additionalProperties: false
|
|
properties:
|
|
currency:
|
|
description: The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#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#minor-units).
|
|
format: int64
|
|
type: integer
|
|
required:
|
|
- value
|
|
- currency
|
|
type: object
|
|
AndroidApp:
|
|
additionalProperties: false
|
|
properties:
|
|
description:
|
|
description: The description that was provided when uploading the app. The
|
|
description is not shown on the terminal.
|
|
type: string
|
|
errorCode:
|
|
deprecated: true
|
|
x-deprecatedInVersion: '3'
|
|
x-deprecatedMessage: Use `errors` instead.
|
|
description: The error code of the Android app with the `status` of either
|
|
**error** or **invalid**.
|
|
type: string
|
|
errors:
|
|
x-addedInVersion: '3'
|
|
description: The list of errors of the Android app.
|
|
items:
|
|
$ref: '#/components/schemas/AndroidAppError'
|
|
type: array
|
|
id:
|
|
description: The unique identifier of the app.
|
|
type: string
|
|
label:
|
|
description: The app name that is shown on the terminal.
|
|
type: string
|
|
packageName:
|
|
description: The package name that uniquely identifies the Android app.
|
|
type: string
|
|
status:
|
|
description: "The status of the app. Possible values: \n* `processing`:\
|
|
\ the app is being signed and converted to a format that the terminal\
|
|
\ can handle.\n* `error`: something went wrong. Check that the app matches\
|
|
\ the [requirements](https://docs.adyen.com/point-of-sale/android-terminals/app-requirements).\n\
|
|
* `invalid`: there is something wrong with the APK file of the app.\n\
|
|
* `ready`: the app has been signed and converted.\n* `archived`: the app\
|
|
\ is no longer available."
|
|
enum:
|
|
- archived
|
|
- error
|
|
- invalid
|
|
- processing
|
|
- ready
|
|
type: string
|
|
versionCode:
|
|
description: The version number of the app.
|
|
format: int32
|
|
type: integer
|
|
versionName:
|
|
description: The app version number that is shown on the terminal.
|
|
type: string
|
|
required:
|
|
- id
|
|
- status
|
|
type: object
|
|
AndroidAppError:
|
|
additionalProperties: false
|
|
properties:
|
|
errorCode:
|
|
description: The error code of the Android app with the `status` of either
|
|
**error** or **invalid**.
|
|
type: string
|
|
terminalModels:
|
|
description: The list of payment terminal models to which the returned `errorCode`
|
|
applies.
|
|
items:
|
|
type: string
|
|
type: array
|
|
type: object
|
|
AndroidAppsResponse:
|
|
additionalProperties: false
|
|
properties:
|
|
data:
|
|
description: Apps uploaded for Android payment terminals.
|
|
items:
|
|
$ref: '#/components/schemas/AndroidApp'
|
|
type: array
|
|
type: object
|
|
AndroidCertificate:
|
|
additionalProperties: false
|
|
properties:
|
|
description:
|
|
description: The description that was provided when uploading the certificate.
|
|
type: string
|
|
extension:
|
|
description: The file format of the certificate, as indicated by the file
|
|
extension. For example, **.cert** or **.pem**.
|
|
type: string
|
|
id:
|
|
description: The unique identifier of the certificate.
|
|
type: string
|
|
name:
|
|
description: The file name of the certificate. For example, **mycert**.
|
|
type: string
|
|
notAfter:
|
|
description: The date when the certificate stops to be valid.
|
|
format: date-time
|
|
type: string
|
|
notBefore:
|
|
description: The date when the certificate starts to be valid.
|
|
format: date-time
|
|
type: string
|
|
status:
|
|
description: The status of the certificate.
|
|
type: string
|
|
required:
|
|
- id
|
|
type: object
|
|
AndroidCertificatesResponse:
|
|
additionalProperties: false
|
|
properties:
|
|
data:
|
|
description: Uploaded Android certificates for Android payment terminals.
|
|
items:
|
|
$ref: '#/components/schemas/AndroidCertificate'
|
|
type: array
|
|
type: object
|
|
ApiCredential:
|
|
additionalProperties: false
|
|
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
|
|
ApiCredentialLinks:
|
|
additionalProperties: false
|
|
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
|
|
ApplePayInfo:
|
|
additionalProperties: false
|
|
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
|
|
BcmcInfo:
|
|
additionalProperties: false
|
|
properties:
|
|
enableBcmcMobile:
|
|
description: Indicates if [Bancontact mobile](https://docs.adyen.com/payment-methods/bancontact/bancontact-mobile)
|
|
is enabled.
|
|
type: boolean
|
|
type: object
|
|
BillingEntitiesResponse:
|
|
additionalProperties: false
|
|
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
|
|
BillingEntity:
|
|
additionalProperties: false
|
|
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
|
|
CardholderReceipt:
|
|
additionalProperties: false
|
|
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
|
|
CartesBancairesInfo:
|
|
additionalProperties: false
|
|
properties:
|
|
siret:
|
|
description: 'Cartes Bancaires SIRET. Format: 14 digits.'
|
|
type: string
|
|
transactionDescription:
|
|
description: 'Information regarding the transaction description.
|
|
|
|
> You cannot configure the transaction description in the test environment.'
|
|
$ref: '#/components/schemas/TransactionDescriptionInfo'
|
|
required:
|
|
- siret
|
|
type: object
|
|
ClearpayInfo:
|
|
additionalProperties: false
|
|
properties:
|
|
supportUrl:
|
|
description: Support Url
|
|
type: string
|
|
required:
|
|
- supportUrl
|
|
type: object
|
|
Commission:
|
|
additionalProperties: false
|
|
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
|
|
Company:
|
|
additionalProperties: false
|
|
properties:
|
|
_links:
|
|
description: References to resources connected with this company.
|
|
$ref: '#/components/schemas/CompanyLinks'
|
|
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
|
|
description:
|
|
description: Your description for the company account, maximum 300 characters
|
|
type: string
|
|
id:
|
|
description: The unique identifier of the company account.
|
|
type: string
|
|
name:
|
|
description: The legal or trading name of the company.
|
|
type: string
|
|
reference:
|
|
description: Your reference to the account
|
|
type: string
|
|
status:
|
|
description: 'The status of the company account.
|
|
|
|
|
|
Possible values:
|
|
|
|
|
|
* **Active**: Users can log in. Processing and payout capabilities depend
|
|
on the status of the merchant account.
|
|
|
|
* **Inactive**: Users can log in. Payment processing and payouts are disabled.
|
|
|
|
* **Closed**: The company account is closed and this cannot be reversed.
|
|
Users cannot log in. Payment processing and payouts are disabled.'
|
|
type: string
|
|
type: object
|
|
CompanyApiCredential:
|
|
additionalProperties: false
|
|
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
|
|
associatedMerchantAccounts:
|
|
description: "List of merchant accounts that the API credential has explicit\
|
|
\ access to. \n If the credential has access to a company, this implies\
|
|
\ access to all merchant accounts and no merchants for that company will\
|
|
\ be included."
|
|
items:
|
|
type: string
|
|
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
|
|
CompanyLinks:
|
|
additionalProperties: false
|
|
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
|
|
CompanyUser:
|
|
additionalProperties: false
|
|
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
|
|
associatedMerchantAccounts:
|
|
description: The list of [merchant accounts](https://docs.adyen.com/account/account-structure#merchant-accounts)
|
|
associated with 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
|
|
Configuration:
|
|
additionalProperties: false
|
|
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
|
|
commercial:
|
|
description: Set to **true** to apply surcharges only to commercial/business
|
|
cards.
|
|
type: boolean
|
|
country:
|
|
description: The country/region of the card issuer. If used, the surcharge
|
|
settings only apply to the card issued in that country/region.
|
|
items:
|
|
type: string
|
|
type: array
|
|
currencies:
|
|
description: Currency and percentage or amount of the surcharge.
|
|
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
|
|
Connectivity:
|
|
additionalProperties: false
|
|
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
|
|
terminalIPAddressURL:
|
|
description: The list of local and public URLs to send notifications to
|
|
when using local integrations.
|
|
$ref: '#/components/schemas/EventUrl'
|
|
type: object
|
|
Contact:
|
|
additionalProperties: false
|
|
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
|
|
CreateAllowedOriginRequest:
|
|
additionalProperties: false
|
|
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
|
|
CreateApiCredentialResponse:
|
|
additionalProperties: false
|
|
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
|
|
CreateCompanyApiCredentialRequest:
|
|
additionalProperties: false
|
|
properties:
|
|
allowedOrigins:
|
|
description: 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
|
|
associatedMerchantAccounts:
|
|
description: List of merchant accounts that the API credential has access
|
|
to.
|
|
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.<CompanyName>'
|
|
can be assigned to other API credentials.
|
|
items:
|
|
type: string
|
|
type: array
|
|
type: object
|
|
CreateCompanyApiCredentialResponse:
|
|
additionalProperties: false
|
|
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
|
|
associatedMerchantAccounts:
|
|
description: List of merchant accounts that the API credential has access
|
|
to.
|
|
items:
|
|
type: string
|
|
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
|
|
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
|
|
- associatedMerchantAccounts
|
|
type: object
|
|
CreateCompanyUserRequest:
|
|
additionalProperties: false
|
|
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
|
|
associatedMerchantAccounts:
|
|
description: The list of [merchant accounts](https://docs.adyen.com/account/account-structure#merchant-accounts)
|
|
associated with this user.
|
|
items:
|
|
type: string
|
|
type: array
|
|
email:
|
|
description: The email address of the user.
|
|
type: string
|
|
loginMethod:
|
|
description: 'The requested login method for the user. To use SSO, you must
|
|
already have SSO configured with Adyen before creating the user.
|
|
|
|
|
|
Possible values: **Username & account**, **Email**, or **SSO** '
|
|
type: string
|
|
name:
|
|
description: "The user's full name.\n\nAllowed length: 1\u201480 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
|
|
CreateCompanyUserResponse:
|
|
additionalProperties: false
|
|
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
|
|
associatedMerchantAccounts:
|
|
description: The list of [merchant accounts](https://docs.adyen.com/account/account-structure#merchant-accounts)
|
|
associated with 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
|
|
CreateCompanyWebhookRequest:
|
|
additionalProperties: false
|
|
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
|
|
filterMerchantAccountType:
|
|
description: "Shows how merchant accounts are filtered when configuring\
|
|
\ the webhook. \n\nPossible values:\n* **allAccounts** : Includes all\
|
|
\ merchant accounts, and does not require specifying `filterMerchantAccounts`.\n\
|
|
* **includeAccounts** : The webhook is configured for the merchant accounts\
|
|
\ listed in `filterMerchantAccounts`.\n* **excludeAccounts** : The webhook\
|
|
\ is not configured for the merchant accounts listed in `filterMerchantAccounts`.\n\
|
|
\n"
|
|
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
|
|
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**
|
|
|
|
- **terminal-settings**
|
|
|
|
- **terminal-boarding**
|
|
|
|
|
|
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
|
|
- filterMerchantAccountType
|
|
- filterMerchantAccounts
|
|
type: object
|
|
CreateMerchantApiCredentialRequest:
|
|
additionalProperties: false
|
|
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.<CompanyName>'
|
|
can be assigned to other API credentials.
|
|
items:
|
|
type: string
|
|
type: array
|
|
type: object
|
|
CreateMerchantRequest:
|
|
additionalProperties: false
|
|
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
|
|
CreateMerchantResponse:
|
|
additionalProperties: false
|
|
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
|
|
CreateMerchantUserRequest:
|
|
additionalProperties: false
|
|
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
|
|
loginMethod:
|
|
description: 'The requested login method for the user. To use SSO, you must
|
|
already have SSO configured with Adyen before creating the user.
|
|
|
|
|
|
Possible values: **Username & account**, **Email**, or **SSO** '
|
|
type: string
|
|
name:
|
|
description: "The user's full name.\n\nAllowed length: 1\u201480 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
|
|
CreateMerchantWebhookRequest:
|
|
additionalProperties: false
|
|
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**
|
|
|
|
- **terminal-settings**
|
|
|
|
- **terminal-boarding**
|
|
|
|
|
|
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
|
|
CreateUserResponse:
|
|
additionalProperties: false
|
|
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
|
|
Currency:
|
|
additionalProperties: false
|
|
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
|
|
maxAmount:
|
|
description: The maximum surcharge amount per transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes).
|
|
format: int32
|
|
type: integer
|
|
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
|
|
CustomNotification:
|
|
additionalProperties: false
|
|
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 description 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
|
|
DataCenter:
|
|
additionalProperties: false
|
|
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
|
|
DinersInfo:
|
|
additionalProperties: false
|
|
properties:
|
|
midNumber:
|
|
description: 'MID (Merchant ID) number. Required for merchants operating
|
|
in Japan.
|
|
|
|
Format: 14 numeric characters.'
|
|
maxLength: 14
|
|
type: string
|
|
reuseMidNumber:
|
|
default: false
|
|
description: 'Indicates whether the JCB Merchant ID is reused from a previously
|
|
configured JCB payment method.
|
|
|
|
The default value is **false**.
|
|
|
|
For merchants operating in Japan, this field is required and must be set
|
|
to **true**.'
|
|
type: boolean
|
|
serviceLevel:
|
|
description: "Specifies the service level (settlement type) of this payment\
|
|
\ method. Required for merchants operating in Japan. Possible values:\n\
|
|
\ * **noContract**: Adyen holds the contract with JCB.\n * **gatewayContract**:\
|
|
\ JCB receives the settlement and handles disputes, then pays out to you\
|
|
\ or your sub-merchant directly."
|
|
enum:
|
|
- noContract
|
|
- gatewayContract
|
|
type: string
|
|
transactionDescription:
|
|
description: 'Information regarding the transaction description.
|
|
|
|
> You cannot configure the transaction description in the test environment.'
|
|
$ref: '#/components/schemas/TransactionDescriptionInfo'
|
|
required:
|
|
- reuseMidNumber
|
|
type: object
|
|
EventUrl:
|
|
additionalProperties: false
|
|
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
|
|
ExternalTerminalAction:
|
|
additionalProperties: false
|
|
properties:
|
|
actionType:
|
|
description: 'The type of terminal action: **InstallAndroidApp**, **UninstallAndroidApp**,
|
|
**InstallAndroidCertificate**, or **UninstallAndroidCertificate**.'
|
|
type: string
|
|
config:
|
|
description: Technical information about the terminal action.
|
|
type: string
|
|
confirmedAt:
|
|
description: The date and time when the action was carried out.
|
|
format: date-time
|
|
type: string
|
|
id:
|
|
description: The unique ID of the terminal action.
|
|
type: string
|
|
result:
|
|
description: The result message for the action.
|
|
type: string
|
|
scheduledAt:
|
|
description: The date and time when the action was scheduled to happen.
|
|
format: date-time
|
|
type: string
|
|
status:
|
|
description: 'The status of the terminal action: **pending**, **successful**,
|
|
**failed**, **cancelled**, or **tryLater**.'
|
|
type: string
|
|
terminalId:
|
|
description: The unique ID of the terminal that the action applies to.
|
|
type: string
|
|
type: object
|
|
File:
|
|
additionalProperties: false
|
|
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
|
|
GenerateApiKeyResponse:
|
|
additionalProperties: false
|
|
properties:
|
|
apiKey:
|
|
description: The generated API key.
|
|
type: string
|
|
required:
|
|
- apiKey
|
|
type: object
|
|
GenerateClientKeyResponse:
|
|
additionalProperties: false
|
|
properties:
|
|
clientKey:
|
|
description: Generated client key
|
|
type: string
|
|
required:
|
|
- clientKey
|
|
type: object
|
|
GenerateHmacKeyResponse:
|
|
additionalProperties: false
|
|
properties:
|
|
hmacKey:
|
|
description: The HMAC key generated for this webhook.
|
|
type: string
|
|
required:
|
|
- hmacKey
|
|
type: object
|
|
GenericPmWithTdiInfo:
|
|
additionalProperties: false
|
|
properties:
|
|
transactionDescription:
|
|
description: 'Information regarding the transaction description.
|
|
|
|
> You cannot configure the transaction description in the test environment.'
|
|
$ref: '#/components/schemas/TransactionDescriptionInfo'
|
|
type: object
|
|
GiroPayInfo:
|
|
additionalProperties: false
|
|
properties:
|
|
supportEmail:
|
|
description: The email address of merchant support.
|
|
type: string
|
|
required:
|
|
- supportEmail
|
|
type: object
|
|
GooglePayInfo:
|
|
additionalProperties: false
|
|
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
|
|
Gratuity:
|
|
additionalProperties: false
|
|
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
|
|
Hardware:
|
|
additionalProperties: false
|
|
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
|
|
IdName:
|
|
additionalProperties: false
|
|
properties:
|
|
id:
|
|
description: The identifier of the terminal model.
|
|
type: string
|
|
name:
|
|
description: The name of the terminal model.
|
|
type: string
|
|
type: object
|
|
InstallAndroidAppDetails:
|
|
additionalProperties: false
|
|
properties:
|
|
appId:
|
|
description: The unique identifier of the app to be installed.
|
|
type: string
|
|
type:
|
|
default: InstallAndroidApp
|
|
description: 'Type of terminal action: Install an Android app.'
|
|
enum:
|
|
- InstallAndroidApp
|
|
type: string
|
|
type: object
|
|
InstallAndroidCertificateDetails:
|
|
additionalProperties: false
|
|
properties:
|
|
certificateId:
|
|
description: The unique identifier of the certificate to be installed.
|
|
type: string
|
|
type:
|
|
default: InstallAndroidCertificate
|
|
description: 'Type of terminal action: Install an Android certificate.'
|
|
enum:
|
|
- InstallAndroidCertificate
|
|
type: string
|
|
type: object
|
|
InvalidField:
|
|
additionalProperties: false
|
|
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
|
|
JCBInfo:
|
|
additionalProperties: false
|
|
properties:
|
|
midNumber:
|
|
description: 'MID (Merchant ID) number. Required for merchants operating
|
|
in Japan.Format: 14 numeric characters.'
|
|
maxLength: 14
|
|
type: string
|
|
reuseMidNumber:
|
|
default: false
|
|
description: "Indicates whether the JCB Merchant ID is reused from a previously\
|
|
\ setup JCB payment method. \nThe default value is **false**.For merchants\
|
|
\ operating in Japan, this field is required and must be set to **true**."
|
|
type: boolean
|
|
serviceLevel:
|
|
description: 'Specifies the service level (settlement type) of this payment
|
|
method. Required for merchants operating in Japan.
|
|
|
|
Possible values:
|
|
|
|
* **noContract**: Adyen holds the contract with JCB.
|
|
|
|
* **gatewayContract**: JCB receives the settlement and handles disputes,
|
|
then pays out to you or your sub-merchant directly.'
|
|
enum:
|
|
- noContract
|
|
- gatewayContract
|
|
type: string
|
|
transactionDescription:
|
|
description: 'Information regarding the transaction description.
|
|
|
|
> You cannot configure the transaction description in the test environment.'
|
|
$ref: '#/components/schemas/TransactionDescriptionInfo'
|
|
type: object
|
|
JSONObject:
|
|
type: object
|
|
Key:
|
|
additionalProperties: false
|
|
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
|
|
KlarnaInfo:
|
|
additionalProperties: false
|
|
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
|
|
Links:
|
|
additionalProperties: false
|
|
properties:
|
|
self:
|
|
description: Link to the resource itself.
|
|
$ref: '#/components/schemas/LinksElement'
|
|
required:
|
|
- self
|
|
type: object
|
|
LinksElement:
|
|
additionalProperties: false
|
|
properties:
|
|
href:
|
|
type: string
|
|
type: object
|
|
ListCompanyApiCredentialsResponse:
|
|
additionalProperties: false
|
|
properties:
|
|
_links:
|
|
description: Pagination references.
|
|
$ref: '#/components/schemas/PaginationLinks'
|
|
data:
|
|
description: The list of API credentials.
|
|
items:
|
|
$ref: '#/components/schemas/CompanyApiCredential'
|
|
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
|
|
ListCompanyResponse:
|
|
additionalProperties: false
|
|
properties:
|
|
_links:
|
|
description: Pagination references.
|
|
$ref: '#/components/schemas/PaginationLinks'
|
|
data:
|
|
description: The list of companies.
|
|
items:
|
|
$ref: '#/components/schemas/Company'
|
|
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
|
|
ListCompanyUsersResponse:
|
|
additionalProperties: false
|
|
properties:
|
|
_links:
|
|
description: Pagination references.
|
|
$ref: '#/components/schemas/PaginationLinks'
|
|
data:
|
|
description: The list of users.
|
|
items:
|
|
$ref: '#/components/schemas/CompanyUser'
|
|
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
|
|
ListExternalTerminalActionsResponse:
|
|
additionalProperties: false
|
|
properties:
|
|
data:
|
|
description: The list of terminal actions.
|
|
items:
|
|
$ref: '#/components/schemas/ExternalTerminalAction'
|
|
type: array
|
|
type: object
|
|
ListMerchantApiCredentialsResponse:
|
|
additionalProperties: false
|
|
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
|
|
ListMerchantResponse:
|
|
additionalProperties: false
|
|
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
|
|
ListMerchantUsersResponse:
|
|
additionalProperties: false
|
|
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
|
|
ListStoresResponse:
|
|
additionalProperties: false
|
|
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
|
|
ListTerminalsResponse:
|
|
additionalProperties: false
|
|
properties:
|
|
_links:
|
|
description: Pagination references.
|
|
$ref: '#/components/schemas/PaginationLinks'
|
|
data:
|
|
description: The list of terminals and their details.
|
|
items:
|
|
$ref: '#/components/schemas/Terminal'
|
|
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
|
|
ListWebhooksResponse:
|
|
additionalProperties: false
|
|
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
|
|
Localization:
|
|
additionalProperties: false
|
|
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
|
|
Logo:
|
|
additionalProperties: false
|
|
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
|
|
MeApiCredential:
|
|
additionalProperties: false
|
|
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
|
|
associatedMerchantAccounts:
|
|
description: "List of merchant accounts that the API credential has explicit\
|
|
\ access to. \n If the credential has access to a company, this implies\
|
|
\ access to all merchant accounts and no merchants for that company will\
|
|
\ be included."
|
|
items:
|
|
type: string
|
|
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
|
|
companyName:
|
|
description: Name of the company linked to the API credential.
|
|
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
|
|
MealVoucherFRInfo:
|
|
additionalProperties: false
|
|
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
|
|
Merchant:
|
|
additionalProperties: false
|
|
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
|
|
MerchantLinks:
|
|
additionalProperties: false
|
|
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
|
|
MinorUnitsMonetaryValue:
|
|
additionalProperties: false
|
|
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
|
|
Name:
|
|
additionalProperties: false
|
|
properties:
|
|
firstName:
|
|
description: The first name.
|
|
maxLength: 80
|
|
type: string
|
|
lastName:
|
|
description: The last name.
|
|
maxLength: 80
|
|
type: string
|
|
required:
|
|
- firstName
|
|
- lastName
|
|
type: object
|
|
Name2:
|
|
additionalProperties: false
|
|
properties:
|
|
firstName:
|
|
description: The first name.
|
|
maxLength: 80
|
|
type: string
|
|
lastName:
|
|
description: The last name.
|
|
maxLength: 80
|
|
type: string
|
|
type: object
|
|
Nexo:
|
|
additionalProperties: false
|
|
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
|
|
Notification:
|
|
additionalProperties: false
|
|
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
|
|
NotificationUrl:
|
|
additionalProperties: false
|
|
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
|
|
NyceInfo:
|
|
additionalProperties: false
|
|
properties:
|
|
processingType:
|
|
description: "The type of transactions processed over this payment method.\n\
|
|
\ Allowed values:\n- **pos** for in-person payments. \n- **billpay** for\
|
|
\ subscription payments, both the initial payment and the later recurring\
|
|
\ payments. These transactions have `recurringProcessingModel` **Subscription**.\
|
|
\ \n- **ecom** for all other card not present transactions. This includes\
|
|
\ non-recurring transactions and transactions with `recurringProcessingModel`\
|
|
\ **CardOnFile** or **UnscheduledCardOnFile**.\n"
|
|
enum:
|
|
- billpay
|
|
- ecom
|
|
- pos
|
|
type: string
|
|
transactionDescription:
|
|
description: 'Information regarding the transaction description.
|
|
|
|
> You cannot configure the transaction description in the test environment.'
|
|
$ref: '#/components/schemas/TransactionDescriptionInfo'
|
|
required:
|
|
- processingType
|
|
type: object
|
|
OfflineProcessing:
|
|
additionalProperties: false
|
|
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
|
|
Opi:
|
|
additionalProperties: false
|
|
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
|
|
OrderItem:
|
|
additionalProperties: false
|
|
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
|
|
PaginationLinks:
|
|
additionalProperties: false
|
|
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
|
|
Passcodes:
|
|
additionalProperties: false
|
|
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
|
|
PayAtTable:
|
|
additionalProperties: false
|
|
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
|
|
nullable: true
|
|
type: string
|
|
type: object
|
|
PayMeInfo:
|
|
additionalProperties: false
|
|
properties:
|
|
displayName:
|
|
description: Merchant display name
|
|
type: string
|
|
logo:
|
|
description: 'Merchant logo. Format: Base64-encoded string.'
|
|
type: string
|
|
supportEmail:
|
|
description: The email address of merchant support.
|
|
type: string
|
|
required:
|
|
- displayName
|
|
- supportEmail
|
|
- logo
|
|
type: object
|
|
PayPalInfo:
|
|
additionalProperties: false
|
|
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
|
|
PayToInfo:
|
|
additionalProperties: false
|
|
properties:
|
|
merchantName:
|
|
description: Merchant name displayed to the shopper in the Agreements
|
|
type: string
|
|
payToPurpose:
|
|
description: 'Represents the purpose of the Agreements created, it relates
|
|
to the business type
|
|
|
|
**Allowed values**: mortgage, utility, loan, gambling, retail, salary,
|
|
personal, government, pension, tax, other'
|
|
type: string
|
|
required:
|
|
- merchantName
|
|
- payToPurpose
|
|
type: object
|
|
Payment:
|
|
additionalProperties: false
|
|
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
|
|
PaymentMethod:
|
|
additionalProperties: false
|
|
properties:
|
|
accel:
|
|
description: ACCEL details.
|
|
$ref: '#/components/schemas/AccelInfo'
|
|
affirm:
|
|
description: Affirm details.
|
|
$ref: '#/components/schemas/AffirmInfo'
|
|
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
|
|
amex:
|
|
description: Amex details.
|
|
$ref: '#/components/schemas/AmexInfo'
|
|
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
|
|
are a [platform model](https://docs.adyen.com/platforms).
|
|
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. For merchants operating in Japan, Diners payments
|
|
are processed through the JCB network. This means that you must include
|
|
[JCB-specific fields](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/(merchantId)/paymentMethodSettings/(paymentMethodId)#request-jcb)
|
|
in this object.
|
|
$ref: '#/components/schemas/DinersInfo'
|
|
discover:
|
|
description: Discover details. For merchants operating in Japan, request
|
|
[Diners](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/(merchantId)/paymentMethodSettings/(paymentMethodId)#request-diners)
|
|
payment method instead. Discover is automatically requested, together
|
|
with Diners.
|
|
$ref: '#/components/schemas/GenericPmWithTdiInfo'
|
|
eft_directdebit_CA:
|
|
description: EFT Direct Debit Canada 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.
|
|
|
|
For merchants operating in Japan, `midNumber`, `reuseMidNumber`, and `serviceLevel`
|
|
fields are required.
|
|
|
|
For merchants operating outside of Japan, these fields are not required.'
|
|
$ref: '#/components/schemas/JCBInfo'
|
|
klarna:
|
|
description: Klarna details.
|
|
$ref: '#/components/schemas/KlarnaInfo'
|
|
maestro:
|
|
description: 'Maestro details. In the US, `maestro` is not supported; use
|
|
`maestro_usa` instead. '
|
|
$ref: '#/components/schemas/GenericPmWithTdiInfo'
|
|
mc:
|
|
description: MasterCard details.
|
|
$ref: '#/components/schemas/GenericPmWithTdiInfo'
|
|
mealVoucher_FR:
|
|
description: Meal Voucher FR details.
|
|
$ref: '#/components/schemas/MealVoucherFRInfo'
|
|
nyce:
|
|
description: NYCE details.
|
|
$ref: '#/components/schemas/NyceInfo'
|
|
payme:
|
|
description: PayMe details.
|
|
$ref: '#/components/schemas/PayMeInfo'
|
|
paypal:
|
|
description: PayPal details.
|
|
$ref: '#/components/schemas/PayPalInfo'
|
|
payto:
|
|
description: PayTo details.
|
|
$ref: '#/components/schemas/PayToInfo'
|
|
pulse:
|
|
description: PULSE details.
|
|
$ref: '#/components/schemas/PulseInfo'
|
|
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
|
|
sodexo:
|
|
description: Sodexo details.
|
|
$ref: '#/components/schemas/SodexoInfo'
|
|
sofort:
|
|
description: Sofort details.
|
|
$ref: '#/components/schemas/SofortInfo'
|
|
star:
|
|
description: STAR details.
|
|
$ref: '#/components/schemas/StarInfo'
|
|
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.\n - This field is required only if you have\
|
|
\ a contract with Swish. Swish handles settlement directly with you (not\
|
|
\ through Adyen).\n - If not specified then it's assumed that you are\
|
|
\ using Adyen's contract with Swish.You don't have a direct relationship\
|
|
\ with Swish.\n"
|
|
$ref: '#/components/schemas/SwishInfo'
|
|
ticket:
|
|
description: Edenred details.
|
|
$ref: '#/components/schemas/TicketInfo'
|
|
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'
|
|
wechatpay:
|
|
description: WeChat Pay details.
|
|
$ref: '#/components/schemas/WeChatPayInfo'
|
|
wechatpay_pos:
|
|
description: WeChat Pay POS details.
|
|
$ref: '#/components/schemas/WeChatPayPosInfo'
|
|
required:
|
|
- id
|
|
type: object
|
|
PaymentMethodResponse:
|
|
additionalProperties: false
|
|
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:
|
|
- accel
|
|
- ach
|
|
- affirm
|
|
- afterpaytouch
|
|
- alelo
|
|
- alipay
|
|
- alipay_hk
|
|
- alipay_wap
|
|
- amex
|
|
- applepay
|
|
- banese_card
|
|
- banese_card_credit
|
|
- banese_card_debit
|
|
- banese_card_prepaid
|
|
- bcmc
|
|
- blik
|
|
- cartebancaire
|
|
- clearpay
|
|
- clicktopay
|
|
- credtodos
|
|
- credtodos_private_credit
|
|
- credtodos_private_debit
|
|
- cup
|
|
- diners
|
|
- directdebit_GB
|
|
- discover
|
|
- ebanking_FI
|
|
- eft_directdebit_CA
|
|
- 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
|
|
- nyce
|
|
- onlineBanking_PL
|
|
- paybybank
|
|
- payme
|
|
- payme_pos
|
|
- paynow
|
|
- paynow_pos
|
|
- paypal
|
|
- payshop
|
|
- payto
|
|
- pulse
|
|
- sodexo
|
|
- star
|
|
- swish
|
|
- ticket
|
|
- todo_giftcard
|
|
- trustly
|
|
- twint
|
|
- twint_pos
|
|
- up_brazil_credit
|
|
- vale_refeicao
|
|
- vale_refeicao_prepaid
|
|
- vipps
|
|
- visa
|
|
- visadebit
|
|
- vpay
|
|
- wechatpay
|
|
- wechatpay_pos
|
|
type: string
|
|
type: array
|
|
required:
|
|
- itemsTotal
|
|
- pagesTotal
|
|
type: object
|
|
PaymentMethodSetupInfo:
|
|
additionalProperties: false
|
|
properties:
|
|
accel:
|
|
description: ACCEL details.
|
|
$ref: '#/components/schemas/AccelInfo'
|
|
affirm:
|
|
description: Affirm details.
|
|
$ref: '#/components/schemas/AffirmInfo'
|
|
afterpayTouch:
|
|
description: Afterpay Touch details.
|
|
$ref: '#/components/schemas/AfterpayTouchInfo'
|
|
amex:
|
|
description: Amex details.
|
|
$ref: '#/components/schemas/AmexInfo'
|
|
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
|
|
are a [platform model](https://docs.adyen.com/platforms).
|
|
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. For merchants operating in Japan, Diners payments
|
|
are processed through the JCB network. This means that you must include
|
|
[JCB-specific fields](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/(merchantId)/paymentMethodSettings/(paymentMethodId)#request-jcb)
|
|
in this object.
|
|
$ref: '#/components/schemas/DinersInfo'
|
|
discover:
|
|
description: Discover details. For merchants operating in Japan, request
|
|
[Diners](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/(merchantId)/paymentMethodSettings/(paymentMethodId)#request-diners)
|
|
payment method instead. Discover is automatically requested, together
|
|
with Diners.
|
|
$ref: '#/components/schemas/GenericPmWithTdiInfo'
|
|
eft_directdebit_CA:
|
|
description: EFT Direct Debit Canada 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.
|
|
|
|
For merchants operating in Japan, `midNumber`, `reuseMidNumber`, and `serviceLevel`
|
|
fields are required.
|
|
|
|
For merchants operating outside of Japan, these fields are not required.'
|
|
$ref: '#/components/schemas/JCBInfo'
|
|
klarna:
|
|
description: Klarna details.
|
|
$ref: '#/components/schemas/KlarnaInfo'
|
|
maestro:
|
|
description: 'Maestro details. In the US, `maestro` is not supported; use
|
|
`maestro_usa` instead. '
|
|
$ref: '#/components/schemas/GenericPmWithTdiInfo'
|
|
mc:
|
|
description: MasterCard details.
|
|
$ref: '#/components/schemas/GenericPmWithTdiInfo'
|
|
mealVoucher_FR:
|
|
description: Meal Voucher FR details.
|
|
$ref: '#/components/schemas/MealVoucherFRInfo'
|
|
nyce:
|
|
description: NYCE details.
|
|
$ref: '#/components/schemas/NyceInfo'
|
|
payme:
|
|
description: PayMe details.
|
|
$ref: '#/components/schemas/PayMeInfo'
|
|
paypal:
|
|
description: PayPal details.
|
|
$ref: '#/components/schemas/PayPalInfo'
|
|
payto:
|
|
description: PayTo details.
|
|
$ref: '#/components/schemas/PayToInfo'
|
|
pulse:
|
|
description: PULSE details.
|
|
$ref: '#/components/schemas/PulseInfo'
|
|
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
|
|
sodexo:
|
|
description: Sodexo details.
|
|
$ref: '#/components/schemas/SodexoInfo'
|
|
sofort:
|
|
description: Sofort details.
|
|
$ref: '#/components/schemas/SofortInfo'
|
|
star:
|
|
description: STAR details.
|
|
$ref: '#/components/schemas/StarInfo'
|
|
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.\n - This field is required only if you have\
|
|
\ a contract with Swish. Swish handles settlement directly with you (not\
|
|
\ through Adyen).\n - If not specified then it's assumed that you are\
|
|
\ using Adyen's contract with Swish.You don't have a direct relationship\
|
|
\ with Swish.\n"
|
|
$ref: '#/components/schemas/SwishInfo'
|
|
ticket:
|
|
description: Edenred details.
|
|
$ref: '#/components/schemas/TicketInfo'
|
|
twint:
|
|
description: Twint details.
|
|
$ref: '#/components/schemas/TwintInfo'
|
|
type:
|
|
description: Payment method [variant](https://docs.adyen.com/development-resources/paymentmethodvariant#management-api).
|
|
enum:
|
|
- accel
|
|
- ach
|
|
- affirm
|
|
- afterpaytouch
|
|
- alelo
|
|
- alipay
|
|
- alipay_hk
|
|
- alipay_wap
|
|
- amex
|
|
- applepay
|
|
- banese_card
|
|
- banese_card_credit
|
|
- banese_card_debit
|
|
- banese_card_prepaid
|
|
- bcmc
|
|
- blik
|
|
- cartebancaire
|
|
- clearpay
|
|
- clicktopay
|
|
- credtodos
|
|
- credtodos_private_credit
|
|
- credtodos_private_debit
|
|
- cup
|
|
- diners
|
|
- directdebit_GB
|
|
- discover
|
|
- ebanking_FI
|
|
- eft_directdebit_CA
|
|
- 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
|
|
- nyce
|
|
- onlineBanking_PL
|
|
- paybybank
|
|
- payme
|
|
- payme_pos
|
|
- paynow
|
|
- paynow_pos
|
|
- paypal
|
|
- payshop
|
|
- payto
|
|
- pulse
|
|
- sodexo
|
|
- star
|
|
- swish
|
|
- ticket
|
|
- todo_giftcard
|
|
- trustly
|
|
- twint
|
|
- twint_pos
|
|
- up_brazil_credit
|
|
- vale_refeicao
|
|
- vale_refeicao_prepaid
|
|
- 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'
|
|
wechatpay:
|
|
description: WeChat Pay details.
|
|
$ref: '#/components/schemas/WeChatPayInfo'
|
|
wechatpay_pos:
|
|
description: WeChat Pay POS details.
|
|
$ref: '#/components/schemas/WeChatPayPosInfo'
|
|
required:
|
|
- type
|
|
type: object
|
|
PayoutSettings:
|
|
additionalProperties: false
|
|
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
|
|
PayoutSettingsRequest:
|
|
additionalProperties: false
|
|
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
|
|
PayoutSettingsResponse:
|
|
additionalProperties: false
|
|
properties:
|
|
data:
|
|
description: The list of payout accounts.
|
|
items:
|
|
$ref: '#/components/schemas/PayoutSettings'
|
|
type: array
|
|
type: object
|
|
Profile:
|
|
additionalProperties: false
|
|
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
|
|
PulseInfo:
|
|
additionalProperties: false
|
|
properties:
|
|
processingType:
|
|
description: "The type of transactions processed over this payment method.\n\
|
|
\ Allowed values:\n- **pos** for in-person payments. \n- **billpay** for\
|
|
\ subscription payments, both the initial payment and the later recurring\
|
|
\ payments. These transactions have `recurringProcessingModel` **Subscription**.\
|
|
\ \n- **ecom** for all other card not present transactions. This includes\
|
|
\ non-recurring transactions and transactions with `recurringProcessingModel`\
|
|
\ **CardOnFile** or **UnscheduledCardOnFile**.\n"
|
|
enum:
|
|
- billpay
|
|
- ecom
|
|
- pos
|
|
type: string
|
|
transactionDescription:
|
|
description: 'Information regarding the transaction description.
|
|
|
|
> You cannot configure the transaction description in the test environment.'
|
|
$ref: '#/components/schemas/TransactionDescriptionInfo'
|
|
required:
|
|
- processingType
|
|
type: object
|
|
ReceiptOptions:
|
|
additionalProperties: false
|
|
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
|
|
ReceiptPrinting:
|
|
additionalProperties: false
|
|
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
|
|
Referenced:
|
|
additionalProperties: false
|
|
properties:
|
|
enableStandaloneRefunds:
|
|
description: Indicates whether referenced refunds are enabled on the standalone
|
|
terminal.
|
|
type: boolean
|
|
type: object
|
|
Refunds:
|
|
additionalProperties: false
|
|
properties:
|
|
referenced:
|
|
description: Settings for referenced refunds.
|
|
$ref: '#/components/schemas/Referenced'
|
|
type: object
|
|
ReleaseUpdateDetails:
|
|
additionalProperties: false
|
|
properties:
|
|
type:
|
|
default: ReleaseUpdate
|
|
description: 'Type of terminal action: Update Release.'
|
|
enum:
|
|
- ReleaseUpdate
|
|
type: string
|
|
updateAtFirstMaintenanceCall:
|
|
description: Boolean flag that tells if the terminal should update at the
|
|
first next maintenance call. If false, terminal will update on its configured
|
|
reboot time.
|
|
type: boolean
|
|
type: object
|
|
ReprocessAndroidAppResponse:
|
|
additionalProperties: false
|
|
properties:
|
|
Message:
|
|
description: The result of the reprocess.
|
|
type: string
|
|
type: object
|
|
RequestActivationResponse:
|
|
additionalProperties: false
|
|
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
|
|
RestServiceError:
|
|
additionalProperties: false
|
|
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
|
|
ScheduleTerminalActionsRequest:
|
|
additionalProperties: false
|
|
properties:
|
|
actionDetails:
|
|
description: Information about the action to take.
|
|
oneOf:
|
|
- $ref: '#/components/schemas/InstallAndroidAppDetails'
|
|
- $ref: '#/components/schemas/InstallAndroidCertificateDetails'
|
|
- $ref: '#/components/schemas/ReleaseUpdateDetails'
|
|
- $ref: '#/components/schemas/UninstallAndroidAppDetails'
|
|
- $ref: '#/components/schemas/UninstallAndroidCertificateDetails'
|
|
scheduledAt:
|
|
description: "The date and time when the action should happen. \nFormat:\
|
|
\ [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339), but without the\
|
|
\ **Z** before the time offset. For example, **2021-11-15T12:16:21+0100**\
|
|
\ \nThe action is sent with the first [maintenance call](https://docs.adyen.com/point-of-sale/automating-terminal-management/terminal-actions-api#when-actions-take-effect)\
|
|
\ after the specified date and time in the time zone of the terminal.\
|
|
\ \nAn empty value causes the action to be sent as soon as possible: at\
|
|
\ the next maintenance call."
|
|
type: string
|
|
storeId:
|
|
description: The unique ID of the [store](https://docs.adyen.com/api-explorer/#/ManagementService/latest/get/stores).
|
|
If present, all terminals in the `terminalIds` list must be assigned to
|
|
this store.
|
|
type: string
|
|
terminalIds:
|
|
description: 'A list of unique IDs of the terminals to apply the action
|
|
to. You can extract the IDs from the [GET `/terminals`](https://docs.adyen.com/api-explorer/#/ManagementService/latest/get/terminals)
|
|
response. Maximum length: 100 IDs.'
|
|
items:
|
|
type: string
|
|
type: array
|
|
type: object
|
|
ScheduleTerminalActionsResponse:
|
|
additionalProperties: false
|
|
properties:
|
|
actionDetails:
|
|
description: Information about the action to take.
|
|
oneOf:
|
|
- $ref: '#/components/schemas/InstallAndroidAppDetails'
|
|
- $ref: '#/components/schemas/InstallAndroidCertificateDetails'
|
|
- $ref: '#/components/schemas/ReleaseUpdateDetails'
|
|
- $ref: '#/components/schemas/UninstallAndroidAppDetails'
|
|
- $ref: '#/components/schemas/UninstallAndroidCertificateDetails'
|
|
items:
|
|
x-addedInVersion: '1'
|
|
description: A list containing a terminal ID and an action ID for each terminal
|
|
that the action was scheduled for.
|
|
items:
|
|
$ref: '#/components/schemas/TerminalActionScheduleDetail'
|
|
type: array
|
|
scheduledAt:
|
|
description: "The date and time when the action should happen. \nFormat:\
|
|
\ [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339), but without the\
|
|
\ **Z** before the time offset. For example, **2021-11-15T12:16:21+0100**\
|
|
\ \nThe action is sent with the first [maintenance call](https://docs.adyen.com/point-of-sale/automating-terminal-management/terminal-actions-api#when-actions-take-effect)\
|
|
\ after the specified date and time in the time zone of the terminal.\
|
|
\ \nAn empty value causes the action to be sent as soon as possible: at\
|
|
\ the next maintenance call."
|
|
type: string
|
|
storeId:
|
|
description: The unique ID of the [store](https://docs.adyen.com/api-explorer/#/ManagementService/latest/get/stores).
|
|
If present, all terminals in the `terminalIds` list must be assigned to
|
|
this store.
|
|
type: string
|
|
terminalsWithErrors:
|
|
additionalProperties:
|
|
items:
|
|
type: string
|
|
type: array
|
|
description: The validation errors that occurred in the list of terminals,
|
|
and for each error the IDs of the terminals that the error applies to.
|
|
type: object
|
|
totalErrors:
|
|
description: The number of terminals for which scheduling the action failed.
|
|
format: int32
|
|
type: integer
|
|
totalScheduled:
|
|
description: The number of terminals for which the action was successfully
|
|
scheduled. This doesn't mean the action has happened yet.
|
|
format: int32
|
|
type: integer
|
|
type: object
|
|
Settings:
|
|
additionalProperties: false
|
|
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
|
|
ShippingLocation:
|
|
additionalProperties: false
|
|
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
|
|
ShippingLocationsResponse:
|
|
additionalProperties: false
|
|
properties:
|
|
data:
|
|
description: Physical locations where orders can be shipped to.
|
|
items:
|
|
$ref: '#/components/schemas/ShippingLocation'
|
|
type: array
|
|
type: object
|
|
Signature:
|
|
additionalProperties: false
|
|
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
|
|
SodexoInfo:
|
|
additionalProperties: false
|
|
properties:
|
|
merchantContactPhone:
|
|
description: Sodexo merchantContactPhone
|
|
type: string
|
|
required:
|
|
- merchantContactPhone
|
|
type: object
|
|
SofortInfo:
|
|
additionalProperties: false
|
|
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
|
|
SplitConfiguration:
|
|
additionalProperties: false
|
|
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
|
|
required:
|
|
- description
|
|
- rules
|
|
type: object
|
|
SplitConfigurationList:
|
|
additionalProperties: false
|
|
properties:
|
|
data:
|
|
description: List of split configurations applied to the stores under the
|
|
merchant account.
|
|
items:
|
|
$ref: '#/components/schemas/SplitConfiguration'
|
|
type: array
|
|
type: object
|
|
SplitConfigurationLogic:
|
|
additionalProperties: false
|
|
properties:
|
|
acquiringFees:
|
|
description: 'Deducts the acquiring fees (the aggregated amount of interchange
|
|
and scheme fee) from the specified balance account.
|
|
|
|
|
|
Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.'
|
|
enum:
|
|
- deductFromLiableAccount
|
|
- deductFromOneBalanceAccount
|
|
type: string
|
|
additionalCommission:
|
|
description: Defines whether to book an additional commission for payments
|
|
to your user's balance account. The commission amount can be defined as
|
|
a fixed amount (specified in minor units), a percentage (specified in
|
|
basis points), or both.
|
|
$ref: '#/components/schemas/AdditionalCommission'
|
|
adyenCommission:
|
|
description: 'Deducts the transaction fee due to Adyen under [blended rates](https://www.adyen.com/knowledge-hub/guides/payments-training-guide/get-the-best-from-your-card-processing)
|
|
from the specified balance account.
|
|
|
|
|
|
Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.'
|
|
enum:
|
|
- deductFromLiableAccount
|
|
- deductFromOneBalanceAccount
|
|
type: string
|
|
adyenFees:
|
|
description: 'Deducts the fees due to Adyen (markup or commission) from
|
|
the specified balance account.
|
|
|
|
|
|
Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.'
|
|
enum:
|
|
- deductFromLiableAccount
|
|
- deductFromOneBalanceAccount
|
|
type: string
|
|
adyenMarkup:
|
|
description: 'Deducts the transaction fee due to Adyen under [Interchange
|
|
++ pricing](https://www.adyen.com/what-is-interchange) from the specified
|
|
balance account.
|
|
|
|
|
|
Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.'
|
|
enum:
|
|
- deductFromLiableAccount
|
|
- deductFromOneBalanceAccount
|
|
type: string
|
|
chargeback:
|
|
description: 'Specifies how and from which balance account(s) to deduct
|
|
the chargeback amount.
|
|
|
|
|
|
Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**,
|
|
**deductAccordingToSplitRatio**.'
|
|
enum:
|
|
- deductFromLiableAccount
|
|
- deductFromOneBalanceAccount
|
|
- deductAccordingToSplitRatio
|
|
type: string
|
|
chargebackCostAllocation:
|
|
description: 'Deducts the chargeback costs from the specified balance account.
|
|
|
|
|
|
Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**'
|
|
enum:
|
|
- deductFromLiableAccount
|
|
- deductFromOneBalanceAccount
|
|
type: string
|
|
commission:
|
|
description: Defines your platform's commission for the processed payments
|
|
as a fixed amount (specified in minor units), a percentage (specified
|
|
in basis points), or both. The commission is booked to your platform's
|
|
liable balance account.
|
|
$ref: '#/components/schemas/Commission'
|
|
interchange:
|
|
description: 'Deducts the interchange fee from specified balance account.
|
|
|
|
|
|
Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.'
|
|
enum:
|
|
- deductFromLiableAccount
|
|
- deductFromOneBalanceAccount
|
|
type: string
|
|
paymentFee:
|
|
description: 'Deducts all transaction fees incurred by the payment from
|
|
the specified balance account. The transaction fees include the acquiring
|
|
fees (interchange and scheme fee), and the fees due to Adyen (markup or
|
|
commission). You can book any and all these fees to different balance
|
|
account by specifying other transaction fee parameters in your split configuration
|
|
profile:
|
|
|
|
|
|
- [`adyenCommission`](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/(merchantId)/splitConfigurations#request-rules-splitLogic-adyenCommission):
|
|
The transaction fee due to Adyen under [blended rates](https://www.adyen.com/knowledge-hub/interchange-fees-explained#interchange-vs-blended).
|
|
|
|
- [`adyenMarkup`](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/(merchantId)/splitConfigurations#request-rules-splitLogic-adyenMarkup):
|
|
The transaction fee due to Adyen under [Interchange ++ pricing](https://www.adyen.com/knowledge-hub/interchange-fees-explained#interchange-vs-blended).
|
|
|
|
- [`schemeFee`](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/(merchantId)/splitConfigurations#request-rules-splitLogic-schemeFee):
|
|
The fee paid to the card scheme for using their network.
|
|
|
|
- [`interchange`](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/(merchantId)/splitConfigurations#request-rules-splitLogic-interchange):
|
|
The fee paid to the issuer for each payment transaction made with the
|
|
card network.
|
|
|
|
- [`adyenFees`](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/(merchantId)/splitConfigurations#request-rules-splitLogic-adyenFees):
|
|
The aggregated amount of Adyen''s commission and markup.
|
|
|
|
- [`acquiringFees`](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/(merchantId)/splitConfigurations#request-rules-splitLogic-acquiringFees):
|
|
The aggregated amount of the interchange and scheme fees.
|
|
|
|
|
|
If you don''t include at least one transaction fee type in the `splitLogic`
|
|
object, Adyen updates the payment request with the `paymentFee` parameter,
|
|
booking all transaction fees to your platform''s liable balance account.
|
|
|
|
|
|
Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.'
|
|
enum:
|
|
- deductFromLiableAccount
|
|
- deductFromOneBalanceAccount
|
|
type: string
|
|
refund:
|
|
description: 'Specifies how and from which balance account(s) to deduct
|
|
the refund amount.
|
|
|
|
|
|
Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**,
|
|
**deductAccordingToSplitRatio**'
|
|
enum:
|
|
- deductFromLiableAccount
|
|
- deductFromOneBalanceAccount
|
|
- deductAccordingToSplitRatio
|
|
type: string
|
|
refundCostAllocation:
|
|
description: 'Deducts the refund costs from the specified balance account.
|
|
|
|
|
|
Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**'
|
|
enum:
|
|
- deductFromLiableAccount
|
|
- deductFromOneBalanceAccount
|
|
type: string
|
|
remainder:
|
|
description: 'Books the amount left over after currency conversion to the
|
|
specified balance account.
|
|
|
|
|
|
Possible values: **addToLiableAccount**, **addToOneBalanceAccount**.'
|
|
enum:
|
|
- addToLiableAccount
|
|
- addToOneBalanceAccount
|
|
type: string
|
|
schemeFee:
|
|
description: 'Deducts the scheme fee from the specified balance account.
|
|
|
|
|
|
Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.'
|
|
enum:
|
|
- deductFromLiableAccount
|
|
- deductFromOneBalanceAccount
|
|
type: string
|
|
splitLogicId:
|
|
description: Unique identifier of the collection of split instructions that
|
|
are applied when the rule conditions are met.
|
|
readOnly: true
|
|
type: string
|
|
surcharge:
|
|
description: 'Books the surcharge amount to the specified balance account.
|
|
|
|
|
|
Possible values: **addToLiableAccount**, **addToOneBalanceAccount**'
|
|
enum:
|
|
- addToLiableAccount
|
|
- addToOneBalanceAccount
|
|
type: string
|
|
tip:
|
|
description: 'Books the tips (gratuity) to the specified balance account.
|
|
|
|
|
|
Possible values: **addToLiableAccount**, **addToOneBalanceAccount**.'
|
|
enum:
|
|
- addToLiableAccount
|
|
- addToOneBalanceAccount
|
|
type: string
|
|
required:
|
|
- commission
|
|
type: object
|
|
SplitConfigurationRule:
|
|
additionalProperties: false
|
|
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 of the payment method. This only applies
|
|
to card transactions.
|
|
|
|
|
|
Possible values:
|
|
|
|
* **credit**
|
|
|
|
* **debit**
|
|
|
|
* **prepaid**
|
|
|
|
* **deferred_debit**
|
|
|
|
* **charged**
|
|
|
|
* **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
|
|
Standalone:
|
|
additionalProperties: false
|
|
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
|
|
StarInfo:
|
|
additionalProperties: false
|
|
properties:
|
|
processingType:
|
|
description: "The type of transactions processed over this payment method.\n\
|
|
\ Allowed values:\n- **pos** for in-person payments. \n- **billpay** for\
|
|
\ subscription payments, both the initial payment and the later recurring\
|
|
\ payments. These transactions have `recurringProcessingModel` **Subscription**.\
|
|
\ \n- **ecom** for all other card not present transactions. This includes\
|
|
\ non-recurring transactions and transactions with `recurringProcessingModel`\
|
|
\ **CardOnFile** or **UnscheduledCardOnFile**.\n"
|
|
enum:
|
|
- billpay
|
|
- ecom
|
|
- pos
|
|
type: string
|
|
transactionDescription:
|
|
description: 'Information regarding the transaction description.
|
|
|
|
> You cannot configure the transaction description in the test environment.'
|
|
$ref: '#/components/schemas/TransactionDescriptionInfo'
|
|
required:
|
|
- processingType
|
|
type: object
|
|
Store:
|
|
additionalProperties: false
|
|
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.
|
|
|
|
|
|
Required for CNPJ in Brazil, in the format 00.000.000/0000-00 separated
|
|
by dots, slashes, hyphens, or without separators.
|
|
|
|
|
|
Optional for SIRET in France, up to 14 digits.
|
|
|
|
|
|
Optional for Zip in Australia, up to 50 digits.
|
|
|
|
|
|
'
|
|
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
|
|
StoreAndForward:
|
|
additionalProperties: false
|
|
properties:
|
|
maxAmount:
|
|
description: The maximum amount that the terminal accepts for a single store-and-forward
|
|
payment.
|
|
items:
|
|
$ref: '#/components/schemas/MinorUnitsMonetaryValue'
|
|
type: array
|
|
maxPayments:
|
|
description: The maximum number of store-and-forward transactions per terminal
|
|
that you can process while offline.
|
|
format: int32
|
|
type: integer
|
|
supportedCardTypes:
|
|
description: 'The type of card for which the terminal accepts store-and-forward
|
|
payments. You can specify multiple card types. '
|
|
$ref: '#/components/schemas/SupportedCardTypes'
|
|
type: object
|
|
StoreCreationRequest:
|
|
additionalProperties: false
|
|
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.
|
|
|
|
|
|
Required for CNPJ in Brazil, in the format 00.000.000/0000-00 separated
|
|
by dots, slashes, hyphens, or without separators.
|
|
|
|
|
|
Optional for SIRET in France, up to 14 digits.
|
|
|
|
|
|
Optional for Zip in Australia, up to 50 digits.
|
|
|
|
|
|
'
|
|
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\n\
|
|
If 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
|
|
StoreCreationWithMerchantCodeRequest:
|
|
additionalProperties: false
|
|
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.
|
|
|
|
|
|
Required for CNPJ in Brazil, in the format 00.000.000/0000-00 separated
|
|
by dots, slashes, hyphens, or without separators.
|
|
|
|
|
|
Optional for SIRET in France, up to 14 digits.
|
|
|
|
|
|
Optional for Zip in Australia, up to 50 digits.
|
|
|
|
|
|
'
|
|
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: "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\n\
|
|
If 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
|
|
- merchantId
|
|
type: object
|
|
StoreLocation:
|
|
additionalProperties: false
|
|
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
|
|
StoreSplitConfiguration:
|
|
additionalProperties: false
|
|
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/platforms/automatic-split-configuration/create-split-configuration/).
|
|
type: string
|
|
type: object
|
|
SupportedCardTypes:
|
|
additionalProperties: false
|
|
properties:
|
|
credit:
|
|
description: Set to **true** to accept credit cards.
|
|
type: boolean
|
|
debit:
|
|
description: Set to **true** to accept debit cards.
|
|
type: boolean
|
|
deferredDebit:
|
|
description: Set to **true** to accept cards that allow deferred debit.
|
|
type: boolean
|
|
prepaid:
|
|
description: Set to **true** to accept prepaid cards.
|
|
type: boolean
|
|
unknown:
|
|
description: Set to **true** to accept card types for which the terminal
|
|
can't determine the funding source while offline.
|
|
type: boolean
|
|
type: object
|
|
Surcharge:
|
|
additionalProperties: false
|
|
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 cards, funding sources
|
|
(credit or debit), and currencies.
|
|
items:
|
|
$ref: '#/components/schemas/Configuration'
|
|
type: array
|
|
excludeGratuityFromSurcharge:
|
|
description: Exclude the tip amount from the surcharge calculation.
|
|
type: boolean
|
|
type: object
|
|
SwishInfo:
|
|
additionalProperties: false
|
|
properties:
|
|
swishNumber:
|
|
description: 'Swish number. Format: 10 digits without spaces. For example,
|
|
**1231111111**.'
|
|
maxLength: 10
|
|
minLength: 10
|
|
type: string
|
|
required:
|
|
- swishNumber
|
|
type: object
|
|
TapToPay:
|
|
additionalProperties: false
|
|
properties:
|
|
merchantDisplayName:
|
|
description: The text shown on the screen during the Tap to Pay transaction.
|
|
type: string
|
|
type: object
|
|
Terminal:
|
|
additionalProperties: false
|
|
properties:
|
|
assignment:
|
|
x-addedInVersion: '2'
|
|
description: Indicates the account level to which the terminal is assigned,
|
|
the [assignment status](https://docs.adyen.com/point-of-sale/automating-terminal-management/assign-terminals-api),
|
|
and where the terminals is in the process of being reassigned to.
|
|
$ref: '#/components/schemas/TerminalAssignment'
|
|
connectivity:
|
|
x-addedInVersion: '2'
|
|
description: Information about bluetooth, cellular, ethernet and wifi connectivity
|
|
for the terminal.
|
|
$ref: '#/components/schemas/TerminalConnectivity'
|
|
firmwareVersion:
|
|
description: The software release currently in use on the terminal.
|
|
type: string
|
|
id:
|
|
description: The unique identifier of the terminal.
|
|
type: string
|
|
lastActivityAt:
|
|
x-addedInVersion: '2'
|
|
description: Date and time of the last activity on the terminal. Not included
|
|
when the last activity was more than 14 days ago.
|
|
format: date-time
|
|
type: string
|
|
lastTransactionAt:
|
|
x-addedInVersion: '2'
|
|
description: Date and time of the last transaction on the terminal. Not
|
|
included when the last transaction was more than 14 days ago.
|
|
format: date-time
|
|
type: string
|
|
model:
|
|
x-addedInVersion: '2'
|
|
description: The model name of the terminal.
|
|
type: string
|
|
restartLocalTime:
|
|
x-addedInVersion: '3'
|
|
description: The exact time of the terminal reboot, in the timezone of the
|
|
terminal in **HH:mm** format.
|
|
type: string
|
|
serialNumber:
|
|
description: The serial number of the terminal.
|
|
type: string
|
|
type: object
|
|
TerminalActionScheduleDetail:
|
|
additionalProperties: false
|
|
properties:
|
|
id:
|
|
description: The ID of the action on the specified terminal.
|
|
type: string
|
|
terminalId:
|
|
description: The unique ID of the terminal that the action applies to.
|
|
type: string
|
|
type: object
|
|
TerminalAssignment:
|
|
additionalProperties: false
|
|
properties:
|
|
companyId:
|
|
description: The unique identifier of the company account to which terminal
|
|
is assigned.
|
|
type: string
|
|
merchantId:
|
|
description: The unique identifier of the merchant account to which terminal
|
|
is assigned.
|
|
type: string
|
|
reassignmentTarget:
|
|
description: Indicates where the terminal is in the process of being reassigned
|
|
to.
|
|
$ref: '#/components/schemas/TerminalReassignmentTarget'
|
|
status:
|
|
description: "The status of the reassignment. Possible values: \n * `reassignmentInProgress`:\
|
|
\ the terminal was boarded and is now scheduled to remove the configuration.\
|
|
\ Wait for the terminal to synchronize with the Adyen platform.\n * `deployed`:\
|
|
\ the terminal is deployed and reassigned. \n * `inventory`: the terminal\
|
|
\ is in inventory and cannot process transactions. \n * `boarded`: the\
|
|
\ terminal is boarded to a store, or a merchant account representing a\
|
|
\ store, and can process transactions. \n"
|
|
enum:
|
|
- boarded
|
|
- deployed
|
|
- inventory
|
|
- reassignmentInProgress
|
|
type: string
|
|
storeId:
|
|
description: The unique identifier of the store to which terminal is assigned.
|
|
type: string
|
|
required:
|
|
- companyId
|
|
- status
|
|
type: object
|
|
TerminalConnectivity:
|
|
additionalProperties: false
|
|
properties:
|
|
bluetooth:
|
|
$ref: '#/components/schemas/TerminalConnectivityBluetooth'
|
|
cellular:
|
|
$ref: '#/components/schemas/TerminalConnectivityCellular'
|
|
ethernet:
|
|
$ref: '#/components/schemas/TerminalConnectivityEthernet'
|
|
wifi:
|
|
$ref: '#/components/schemas/TerminalConnectivityWifi'
|
|
type: object
|
|
TerminalConnectivityBluetooth:
|
|
additionalProperties: false
|
|
properties:
|
|
ipAddress:
|
|
description: The terminal's Bluetooth IP address.
|
|
type: string
|
|
macAddress:
|
|
description: The terminal's Bluetooth MAC address.
|
|
type: string
|
|
type: object
|
|
TerminalConnectivityCellular:
|
|
additionalProperties: false
|
|
properties:
|
|
iccid:
|
|
description: The integrated circuit card identifier (ICCID) of the primary
|
|
SIM card in the terminal.
|
|
type: string
|
|
iccid2:
|
|
description: The integrated circuit card identifier (ICCID) of the secondary
|
|
SIM card in the terminal, typically used for a [third-party SIM card](https://docs.adyen.com/point-of-sale/design-your-integration/network-and-connectivity/cellular-failover/#using-a-third-party-sim-card).
|
|
type: string
|
|
status:
|
|
description: On a terminal that supports 3G or 4G connectivity, indicates
|
|
the status of the primary SIM card in the terminal.
|
|
enum:
|
|
- activated
|
|
- deactivated
|
|
- deprecated
|
|
- inventory
|
|
- readyForActivation
|
|
type: string
|
|
type: object
|
|
TerminalConnectivityEthernet:
|
|
additionalProperties: false
|
|
properties:
|
|
ipAddress:
|
|
description: The terminal's ethernet IP address.
|
|
type: string
|
|
linkNegotiation:
|
|
description: The ethernet link negotiation that the terminal uses.
|
|
type: string
|
|
macAddress:
|
|
description: The terminal's ethernet MAC address.
|
|
type: string
|
|
type: object
|
|
TerminalConnectivityWifi:
|
|
additionalProperties: false
|
|
properties:
|
|
ipAddress:
|
|
description: The terminal's IP address in the Wi-Fi network.
|
|
type: string
|
|
macAddress:
|
|
description: The terminal's MAC address in the Wi-Fi network.
|
|
type: string
|
|
ssid:
|
|
description: The SSID of the Wi-Fi network that the terminal is connected
|
|
to.
|
|
type: string
|
|
type: object
|
|
TerminalInstructions:
|
|
additionalProperties: false
|
|
properties:
|
|
adyenAppRestart:
|
|
description: Indicates whether the Adyen app on the payment terminal restarts
|
|
automatically when the configuration is updated.
|
|
type: boolean
|
|
type: object
|
|
TerminalModelsResponse:
|
|
additionalProperties: false
|
|
properties:
|
|
data:
|
|
description: The terminal models that the API credential has access to.
|
|
items:
|
|
$ref: '#/components/schemas/IdName'
|
|
type: array
|
|
type: object
|
|
TerminalOrder:
|
|
additionalProperties: false
|
|
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
|
|
TerminalOrderRequest:
|
|
additionalProperties: false
|
|
properties:
|
|
billingEntityId:
|
|
description: "The identification of the billing entity to use for the order.\
|
|
\ \n\n > When ordering products in Brazil, you do not need to include\
|
|
\ the `billingEntityId` in the request."
|
|
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
|
|
TerminalOrdersResponse:
|
|
additionalProperties: false
|
|
properties:
|
|
data:
|
|
description: List of orders for payment terminal packages and parts.
|
|
items:
|
|
$ref: '#/components/schemas/TerminalOrder'
|
|
type: array
|
|
type: object
|
|
TerminalProduct:
|
|
additionalProperties: false
|
|
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
|
|
TerminalProductPrice:
|
|
additionalProperties: false
|
|
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
|
|
TerminalProductsResponse:
|
|
additionalProperties: false
|
|
properties:
|
|
data:
|
|
description: Terminal products that can be ordered.
|
|
items:
|
|
$ref: '#/components/schemas/TerminalProduct'
|
|
type: array
|
|
type: object
|
|
TerminalReassignmentRequest:
|
|
additionalProperties: false
|
|
properties:
|
|
companyId:
|
|
description: The unique identifier of the company account to which the terminal
|
|
is reassigned.
|
|
type: string
|
|
inventory:
|
|
description: 'Must be specified when reassigning terminals to a merchant
|
|
account:
|
|
|
|
|
|
- If set to **true**, reassigns terminals to the inventory of the merchant
|
|
account and the terminals cannot process transactions.
|
|
|
|
|
|
- If set to **false**, reassigns terminals directly to the merchant account
|
|
and the terminals can process transactions.'
|
|
type: boolean
|
|
merchantId:
|
|
description: The unique identifier of the merchant account to which the
|
|
terminal is reassigned. When reassigning terminals to a merchant account,
|
|
you must specify the `inventory` field.
|
|
type: string
|
|
storeId:
|
|
description: The unique identifier of the store to which the terminal is
|
|
reassigned.
|
|
type: string
|
|
type: object
|
|
TerminalReassignmentTarget:
|
|
additionalProperties: false
|
|
properties:
|
|
companyId:
|
|
description: The unique identifier of the company account to which the terminal
|
|
is reassigned.
|
|
type: string
|
|
inventory:
|
|
description: 'Indicates if the terminal is reassigned to the inventory of
|
|
the merchant account.
|
|
|
|
- If **true**, the terminal is in the inventory of the merchant account
|
|
and cannot process transactions.
|
|
|
|
- If **false**, the terminal is reassigned directly to the merchant account
|
|
and can process transactions.'
|
|
type: boolean
|
|
merchantId:
|
|
description: The unique identifier of the merchant account to which the
|
|
terminal is reassigned.
|
|
type: string
|
|
storeId:
|
|
description: The unique identifier of the store to which the terminal is
|
|
reassigned.
|
|
type: string
|
|
required:
|
|
- inventory
|
|
type: object
|
|
TerminalSettings:
|
|
additionalProperties: false
|
|
properties:
|
|
cardholderReceipt:
|
|
description: Settings to define the header of the shopper receipt.
|
|
nullable: true
|
|
$ref: '#/components/schemas/CardholderReceipt'
|
|
connectivity:
|
|
description: Settings for terminal connectivity features.
|
|
nullable: true
|
|
$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'
|
|
nullable: true
|
|
type: array
|
|
hardware:
|
|
description: Settings for terminal hardware features.
|
|
nullable: true
|
|
$ref: '#/components/schemas/Hardware'
|
|
localization:
|
|
description: Settings for localization.
|
|
nullable: true
|
|
$ref: '#/components/schemas/Localization'
|
|
nexo:
|
|
description: Settings for a Terminal API integration.
|
|
nullable: true
|
|
$ref: '#/components/schemas/Nexo'
|
|
offlineProcessing:
|
|
description: Settings for [offline payment](https://docs.adyen.com/point-of-sale/offline-payments)
|
|
features.
|
|
nullable: true
|
|
$ref: '#/components/schemas/OfflineProcessing'
|
|
opi:
|
|
description: Settings for an Oracle Payment Interface (OPI) integration.
|
|
nullable: true
|
|
$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.
|
|
nullable: true
|
|
$ref: '#/components/schemas/Passcodes'
|
|
payAtTable:
|
|
description: Settings for [Pay-at-table](https://docs.adyen.com/point-of-sale/pay-at-x)
|
|
features.
|
|
nullable: true
|
|
$ref: '#/components/schemas/PayAtTable'
|
|
payment:
|
|
description: Settings for payment features.
|
|
nullable: true
|
|
$ref: '#/components/schemas/Payment'
|
|
receiptOptions:
|
|
description: Generic receipt settings.
|
|
nullable: true
|
|
$ref: '#/components/schemas/ReceiptOptions'
|
|
receiptPrinting:
|
|
description: Transaction outcomes that you want the terminal to print a
|
|
merchant receipt or a shopper receipt for.
|
|
nullable: true
|
|
$ref: '#/components/schemas/ReceiptPrinting'
|
|
refunds:
|
|
description: Settings for refunds.
|
|
nullable: true
|
|
$ref: '#/components/schemas/Refunds'
|
|
signature:
|
|
description: Settings to skip signature, sign on display, or sign on receipt.
|
|
nullable: true
|
|
$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.
|
|
nullable: true
|
|
$ref: '#/components/schemas/Standalone'
|
|
storeAndForward:
|
|
description: Settings for store-and-forward offline payments. The `maxAmount`,
|
|
`maxPayments`, and `supportedCardTypes` parameters must be configured,
|
|
either in the request or inherited from a higher level in your account
|
|
structure.
|
|
nullable: true
|
|
$ref: '#/components/schemas/StoreAndForward'
|
|
surcharge:
|
|
description: Settings for payment [surcharge](https://docs.adyen.com/point-of-sale/surcharge)
|
|
features.
|
|
nullable: true
|
|
$ref: '#/components/schemas/Surcharge'
|
|
tapToPay:
|
|
description: Settings for Tap to Pay.
|
|
nullable: true
|
|
$ref: '#/components/schemas/TapToPay'
|
|
terminalInstructions:
|
|
description: Settings to define the behaviour of the payment terminal.
|
|
nullable: true
|
|
$ref: '#/components/schemas/TerminalInstructions'
|
|
timeouts:
|
|
description: Settings for device [time-outs](https://docs.adyen.com/point-of-sale/pos-timeouts#device-time-out).
|
|
nullable: true
|
|
$ref: '#/components/schemas/Timeouts'
|
|
wifiProfiles:
|
|
description: Remote Wi-Fi profiles for WPA and WPA2 PSK and EAP Wi-Fi networks.
|
|
nullable: true
|
|
$ref: '#/components/schemas/WifiProfiles'
|
|
type: object
|
|
TestCompanyWebhookRequest:
|
|
additionalProperties: false
|
|
properties:
|
|
merchantIds:
|
|
description: 'List of `merchantId` values for which test webhooks will be
|
|
sent. The list can have a maximum of 20 `merchantId` values.
|
|
|
|
|
|
If not specified, we send sample notifications to all the merchant accounts
|
|
that the webhook is configured for. If this is more than 20 merchant accounts,
|
|
use this list to specify a subset of the merchant accounts for which to
|
|
send test notifications.'
|
|
items:
|
|
type: string
|
|
type: array
|
|
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
|
|
TestOutput:
|
|
additionalProperties: false
|
|
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 **HTTP 2xx* 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**, `data.responseCode`: **2xx**.
|
|
|
|
* **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
|
|
TestWebhookRequest:
|
|
additionalProperties: false
|
|
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
|
|
TestWebhookResponse:
|
|
additionalProperties: false
|
|
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
|
|
TicketInfo:
|
|
additionalProperties: false
|
|
properties:
|
|
requestorId:
|
|
description: Ticket requestorId
|
|
type: string
|
|
type: object
|
|
Timeouts:
|
|
additionalProperties: false
|
|
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
|
|
TransactionDescriptionInfo:
|
|
additionalProperties: false
|
|
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
|
|
TwintInfo:
|
|
additionalProperties: false
|
|
properties:
|
|
logo:
|
|
description: 'Twint logo. Format: Base64-encoded string.'
|
|
type: string
|
|
required:
|
|
- logo
|
|
type: object
|
|
UninstallAndroidAppDetails:
|
|
additionalProperties: false
|
|
properties:
|
|
appId:
|
|
description: The unique identifier of the app to be uninstalled.
|
|
type: string
|
|
type:
|
|
default: UninstallAndroidApp
|
|
description: 'Type of terminal action: Uninstall an Android app.'
|
|
enum:
|
|
- UninstallAndroidApp
|
|
type: string
|
|
type: object
|
|
UninstallAndroidCertificateDetails:
|
|
additionalProperties: false
|
|
properties:
|
|
certificateId:
|
|
description: The unique identifier of the certificate to be uninstalled.
|
|
type: string
|
|
type:
|
|
default: UninstallAndroidCertificate
|
|
description: 'Type of terminal action: Uninstall an Android certificate.'
|
|
enum:
|
|
- UninstallAndroidCertificate
|
|
type: string
|
|
type: object
|
|
UpdatableAddress:
|
|
additionalProperties: false
|
|
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
|
|
UpdateCompanyApiCredentialRequest:
|
|
additionalProperties: false
|
|
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
|
|
associatedMerchantAccounts:
|
|
description: List of merchant accounts that the API credential has access
|
|
to.
|
|
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.<CompanyName>'
|
|
can be assigned to other API credentials.
|
|
items:
|
|
type: string
|
|
type: array
|
|
type: object
|
|
UpdateCompanyUserRequest:
|
|
additionalProperties: false
|
|
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: Indicates whether this user is active.
|
|
type: boolean
|
|
associatedMerchantAccounts:
|
|
description: The list of [merchant accounts](https://docs.adyen.com/account/account-structure#merchant-accounts)
|
|
to associate the user with.
|
|
items:
|
|
type: string
|
|
type: array
|
|
email:
|
|
description: The email address of the user.
|
|
type: string
|
|
loginMethod:
|
|
description: 'The requested login method for the user. To use SSO, you must
|
|
already have SSO configured with Adyen before creating the user.
|
|
|
|
|
|
Possible values: **Username & account**, **Email**, or **SSO** '
|
|
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
|
|
UpdateCompanyWebhookRequest:
|
|
additionalProperties: false
|
|
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
|
|
filterMerchantAccountType:
|
|
description: 'Shows how merchant accounts are filtered when configuring
|
|
the webhook. Possible values:
|
|
|
|
* **includeAccounts**: The webhook is configured for the merchant accounts
|
|
listed in `filterMerchantAccounts`.
|
|
|
|
* **excludeAccounts**: The webhook is not configured for the merchant
|
|
accounts listed in `filterMerchantAccounts`.
|
|
|
|
* **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
|
|
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
|
|
UpdateMerchantApiCredentialRequest:
|
|
additionalProperties: false
|
|
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.<CompanyName>'
|
|
can be assigned to other API credentials.
|
|
items:
|
|
type: string
|
|
type: array
|
|
type: object
|
|
UpdateMerchantUserRequest:
|
|
additionalProperties: false
|
|
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
|
|
loginMethod:
|
|
description: 'The requested login method for the user. To use SSO, you must
|
|
already have SSO configured with Adyen before creating the user.
|
|
|
|
|
|
Possible values: **Username & account**, **Email**, or **SSO** '
|
|
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
|
|
UpdateMerchantWebhookRequest:
|
|
additionalProperties: false
|
|
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
|
|
UpdatePaymentMethodInfo:
|
|
additionalProperties: false
|
|
properties:
|
|
accel:
|
|
description: ACCEL details.
|
|
$ref: '#/components/schemas/AccelInfo'
|
|
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'
|
|
eft_directdebit_CA:
|
|
description: EFT Direct Debit Canada 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. In the US, `maestro` is not supported; use
|
|
`maestro_usa` instead.
|
|
$ref: '#/components/schemas/GenericPmWithTdiInfo'
|
|
mc:
|
|
description: MasterCard details.
|
|
$ref: '#/components/schemas/GenericPmWithTdiInfo'
|
|
nyce:
|
|
description: NYCE details.
|
|
$ref: '#/components/schemas/NyceInfo'
|
|
pulse:
|
|
description: PULSE details.
|
|
$ref: '#/components/schemas/PulseInfo'
|
|
star:
|
|
description: STAR details.
|
|
$ref: '#/components/schemas/StarInfo'
|
|
storeId:
|
|
x-addedInVersion: '3'
|
|
description: The store for this payment method
|
|
type: string
|
|
storeIds:
|
|
deprecated: true
|
|
x-deprecatedInVersion: '3'
|
|
x-deprecatedMessage: Use `storeId` instead. Only one store per payment method
|
|
is allowed.
|
|
description: The list of stores for this payment method
|
|
items:
|
|
type: string
|
|
type: array
|
|
visa:
|
|
description: Visa details.
|
|
$ref: '#/components/schemas/GenericPmWithTdiInfo'
|
|
type: object
|
|
UpdatePayoutSettingsRequest:
|
|
additionalProperties: false
|
|
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
|
|
UpdateSplitConfigurationLogicRequest:
|
|
additionalProperties: false
|
|
properties:
|
|
acquiringFees:
|
|
description: 'Deducts the acquiring fees (the aggregated amount of interchange
|
|
and scheme fee) from the specified balance account.
|
|
|
|
|
|
Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.'
|
|
enum:
|
|
- deductFromLiableAccount
|
|
- deductFromOneBalanceAccount
|
|
type: string
|
|
additionalCommission:
|
|
description: Defines whether to book an additional commission for payments
|
|
to your user's balance account. The commission amount can be defined as
|
|
a fixed amount (specified in minor units), a percentage (specified in
|
|
basis points), or both.
|
|
$ref: '#/components/schemas/AdditionalCommission'
|
|
adyenCommission:
|
|
description: 'Deducts the transaction fee due to Adyen under [blended rates](https://www.adyen.com/knowledge-hub/guides/payments-training-guide/get-the-best-from-your-card-processing)
|
|
from the specified balance account.
|
|
|
|
|
|
Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.'
|
|
enum:
|
|
- deductFromLiableAccount
|
|
- deductFromOneBalanceAccount
|
|
type: string
|
|
adyenFees:
|
|
description: 'Deducts the fees due to Adyen (markup or commission) from
|
|
the specified balance account.
|
|
|
|
|
|
Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.'
|
|
enum:
|
|
- deductFromLiableAccount
|
|
- deductFromOneBalanceAccount
|
|
type: string
|
|
adyenMarkup:
|
|
description: 'Deducts the transaction fee due to Adyen under [Interchange
|
|
++ pricing](https://www.adyen.com/what-is-interchange) from the specified
|
|
balance account.
|
|
|
|
|
|
Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.'
|
|
enum:
|
|
- deductFromLiableAccount
|
|
- deductFromOneBalanceAccount
|
|
type: string
|
|
chargeback:
|
|
description: 'Specifies how and from which balance account(s) to deduct
|
|
the chargeback amount.
|
|
|
|
|
|
Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**,
|
|
**deductAccordingToSplitRatio**.'
|
|
enum:
|
|
- deductFromLiableAccount
|
|
- deductFromOneBalanceAccount
|
|
- deductAccordingToSplitRatio
|
|
type: string
|
|
chargebackCostAllocation:
|
|
description: 'Deducts the chargeback costs from the specified balance account.
|
|
|
|
|
|
Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**'
|
|
enum:
|
|
- deductFromLiableAccount
|
|
- deductFromOneBalanceAccount
|
|
type: string
|
|
commission:
|
|
description: Defines your platform's commission for the processed payments
|
|
as a fixed amount (specified in minor units), a percentage (specified
|
|
in basis points), or both. The commission is booked to your platform's
|
|
liable balance account.
|
|
$ref: '#/components/schemas/Commission'
|
|
interchange:
|
|
description: 'Deducts the interchange fee from specified balance account.
|
|
|
|
|
|
Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.'
|
|
enum:
|
|
- deductFromLiableAccount
|
|
- deductFromOneBalanceAccount
|
|
type: string
|
|
paymentFee:
|
|
description: 'Deducts all transaction fees incurred by the payment from
|
|
the specified balance account. The transaction fees include the acquiring
|
|
fees (interchange and scheme fee), and the fees due to Adyen (markup or
|
|
commission). You can book any and all these fees to different balance
|
|
account by specifying other transaction fee parameters in your split configuration
|
|
profile:
|
|
|
|
|
|
- [`adyenCommission`](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/(merchantId)/splitConfigurations#request-rules-splitLogic-adyenCommission):
|
|
The transaction fee due to Adyen under [blended rates](https://www.adyen.com/knowledge-hub/interchange-fees-explained#interchange-vs-blended).
|
|
|
|
- [`adyenMarkup`](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/(merchantId)/splitConfigurations#request-rules-splitLogic-adyenMarkup):
|
|
The transaction fee due to Adyen under [Interchange ++ pricing](https://www.adyen.com/knowledge-hub/interchange-fees-explained#interchange-vs-blended).
|
|
|
|
- [`schemeFee`](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/(merchantId)/splitConfigurations#request-rules-splitLogic-schemeFee):
|
|
The fee paid to the card scheme for using their network.
|
|
|
|
- [`interchange`](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/(merchantId)/splitConfigurations#request-rules-splitLogic-interchange):
|
|
The fee paid to the issuer for each payment transaction made with the
|
|
card network.
|
|
|
|
- [`adyenFees`](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/(merchantId)/splitConfigurations#request-rules-splitLogic-adyenFees):
|
|
The aggregated amount of Adyen''s commission and markup.
|
|
|
|
- [`acquiringFees`](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/(merchantId)/splitConfigurations#request-rules-splitLogic-acquiringFees):
|
|
The aggregated amount of the interchange and scheme fees.
|
|
|
|
|
|
If you don''t include at least one transaction fee type in the `splitLogic`
|
|
object, Adyen updates the payment request with the `paymentFee` parameter,
|
|
booking all transaction fees to your platform''s liable balance account.
|
|
|
|
|
|
Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.'
|
|
enum:
|
|
- deductFromLiableAccount
|
|
- deductFromOneBalanceAccount
|
|
type: string
|
|
refund:
|
|
description: 'Specifies how and from which balance account(s) to deduct
|
|
the refund amount.
|
|
|
|
|
|
Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**,
|
|
**deductAccordingToSplitRatio**'
|
|
enum:
|
|
- deductFromLiableAccount
|
|
- deductFromOneBalanceAccount
|
|
- deductAccordingToSplitRatio
|
|
type: string
|
|
refundCostAllocation:
|
|
description: 'Deducts the refund costs from the specified balance account.
|
|
|
|
|
|
Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**'
|
|
enum:
|
|
- deductFromLiableAccount
|
|
- deductFromOneBalanceAccount
|
|
type: string
|
|
remainder:
|
|
description: 'Books the amount left over after currency conversion to the
|
|
specified balance account.
|
|
|
|
|
|
Possible values: **addToLiableAccount**, **addToOneBalanceAccount**.'
|
|
enum:
|
|
- addToLiableAccount
|
|
- addToOneBalanceAccount
|
|
type: string
|
|
schemeFee:
|
|
description: 'Deducts the scheme fee from the specified balance account.
|
|
|
|
|
|
Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.'
|
|
enum:
|
|
- deductFromLiableAccount
|
|
- deductFromOneBalanceAccount
|
|
type: string
|
|
splitLogicId:
|
|
description: Unique identifier of the collection of split instructions that
|
|
are applied when the rule conditions are met.
|
|
readOnly: true
|
|
type: string
|
|
surcharge:
|
|
description: 'Books the surcharge amount to the specified balance account.
|
|
|
|
|
|
Possible values: **addToLiableAccount**, **addToOneBalanceAccount**'
|
|
enum:
|
|
- addToLiableAccount
|
|
- addToOneBalanceAccount
|
|
type: string
|
|
tip:
|
|
description: 'Books the tips (gratuity) to the specified balance account.
|
|
|
|
|
|
Possible values: **addToLiableAccount**, **addToOneBalanceAccount**.'
|
|
enum:
|
|
- addToLiableAccount
|
|
- addToOneBalanceAccount
|
|
type: string
|
|
required:
|
|
- commission
|
|
type: object
|
|
UpdateSplitConfigurationRequest:
|
|
additionalProperties: false
|
|
properties:
|
|
description:
|
|
description: Your description for the split configuration.
|
|
maxLength: 300
|
|
type: string
|
|
required:
|
|
- description
|
|
type: object
|
|
UpdateSplitConfigurationRuleRequest:
|
|
additionalProperties: false
|
|
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 of the payment method. This only applies
|
|
to card transactions.
|
|
|
|
|
|
Possible values:
|
|
|
|
* **credit**
|
|
|
|
* **debit**
|
|
|
|
* **prepaid**
|
|
|
|
* **deferred_debit**
|
|
|
|
* **charged**
|
|
|
|
* **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
|
|
UpdateStoreRequest:
|
|
additionalProperties: false
|
|
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.
|
|
|
|
|
|
Required for CNPJ in Brazil, in the format 00.000.000/0000-00 separated
|
|
by dots, slashes, hyphens, or without separators.
|
|
|
|
|
|
Optional for SIRET in France, up to 14 digits.
|
|
|
|
|
|
Optional for Zip in Australia, up to 50 digits.
|
|
|
|
|
|
'
|
|
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
|
|
UploadAndroidAppResponse:
|
|
additionalProperties: false
|
|
properties:
|
|
id:
|
|
description: The unique identifier of the uploaded Android app.
|
|
type: string
|
|
type: object
|
|
UploadAndroidCertificateResponse:
|
|
additionalProperties: false
|
|
properties:
|
|
id:
|
|
description: The unique identifier of the uploaded Android certificate.
|
|
type: string
|
|
type: object
|
|
Url:
|
|
additionalProperties: false
|
|
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
|
|
User:
|
|
additionalProperties: false
|
|
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
|
|
VippsInfo:
|
|
additionalProperties: false
|
|
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
|
|
WeChatPayInfo:
|
|
additionalProperties: false
|
|
properties:
|
|
contactPersonName:
|
|
description: The name of the contact person from merchant support.
|
|
type: string
|
|
email:
|
|
description: The email address of merchant support.
|
|
type: string
|
|
required:
|
|
- email
|
|
- contactPersonName
|
|
type: object
|
|
WeChatPayPosInfo:
|
|
additionalProperties: false
|
|
properties:
|
|
contactPersonName:
|
|
description: The name of the contact person from merchant support.
|
|
type: string
|
|
email:
|
|
description: The email address of merchant support.
|
|
type: string
|
|
required:
|
|
- email
|
|
- contactPersonName
|
|
type: object
|
|
Webhook:
|
|
additionalProperties: false
|
|
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**
|
|
|
|
- **terminal-settings**
|
|
|
|
- **terminal-boarding**
|
|
|
|
|
|
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
|
|
WebhookLinks:
|
|
additionalProperties: false
|
|
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
|
|
WifiProfiles:
|
|
additionalProperties: false
|
|
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
|
|
securitySchemes:
|
|
ApiKeyAuth:
|
|
in: header
|
|
name: X-API-Key
|
|
type: apiKey
|
|
BasicAuth:
|
|
scheme: basic
|
|
type: http
|
|
examples:
|
|
get-companies-companyId-androidApps-success-200:
|
|
summary: Response code - 200 OK
|
|
description: Example response when getting a list of Android apps
|
|
value:
|
|
data:
|
|
- id: ANDA422LZ223223K5F694GCCF732K8
|
|
packageName: com.your_company.posapp
|
|
versionCode: 7700203
|
|
description: POS2
|
|
label: POS system
|
|
versionName: '7.7'
|
|
status: ready
|
|
- id: ANDA422LZ223223K5F694FWCF738PL
|
|
packageName: com.your_company.posapp
|
|
versionCode: 7602003
|
|
description: POS1
|
|
label: POS system
|
|
versionName: '7.6'
|
|
status: ready
|
|
get-companies-companyId-androidCertificates-success-200:
|
|
summary: Response code - 200 OK
|
|
description: Example response when getting a list of Android certificates
|
|
value:
|
|
data:
|
|
- id: ANDC422LZ223223K5F78NVN9SL4VPH
|
|
name: mycert
|
|
extension: .crt
|
|
description: ''
|
|
status: ready
|
|
notBefore: '2008-04-20T00:00:00+02:00'
|
|
notAfter: '2038-04-12T00:00:00+02:00'
|
|
- id: ANDC533MA33433L689OWO0TM5WQI
|
|
name: mynewcert
|
|
extension: .pem
|
|
description: ''
|
|
status: ready
|
|
notBefore: '2008-04-20T00:00:00+02:00'
|
|
notAfter: '2048-04-12T00:00:00+02:00'
|
|
get-companies-companyId-apiCredentials-apiCredentialId-allowedOrigins-get-allowed-origins-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/companies/YOUR_COMPANY_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/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL/allowedOrigins/YOUR_ALLOWED_ORIGIN_2
|
|
get-companies-companyId-apiCredentials-apiCredentialId-allowedOrigins-originId-get-allowed-origin-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.us.mystore.com
|
|
_links:
|
|
self:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL/allowedOrigins/YOUR_ALLOWED_ORIGIN
|
|
get-companies-companyId-apiCredentials-apiCredentialId-success-200:
|
|
summary: Details of the API credential
|
|
description: Example response with details of the API credential at the company
|
|
level
|
|
value:
|
|
id: YOUR_API_CREDENTIAL
|
|
username: YOUR_USERNAME
|
|
clientKey: YOUR_CLIENT_KEY
|
|
allowedIpAddresses: []
|
|
roles:
|
|
- Checkout encrypted cardholder data
|
|
- Merchant Recurring role
|
|
- Checkout webservice role
|
|
active: true
|
|
allowedOrigins:
|
|
- id: YOUR_ALLOWED_ORIGIN_1
|
|
domain: http://localhost
|
|
_links:
|
|
self:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL/allowedOrigins/YOUR_ALLOWED_ORIGIN_1
|
|
- id: YOUR_ALLOWED_ORIGIN_2
|
|
domain: http://localhost:3000
|
|
_links:
|
|
self:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL/allowedOrigins/YOUR_ALLOWED_ORIGIN_2
|
|
_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
|
|
company:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT
|
|
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
|
|
associatedMerchantAccounts: []
|
|
get-companies-companyId-apiCredentials-success-200:
|
|
summary: List of API credentials
|
|
description: Example response when your API credential has access to 25 API
|
|
credentials at the company level
|
|
value:
|
|
_links:
|
|
first:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials?pageNumber=1&pageSize=10
|
|
last:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials?pageNumber=3&pageSize=10
|
|
next:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials?pageNumber=2&pageSize=10
|
|
self:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials?pageNumber=1&pageSize=10
|
|
itemsTotal: 25
|
|
pagesTotal: 3
|
|
data:
|
|
- id: YOUR_API_CREDENTIAL_1
|
|
username: YOUR_USERNAME_1
|
|
clientKey: YOUR_CLIENT_KEY_1
|
|
allowedIpAddresses: []
|
|
roles:
|
|
- Checkout encrypted cardholder data
|
|
- Merchant Recurring role
|
|
- Checkout webservice role
|
|
active: true
|
|
allowedOrigins:
|
|
- id: YOUR_ALLOWED_ORIGIN_1
|
|
domain: http://localhost
|
|
_links:
|
|
self:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_1/allowedOrigins/YOUR_ALLOWED_ORIGIN_1
|
|
- id: YOUR_ALLOWED_ORIGIN_2
|
|
domain: http://localhost:3000
|
|
_links:
|
|
self:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_1/allowedOrigins/YOUR_ALLOWED_ORIGIN_2
|
|
_links:
|
|
self:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_1
|
|
allowedOrigins:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_1/allowedOrigins
|
|
company:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT
|
|
generateApiKey:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_1/generateApiKey
|
|
generateClientKey:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_1/generateClientKey
|
|
associatedMerchantAccounts: []
|
|
- id: YOUR_API_CREDENTIAL_2
|
|
username: YOUR_USERNAME_2
|
|
clientKey: YOUR_CLIENT_KEY_2
|
|
allowedIpAddresses: []
|
|
roles:
|
|
- Checkout encrypted cardholder data
|
|
- Merchant Recurring role
|
|
- Checkout webservice role
|
|
active: true
|
|
_links:
|
|
self:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_2
|
|
allowedOrigins:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_2/allowedOrigins
|
|
company:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT
|
|
generateApiKey:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_2/generateApiKey
|
|
generateClientKey:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_2/generateClientKey
|
|
associatedMerchantAccounts: []
|
|
- id: YOUR_API_CREDENTIAL_3
|
|
username: YOUR_USERNAME_3
|
|
clientKey: YOUR_CLIENT_KEY_3
|
|
allowedIpAddresses: []
|
|
roles:
|
|
- API Supply MPI data with Payments
|
|
- Checkout encrypted cardholder data
|
|
- Merchant Recurring role
|
|
- API PCI Payments role
|
|
- Checkout webservice role
|
|
- API 3DS 2.0 to retrieve the ThreeDS2Result for authentication only
|
|
active: true
|
|
_links:
|
|
self:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_3
|
|
allowedOrigins:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_3/allowedOrigins
|
|
company:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT
|
|
generateApiKey:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_3/generateApiKey
|
|
generateClientKey:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_3/generateClientKey
|
|
associatedMerchantAccounts: []
|
|
- id: YOUR_API_CREDENTIAL_4
|
|
username: YOUR_USERNAME_4
|
|
clientKey: YOUR_CLIENT_KEY_4
|
|
allowedIpAddresses: []
|
|
roles:
|
|
- Checkout encrypted cardholder data
|
|
- Checkout webservice role
|
|
active: true
|
|
_links:
|
|
self:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_4
|
|
allowedOrigins:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_4/allowedOrigins
|
|
company:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT
|
|
generateApiKey:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_4/generateApiKey
|
|
generateClientKey:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_4/generateClientKey
|
|
associatedMerchantAccounts:
|
|
- YOUR_MERCHANT_ACCOUNT_1
|
|
- id: YOUR_API_CREDENTIAL_5
|
|
username: YOUR_USERNAME_5
|
|
clientKey: YOUR_CLIENT_KEY_5
|
|
allowedIpAddresses: []
|
|
roles:
|
|
- Checkout encrypted cardholder data
|
|
- Merchant Recurring role
|
|
- API Authorise Referred Payments
|
|
- API PCI Payments role
|
|
- Checkout webservice role
|
|
- Merchant PAL Webservice role
|
|
active: true
|
|
_links:
|
|
self:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_5
|
|
allowedOrigins:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_5/allowedOrigins
|
|
company:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT
|
|
generateApiKey:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_5/generateApiKey
|
|
generateClientKey:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_5/generateClientKey
|
|
associatedMerchantAccounts: []
|
|
- id: YOUR_API_CREDENTIAL_6
|
|
username: YOUR_USERNAME_6
|
|
clientKey: YOUR_CLIENT_KEY_6
|
|
allowedIpAddresses: []
|
|
roles:
|
|
- Merchant Report Download role
|
|
active: true
|
|
_links:
|
|
self:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_6
|
|
allowedOrigins:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_6/allowedOrigins
|
|
company:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT
|
|
generateApiKey:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_6/generateApiKey
|
|
generateClientKey:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_6/generateClientKey
|
|
associatedMerchantAccounts: []
|
|
- id: YOUR_API_CREDENTIAL_7
|
|
username: YOUR_USERNAME_7
|
|
clientKey: YOUR_CLIENT_KEY_7
|
|
allowedIpAddresses: []
|
|
roles:
|
|
- Merchant Report Download role
|
|
active: true
|
|
_links:
|
|
self:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_7
|
|
allowedOrigins:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_7/allowedOrigins
|
|
company:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT
|
|
generateApiKey:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_7/generateApiKey
|
|
generateClientKey:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_7/generateClientKey
|
|
associatedMerchantAccounts:
|
|
- YOUR_MERCHANT_ACCOUNT_2
|
|
- YOUR_MERCHANT_ACCOUNT_3
|
|
- id: YOUR_API_CREDENTIAL_8
|
|
username: YOUR_USERNAME_8
|
|
clientKey: YOUR_CLIENT_KEY_8
|
|
allowedIpAddresses: []
|
|
roles:
|
|
- Merchant Report Download role
|
|
active: true
|
|
_links:
|
|
self:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_8
|
|
allowedOrigins:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_8/allowedOrigins
|
|
company:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT
|
|
generateApiKey:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_8/generateApiKey
|
|
generateClientKey:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_8/generateClientKey
|
|
associatedMerchantAccounts: []
|
|
- id: YOUR_API_CREDENTIAL_9
|
|
username: YOUR_USERNAME_9
|
|
clientKey: YOUR_CLIENT_KEY_9
|
|
allowedIpAddresses: []
|
|
roles:
|
|
- Merchant Report Download role
|
|
active: true
|
|
_links:
|
|
self:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_9
|
|
allowedOrigins:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_9/allowedOrigins
|
|
company:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT
|
|
generateApiKey:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_9/generateApiKey
|
|
generateClientKey:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_9/generateClientKey
|
|
associatedMerchantAccounts:
|
|
- YOUR_MERCHANT_ACCOUNT_4
|
|
- YOUR_MERCHANT_ACCOUNT_5
|
|
- id: YOUR_API_CREDENTIAL_10
|
|
username: YOUR_USERNAME_10
|
|
clientKey: YOUR_CLIENT_KEY_10
|
|
allowedIpAddresses: []
|
|
roles:
|
|
- Merchant Report Download role
|
|
active: true
|
|
_links:
|
|
self:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_10
|
|
allowedOrigins:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_10/allowedOrigins
|
|
company:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT
|
|
generateApiKey:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_10/generateApiKey
|
|
generateClientKey:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL_10/generateClientKey
|
|
associatedMerchantAccounts: []
|
|
get-companies-companyId-billingEntities-success-200:
|
|
summary: Response code - 200 OK
|
|
description: Example response with billing entities for a company
|
|
value:
|
|
data:
|
|
- id: Company.YOUR_COMPANY
|
|
name: YOUR_COMPANY
|
|
taxId: NL1234567890
|
|
email: Paul.Green@company.com
|
|
address:
|
|
streetAddress: Simon Carmiggeltstraat 6-50
|
|
postalCode: 1011 DJ
|
|
city: Amsterdam
|
|
country: NL
|
|
- 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
|
|
get-companies-companyId-merchants-success-200:
|
|
summary: List of merchant accounts
|
|
description: Example response when your API credential has access to 22 merchant
|
|
accounts
|
|
value:
|
|
_links:
|
|
first:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/merchants?pageNumber=1&pageSize=10
|
|
last:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/merchants?pageNumber=3&pageSize=10
|
|
next:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/merchants?pageNumber=2&pageSize=10
|
|
self:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/merchants?pageNumber=1&pageSize=10
|
|
itemsTotal: 22
|
|
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: Active
|
|
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_ACCOUNT_6
|
|
apiCredentials:
|
|
href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_6/apiCredentials
|
|
users:
|
|
href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_6/users
|
|
webhooks:
|
|
href: https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT_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
|
|
get-companies-companyId-shippingLocations-success-200:
|
|
summary: Response code - 200 OK
|
|
description: Example response with shipping locations for a company
|
|
value:
|
|
data:
|
|
- id: S2-232A6D2967356F424F4369432B3F486B6A6D
|
|
name: YOUR_COMPANY HQ - POS Ops
|
|
contact:
|
|
firstName: Paul
|
|
lastName: Green
|
|
email: Paul.Green@company.com
|
|
address:
|
|
streetAddress: Simon Carmiggeltstraat
|
|
streetAddress2: 6-50
|
|
postalCode: 1011 DJ
|
|
city: Amsterdam
|
|
country: NL
|
|
- 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
|
|
get-companies-companyId-success-200:
|
|
summary: Details of the company account
|
|
description: Example response with the details of the company account.
|
|
value:
|
|
id: YOUR_COMPANY_ACCOUNT
|
|
name: YOUR_SHOP_NAME
|
|
status: Active
|
|
dataCenters:
|
|
- name: default
|
|
livePrefix: ''
|
|
_links:
|
|
self:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT
|
|
apiCredentials:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials
|
|
users:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/users
|
|
webhooks:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/webhooks
|
|
get-companies-companyId-terminalActions-actionId-success-200:
|
|
summary: Response code - 200 OK
|
|
description: Example response with the details of the specified terminal action
|
|
value:
|
|
actionType: InstallAndroidCertificate
|
|
config: '{"certificates":"5dff6b..."}'
|
|
confirmedAt: '2022-06-27T17:44:54+02:00'
|
|
id: TRAC4224Z223223K5GD89RLBWQ6CWT
|
|
result: Ok
|
|
scheduledAt: '2022-06-27T15:44:07+02:00'
|
|
status: successful
|
|
terminalId: S1F2-000150183300034
|
|
get-companies-companyId-terminalActions-success-200:
|
|
summary: Response code - 200 OK
|
|
description: Example response when getting a list of scheduled terminal actions
|
|
value:
|
|
data:
|
|
- actionType: InstallAndroidApp
|
|
config: '{"apps":"com.adyen.android.calculator:103"}'
|
|
confirmedAt: '2021-11-10T00:00:00+01:00'
|
|
id: TRAC422T2223223K5GFMQHM6WQ4KB6
|
|
result: Cancelled manually by user USER@Psp.AdyenPspService
|
|
scheduledAt: '2021-11-10T14:53:05+01:00'
|
|
status: cancelled
|
|
terminalId: S1E-000150183300032
|
|
get-companies-companyId-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-companies-companyId-terminalModels-success-200:
|
|
summary: Response code - 200 OK
|
|
description: Example response with the terminal models that the company 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-companies-companyId-terminalOrders-orderId-success-200:
|
|
summary: Response code - 200 OK
|
|
description: Example response with the details of the terminal products order
|
|
value:
|
|
id: '5265677890100681'
|
|
customerOrderReference: YOUR_REFERENCE_1
|
|
status: Placed
|
|
shippingLocation:
|
|
id: S2-232A6D2967356F424F4369432B3F486B6A6D
|
|
name: YOUR_COMPANY HQ - POS Ops
|
|
contact:
|
|
firstName: Paul
|
|
lastName: Green
|
|
email: Paul.Green@company.com
|
|
address:
|
|
streetAddress: Simon Carmiggeltstraat
|
|
streetAddress2: 6-50
|
|
postalCode: 1011 DJ
|
|
city: Amsterdam
|
|
country: NL
|
|
billingEntity:
|
|
id: Company.YOUR_COMPANY
|
|
name: YOUR_COMPANY
|
|
taxId: NL1234567890
|
|
email: Paul.Green@company.com
|
|
address:
|
|
streetAddress: Simon Carmiggeltstraat 6-50
|
|
postalCode: 1011 DJ
|
|
city: Amsterdam
|
|
country: NL
|
|
orderDate: '2022-01-20T14:12:33Z'
|
|
items:
|
|
- id: TBOX-V400m-684-EU
|
|
name: V400m Package
|
|
quantity: 1
|
|
- id: PART-175746-EU
|
|
name: Adyen Test Card
|
|
quantity: 1
|
|
get-companies-companyId-terminalOrders-success-200:
|
|
summary: Response code - 200 OK
|
|
description: Example response with the terminal orders for a company
|
|
value:
|
|
data:
|
|
- id: '5265677890100681'
|
|
customerOrderReference: YOUR_REFERENCE_C2
|
|
status: Placed
|
|
shippingLocation:
|
|
id: S2-232A6D2967356F424F4369432B3F486B6A6D
|
|
name: YOUR_COMPANY HQ - POS Ops
|
|
contact:
|
|
firstName: Paul
|
|
lastName: Green
|
|
email: Paul.Green@company.com
|
|
address:
|
|
streetAddress: Simon Carmiggeltstraat
|
|
streetAddress2: 6-50
|
|
postalCode: 1011 DJ
|
|
city: Amsterdam
|
|
country: NL
|
|
billingEntity:
|
|
id: Company.YOUR_COMPANY
|
|
name: YOUR_COMPANY
|
|
taxId: NL1234567890
|
|
email: Paul.Green@company.com
|
|
address:
|
|
streetAddress: Simon Carmiggeltstraat 6-50
|
|
postalCode: 1011 DJ
|
|
city: Amsterdam
|
|
country: NL
|
|
orderDate: '2020-06-10T17:03:11.000Z'
|
|
items:
|
|
- id: TBOX-MX925-422-EU
|
|
name: MX925 Package
|
|
quantity: 1
|
|
- id: '9415936144678634'
|
|
customerOrderReference: YOUR_REFERENCE_C1
|
|
status: Cancelled
|
|
shippingLocation:
|
|
id: S2-232A6D2967356F424F4369432B3F486B6A6D
|
|
name: YOUR_COMPANY HQ - POS Ops
|
|
contact:
|
|
firstName: Paul
|
|
lastName: Green
|
|
email: Paul.Green@company.com
|
|
address:
|
|
streetAddress: Simon Carmiggeltstraat
|
|
streetAddress2: 6-50
|
|
postalCode: 1011 DJ
|
|
city: Amsterdam
|
|
country: NL
|
|
billingEntity:
|
|
id: Company.YOUR_COMPANY
|
|
name: YOUR_COMPANY
|
|
taxId: NL1234567890
|
|
email: Paul.Green@company.com
|
|
address:
|
|
streetAddress: Simon Carmiggeltstraat 6-50
|
|
postalCode: 1011 DJ
|
|
city: Amsterdam
|
|
country: NL
|
|
orderDate: '2022-01-03T16:41:07.000Z'
|
|
items:
|
|
- id: TBOX-V400m-774-EU
|
|
name: V400m Package
|
|
quantity: 5
|
|
get-companies-companyId-terminalProducts-success-200:
|
|
summary: Response code - 200 OK
|
|
description: Example response with V400m products available in The Netherlands
|
|
value:
|
|
data:
|
|
- id: PART-620222-EU
|
|
name: Receipt Roll
|
|
price:
|
|
currency: EUR
|
|
value: 0.0
|
|
- id: PART-175746-EU
|
|
name: Adyen Test Card
|
|
price:
|
|
currency: EUR
|
|
value: 0.0
|
|
- id: PART-327486-EU
|
|
name: Battery - V400m
|
|
price:
|
|
currency: EUR
|
|
value: 0.0
|
|
- id: PART-287001-EU
|
|
name: Bluetooth Charging Base - V400m
|
|
price:
|
|
currency: EUR
|
|
value: 0.0
|
|
- id: PART-745984-EU
|
|
name: Power Supply EU - V400m
|
|
price:
|
|
currency: EUR
|
|
value: 0.0
|
|
- id: TBOX-V400m-684-EU
|
|
name: V400m Package
|
|
description: Includes an EU Power Supply, SIM Card and battery
|
|
price:
|
|
currency: EUR
|
|
value: 0.0
|
|
itemsIncluded:
|
|
- Receipt Roll
|
|
- Terminal Device V400m EU/GB
|
|
get-companies-companyId-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
|
|
passcodes:
|
|
adminMenuPin: '1234'
|
|
txMenuPin: '1234'
|
|
screenLockPin: '1234'
|
|
storeAndForward:
|
|
maxAmount:
|
|
- amount: 10000
|
|
currencyCode: EUR
|
|
maxPayments: 10
|
|
supportedCardTypes:
|
|
credit: true
|
|
debit: true
|
|
deferredDebit: true
|
|
prepaid: true
|
|
unknown: false
|
|
terminalInstructions:
|
|
adyenAppRestart: true
|
|
get-companies-companyId-webhooks-get-company-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/companies/YOUR_COMPANY_ACCOUNT/webhooks?pageNumber=1&pageSize=10
|
|
last:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/webhooks?pageNumber=1&pageSize=10
|
|
self:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/webhooks?pageNumber=1&pageSize=10
|
|
itemsTotal: 1
|
|
pagesTotal: 1
|
|
data:
|
|
- id: S2-4A3B33202A46
|
|
type: standard
|
|
url: YOUR_WEBHOOK_URL
|
|
description: Webhook for YOUR_COMPANY_ACCOUNT - YOUR_COMPANY_CODE
|
|
filterMerchantAccountType: allAccounts
|
|
username: adyen
|
|
hasPassword: true
|
|
active: true
|
|
hasError: false
|
|
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/companies/YOUR_COMPANY_ACCOUNT/webhooks/S2-4A3B33202A46
|
|
company:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT
|
|
generateHmac:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/webhooks/S2-4A3B33202A46/generateHmac
|
|
testWebhook:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/webhooks/S2-4A3B33202A46/test
|
|
get-companies-companyId-webhooks-webhookId-get-company-webhook-200:
|
|
summary: OK 200 - Get a webhook configuration
|
|
description: Example response for getting a webhook configuration.
|
|
value:
|
|
id: S2-4A3B33202A46
|
|
type: standard
|
|
url: YOUR_WEBHOOK_URL
|
|
description: Webhook for YOUR_COMPANY_ACCOUNT - YOUR_COMPANY_CODE
|
|
filterMerchantAccountType: allAccounts
|
|
username: adyen
|
|
hasPassword: true
|
|
active: true
|
|
hasError: false
|
|
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/companies/YOUR_COMPANY_ACCOUNT/webhooks/S2-4A3B33202A46
|
|
company:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT
|
|
generateHmac:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/webhooks/S2-4A3B33202A46/generateHmac
|
|
testWebhook:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/webhooks/S2-4A3B33202A46/test
|
|
get-companies-success-200:
|
|
summary: List of company accounts
|
|
description: Example response when your API credential has access to one company
|
|
account.
|
|
value:
|
|
_links:
|
|
first:
|
|
href: https://management-test.adyen.com/v1/companies?pageNumber=1&pageSize=10
|
|
last:
|
|
href: https://management-test.adyen.com/v1/companies?pageNumber=1&pageSize=10
|
|
self:
|
|
href: https://management-test.adyen.com/v1/companies?pageNumber=1&pageSize=10
|
|
itemsTotal: 1
|
|
pagesTotal: 1
|
|
data:
|
|
- id: YOUR_COMPANY_ACCOUNT
|
|
name: YOUR_COMPANY_NAME
|
|
status: Active
|
|
dataCenters:
|
|
- name: default
|
|
livePrefix: ''
|
|
_links:
|
|
self:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT
|
|
apiCredentials:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials
|
|
users:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/users
|
|
webhooks:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/webhooks
|
|
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
|
|
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
|
|
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
|
|
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 \u2014 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
|
|
- 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
|
|
- 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
|
|
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
|
|
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
|
|
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-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
|
|
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-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
|
|
passcodes:
|
|
adminMenuPin: '1234'
|
|
txMenuPin: '1234'
|
|
screenLockPin: '1234'
|
|
storeAndForward:
|
|
maxAmount:
|
|
- amount: 10000
|
|
currencyCode: EUR
|
|
maxPayments: 10
|
|
supportedCardTypes:
|
|
credit: true
|
|
debit: true
|
|
deferredDebit: true
|
|
prepaid: true
|
|
unknown: false
|
|
terminalInstructions:
|
|
adyenAppRestart: true
|
|
get-merchants-merchantId-stores-storeId-success-200:
|
|
summary: Response code - 200 OK
|
|
description: Example response when getting the details of a store
|
|
value:
|
|
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: '+13123456789'
|
|
reference: Springfield Shop
|
|
status: active
|
|
_links:
|
|
self:
|
|
href: https://management-test.adyen.com/v1/stores/ST322LJ223223K5F4SQNR9XL5
|
|
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: '+13123456789'
|
|
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
|
|
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
|
|
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-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-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-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
|
|
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.0
|
|
- id: PART-175746-EU
|
|
name: Adyen Test Card
|
|
price:
|
|
currency: EUR
|
|
value: 0.0
|
|
- id: PART-327486-EU
|
|
name: Battery - V400m
|
|
price:
|
|
currency: EUR
|
|
value: 0.0
|
|
- id: PART-287001-EU
|
|
name: Bluetooth Charging Base - V400m
|
|
price:
|
|
currency: EUR
|
|
value: 0.0
|
|
- id: PART-745984-EU
|
|
name: Power Supply EU - V400m
|
|
price:
|
|
currency: EUR
|
|
value: 0.0
|
|
- id: TBOX-V400m-684-EU
|
|
name: V400m Package
|
|
description: Includes an EU Power Supply, SIM Card and battery
|
|
price:
|
|
currency: EUR
|
|
value: 0.0
|
|
itemsIncluded:
|
|
- Receipt Roll
|
|
- Terminal Device V400m EU/GB
|
|
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
|
|
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
|
|
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-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
|
|
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
|
|
get-stores-storeId-success-200:
|
|
summary: Response code - 200 OK
|
|
description: Example response when getting the details of a store
|
|
value:
|
|
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: '+13123456789'
|
|
reference: Springfield Shop
|
|
status: active
|
|
_links:
|
|
self:
|
|
href: https://management-test.adyen.com/v1/stores/ST322LJ223223K5F4SQNR9XL5
|
|
get-stores-storeId-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-stores-storeId-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
|
|
passcodes:
|
|
adminMenuPin: '1234'
|
|
txMenuPin: '1234'
|
|
screenLockPin: '1234'
|
|
storeAndForward:
|
|
maxAmount:
|
|
- amount: 10000
|
|
currencyCode: EUR
|
|
maxPayments: 10
|
|
supportedCardTypes:
|
|
credit: true
|
|
debit: true
|
|
deferredDebit: true
|
|
prepaid: true
|
|
unknown: false
|
|
terminalInstructions:
|
|
adyenAppRestart: true
|
|
get-stores-success-200:
|
|
summary: Response code - 200 OK
|
|
description: Example response when getting a list of stores
|
|
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: '+1312345678'
|
|
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
|
|
get-terminals-success-200:
|
|
summary: List of terminals
|
|
description: Example response when getting terminals that your API credential
|
|
has access to.
|
|
value:
|
|
_links:
|
|
first:
|
|
href: https://management-test.adyen.com/v3/terminals?pageNumber=1&pageSize=20
|
|
last:
|
|
href: https://management-test.adyen.com/v3/terminals?pageNumber=1&pageSize=20
|
|
next:
|
|
href: https://management-test.adyen.com/v3/terminals?pageNumber=1&pageSize=20
|
|
self:
|
|
href: https://management-test.adyen.com/v3/terminals?pageNumber=0&pageSize=20
|
|
itemsTotal: 1
|
|
pagesTotal: 1
|
|
data:
|
|
- id: AMS1-000150183300032
|
|
model: AMS1
|
|
serialNumber: 000150183300032
|
|
firmwareVersion: Castles_Android 1.89.4
|
|
assignment:
|
|
companyId: YOUR_COMPANY_ACCOUNT
|
|
merchantId: YOUR_MERCHANT_ACCOUNT
|
|
storeId: YOUR_STORE_ID
|
|
status: reassignmentInProgress
|
|
reassignmentTarget:
|
|
inventory: true
|
|
connectivity:
|
|
cellular:
|
|
iccid: '6006491286999921374'
|
|
wifi:
|
|
ipAddress: 198.51.100.1
|
|
macAddress: C4:6E:33:26:36:E4
|
|
get-terminals-terminalId-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-terminals-terminalId-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
|
|
notification:
|
|
showButton: true
|
|
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
|
|
restartHour: 5
|
|
passcodes:
|
|
adminMenuPin: '1234'
|
|
txMenuPin: '1234'
|
|
refundPin: '123456'
|
|
screenLockPin: '1234'
|
|
connectivity:
|
|
simcardStatus: INVENTORY
|
|
storeAndForward:
|
|
maxAmount:
|
|
- amount: 10000
|
|
currencyCode: EUR
|
|
maxPayments: 10
|
|
supportedCardTypes:
|
|
credit: true
|
|
debit: true
|
|
deferredDebit: true
|
|
prepaid: true
|
|
unknown: false
|
|
terminalInstructions:
|
|
adyenAppRestart: true
|
|
patch-companies-companyId-apiCredentials-apiCredentialId-patch-company-credential:
|
|
summary: Activate an API credential
|
|
description: Example request for activating an API credential.
|
|
value:
|
|
active: true
|
|
patch-companies-companyId-apiCredentials-apiCredentialId-patch-company-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:
|
|
- Management API - Accounts read
|
|
- Management API - Webhooks read
|
|
- Management API - API credentials read and write
|
|
- Management API - Stores read
|
|
- "Management API \u2014 Payment methods read"
|
|
- Management API - Stores read and write
|
|
- Management API - Webhooks read and write
|
|
- Merchant Recurring role
|
|
- Data Protection API
|
|
- Management API - Payout Account Settings Read
|
|
- Checkout webservice role
|
|
- Management API - Accounts read and write
|
|
- Merchant PAL Webservice role
|
|
active: true
|
|
_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
|
|
company:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT
|
|
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
|
|
associatedMerchantAccounts: []
|
|
patch-companies-companyId-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-companies-companyId-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-companies-companyId-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
|
|
patch-companies-companyId-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
|
|
patch-companies-companyId-terminalOrders-orderId-update-order:
|
|
summary: Update a terminal order
|
|
description: Example request to update an order for terminal products
|
|
value:
|
|
items:
|
|
- id: TBOX-V400m-684-EU
|
|
name: V400m Package
|
|
quantity: 1
|
|
- id: PART-175746-EU
|
|
name: Adyen Test Card
|
|
quantity: 1
|
|
- id: PART-620222-EU
|
|
name: Receipt Roll
|
|
quantity: 5
|
|
patch-companies-companyId-terminalOrders-orderId-update-order-200:
|
|
summary: Response code - 200 OK
|
|
description: Example response after updating an order for terminal products
|
|
value:
|
|
id: '5265677890100681'
|
|
customerOrderReference: YOUR_REFERENCE_1
|
|
status: Placed
|
|
shippingLocation:
|
|
id: S2-7973536B20662642215526704F302044452F714622375D476169
|
|
name: YOUR_COMPANY Rokin depot
|
|
contact:
|
|
firstName: Paul
|
|
lastName: Green
|
|
phoneNumber: +31 020 1234567
|
|
email: Paul.Green@company.com
|
|
address:
|
|
companyName: YOUR_COMPANY
|
|
streetAddress: Rokin 21
|
|
postalCode: 1012 KS
|
|
city: Amsterdam
|
|
stateOrProvince: ''
|
|
country: NL
|
|
billingEntity:
|
|
id: Company.YOUR_COMPANY
|
|
name: YOUR_COMPANY
|
|
taxId: NL1234567890
|
|
email: Paul.Green@company.com
|
|
address:
|
|
streetAddress: Simon Carmiggeltstraat 6-50
|
|
postalCode: 1011 DJ
|
|
city: Amsterdam
|
|
country: NL
|
|
orderDate: '2022-01-20T14:12:33Z'
|
|
items:
|
|
- id: TBOX-V400m-684-EU
|
|
name: V400m Package
|
|
quantity: 1
|
|
- id: PART-175746-EU
|
|
name: Adyen Test Card
|
|
quantity: 1
|
|
- id: PART-620222-EU
|
|
name: Receipt Roll
|
|
quantity: 5
|
|
patch-companies-companyId-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
|
|
patch-companies-companyId-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
|
|
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-companies-companyId-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-companies-companyId-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
|
|
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-companies-companyId-webhooks-webhookId-patch-company-webhook:
|
|
summary: Activate the webhook
|
|
description: Example request for activating a webhook configuration.
|
|
value:
|
|
active: true
|
|
patch-companies-companyId-webhooks-webhookId-patch-company-webhook-200:
|
|
summary: OK 200 - Activate the webhook
|
|
description: Example response for activating a webhook configuration.
|
|
value:
|
|
id: S2-4A3B33202A46
|
|
type: standard
|
|
url: YOUR_WEBHOOK_URL
|
|
description: Webhook for YOUR_COMPANY_ACCOUNT - YOUR_COMPANY_CODE
|
|
filterMerchantAccountType: allAccounts
|
|
username: ''
|
|
hasPassword: false
|
|
active: true
|
|
hasError: false
|
|
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/companies/YOUR_COMPANY_ACCOUNT/webhooks/S2-4A3B33202A46
|
|
company:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT
|
|
generateHmac:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/webhooks/S2-4A3B33202A46/generateHmac
|
|
testWebhook:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/webhooks/S2-4A3B33202A46/test
|
|
patch-merchants-merchantId-apiCredentials-apiCredentialId-patch-merchant-credential:
|
|
summary: Activate an API credential
|
|
description: Example request for activating an API credential.
|
|
value:
|
|
active: true
|
|
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
|
|
patch-merchants-merchantId-paymentMethodSettings-paymentMethodId-update-payment-method:
|
|
summary: Update the currency and country details for a payment method
|
|
description: Update the currency and country details for a payment method
|
|
value:
|
|
currencies:
|
|
- EUR
|
|
countries:
|
|
- NL
|
|
patch-merchants-merchantId-paymentMethodSettings-paymentMethodId-update-payment-method-200:
|
|
summary: Currency and country details updated for the payment method
|
|
description: Currency and country details updated for the payment method
|
|
value:
|
|
mc:
|
|
transactionDescription:
|
|
doingBusinessAsName: YOUR_BUSINESS_NAME
|
|
type: fixed
|
|
id: PM322DZ243226G5LKBTGM7FBQ
|
|
type: mc
|
|
enabled: true
|
|
countries:
|
|
- NL
|
|
currencies:
|
|
- EUR
|
|
customRoutingFlags: []
|
|
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-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-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
|
|
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
|
|
: 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-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
|
|
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-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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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-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-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-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: '+13123456789'
|
|
reference: Spring_store_2
|
|
status: active
|
|
_links:
|
|
self:
|
|
href: https://management-test.adyen.com/v1/stores/YOUR_STORE_ID
|
|
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
|
|
patch-merchants-merchantId-stores-storeId-patch-stores-splitConfiguration-200:
|
|
summary: Split configuration added to store
|
|
description: Example response after adding a split configuration 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: '+13123456789'
|
|
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-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-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
|
|
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
|
|
patch-merchants-merchantId-terminalOrders-orderId-update-order:
|
|
summary: Update a terminal order
|
|
description: Example request to update an order for terminal products
|
|
value:
|
|
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-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: 08012
|
|
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
|
|
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
|
|
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-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-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-webhooks-webhookId-patch-merchant-webhook:
|
|
summary: Activate the webhook
|
|
description: Example request for activating a webhook configuration.
|
|
value:
|
|
active: true
|
|
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
|
|
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
|
|
patch-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-stores-storeId-patch-stores-200:
|
|
summary: Response code - 200 OK
|
|
description: Example response after updating a 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: '+13123456789'
|
|
reference: Spring_store_2
|
|
status: active
|
|
_links:
|
|
self:
|
|
href: https://management-test.adyen.com/v1/stores/YOUR_STORE_ID
|
|
patch-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
|
|
patch-stores-storeId-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-stores-storeId-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-stores-storeId-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
|
|
patch-stores-storeId-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
|
|
patch-stores-storeId-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
|
|
patch-stores-storeId-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
|
|
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-stores-storeId-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-stores-storeId-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
|
|
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-terminals-terminalId-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-terminals-terminalId-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-terminals-terminalId-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
|
|
patch-terminals-terminalId-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
|
|
patch-terminals-terminalId-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
|
|
patch-terminals-terminalId-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
|
|
notification:
|
|
showButton: true
|
|
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
|
|
restartHour: 5
|
|
passcodes:
|
|
adminMenuPin: '1234'
|
|
txMenuPin: '1234'
|
|
refundPin: '123456'
|
|
screenLockPin: '1111'
|
|
connectivity:
|
|
simcardStatus: INVENTORY
|
|
patch-terminals-terminalId-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-terminals-terminalId-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
|
|
notification:
|
|
showButton: true
|
|
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
|
|
restartHour: 5
|
|
passcodes:
|
|
adminMenuPin: '1234'
|
|
txMenuPin: '1234'
|
|
refundPin: '123456'
|
|
screenLockPin: '1111'
|
|
connectivity:
|
|
simcardStatus: INVENTORY
|
|
post-companies-companyId-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-companies-companyId-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/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL/allowedOrigins/YOUR_ALLOWED_ORIGIN
|
|
post-companies-companyId-apiCredentials-post-company-credential:
|
|
summary: Add an API credential
|
|
description: Example request for adding an API credential.
|
|
value:
|
|
roles:
|
|
- Checkout webservice role
|
|
allowedOrigins:
|
|
- https://www.mystore.com
|
|
associatedMerchantAccounts:
|
|
- YOUR_MERCHANT_ACCOUNT_AU
|
|
- YOUR_MERCHANT_ACCOUNT_EU
|
|
- YOUR_MERCHANT_ACCOUNT_US
|
|
post-companies-companyId-apiCredentials-post-company-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
|
|
company:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT
|
|
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
|
|
apiKey: YOUR_API_KEY
|
|
password: YOUR_PASSWORD
|
|
associatedMerchantAccounts:
|
|
- YOUR_MERCHANT_ACCOUNT_AU
|
|
- YOUR_MERCHANT_ACCOUNT_EU
|
|
- YOUR_MERCHANT_ACCOUNT_US
|
|
post-companies-companyId-shippingLocations-create-shipping-location:
|
|
summary: Create a shipping location
|
|
description: Example request to create a shipping location
|
|
value:
|
|
name: YOUR_COMPANY Rokin depot
|
|
address:
|
|
companyName: YOUR_COMPANY
|
|
streetAddress: Rokin 21
|
|
postalCode: 1012 KS
|
|
city: Amsterdam
|
|
stateOrProvince: ''
|
|
country: NL
|
|
contact:
|
|
firstName: Paul
|
|
lastName: Green
|
|
phoneNumber: +31 020 1234567
|
|
email: Paul.Green@company.com
|
|
post-companies-companyId-shippingLocations-create-shipping-location-200:
|
|
summary: Shipping location created
|
|
description: Example response after creating a shipping location
|
|
value:
|
|
id: S2-7973536B20662642215526704F302044452F714622375D476169
|
|
name: YOUR_COMPANY Rokin depot
|
|
contact:
|
|
firstName: Paul
|
|
lastName: Green
|
|
phoneNumber: +31 020 1234567
|
|
email: Paul.Green@company.com
|
|
address:
|
|
companyName: YOUR_COMPANY
|
|
streetAddress: Rokin 21
|
|
postalCode: 1012 KS
|
|
city: Amsterdam
|
|
stateOrProvince: ''
|
|
post-companies-companyId-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: Company.YOUR_COMPANY
|
|
items:
|
|
- id: TBOX-V400m-684-EU
|
|
name: V400m Package
|
|
quantity: 1
|
|
- id: PART-175746-EU
|
|
name: Adyen Test Card
|
|
quantity: 1
|
|
post-companies-companyId-terminalOrders-create-order-200:
|
|
summary: Response code - 200 OK
|
|
description: Example response after creating an order for terminal products
|
|
value:
|
|
id: '5265677890100681'
|
|
customerOrderReference: YOUR_REFERENCE
|
|
status: Placed
|
|
shippingLocation:
|
|
id: S2-232A6D2967356F424F4369432B3F486B6A6D
|
|
name: YOUR_COMPANY HQ - POS Ops
|
|
contact:
|
|
firstName: Paul
|
|
lastName: Green
|
|
email: Paul.Green@company.com
|
|
address:
|
|
streetAddress: Simon Carmiggeltstraat
|
|
streetAddress2: 6-50
|
|
postalCode: 1011 DJ
|
|
city: Amsterdam
|
|
country: NL
|
|
billingEntity:
|
|
id: Company.YOUR_COMPANY
|
|
name: YOUR_COMPANY
|
|
taxId: NL1234567890
|
|
email: Paul.Green@company.com
|
|
address:
|
|
streetAddress: Simon Carmiggeltstraat 6-50
|
|
postalCode: 1011 DJ
|
|
city: Amsterdam
|
|
country: NL
|
|
orderDate: '2022-01-20T14:12:33Z'
|
|
items:
|
|
- id: TBOX-V400m-684-EU
|
|
name: V400m Package
|
|
quantity: 1
|
|
- id: PART-175746-EU
|
|
name: Adyen Test Card
|
|
quantity: 1
|
|
post-companies-companyId-terminalOrders-orderId-cancel-cancel-order-200:
|
|
summary: Terminal order cancelled
|
|
description: Example response after cancelling an order for terminal products
|
|
value:
|
|
id: '5265677890100681'
|
|
customerOrderReference: YOUR_REFERENCE
|
|
status: Cancelled
|
|
shippingLocation:
|
|
id: S2-232A6D2967356F424F4369432B3F486B6A6D
|
|
name: YOUR_COMPANY HQ - POS Ops
|
|
contact:
|
|
firstName: Paul
|
|
lastName: Green
|
|
email: Paul.Green@company.com
|
|
address:
|
|
streetAddress: Simon Carmiggeltstraat
|
|
streetAddress2: 6-50
|
|
postalCode: 1011 DJ
|
|
city: Amsterdam
|
|
country: Netherlands
|
|
billingEntity:
|
|
id: Company.YOUR_COMPANY
|
|
name: YOUR_COMPANY
|
|
taxId: NL1234567890
|
|
email: Paul.Green@company.com
|
|
address:
|
|
streetAddress: Simon Carmiggeltstraat 6-50
|
|
postalCode: 1011 DJ
|
|
city: Amsterdam
|
|
country: Netherlands
|
|
orderDate: '2022-01-20T14:12:33Z'
|
|
items:
|
|
- id: TBOX-V400m-684-EU
|
|
name: V400m Package
|
|
quantity: 1
|
|
- id: PART-175746-EU
|
|
name: Adyen Test Card
|
|
quantity: 1
|
|
post-companies-companyId-users-create-email-user:
|
|
summary: Create a user with email as login method
|
|
description: Example request to create a user with email as login method on
|
|
the company level
|
|
value:
|
|
name:
|
|
firstName: John
|
|
lastName: Smith
|
|
username: johnsmith
|
|
email: john.smith@example.com
|
|
loginMethod: Email
|
|
timeZoneCode: Europe/Amsterdam
|
|
roles:
|
|
- Merchant standard role
|
|
- Merchant admin
|
|
associatedMerchantAccounts:
|
|
- YOUR_MERCHANT_ACCOUNT
|
|
post-companies-companyId-users-create-sso-user:
|
|
summary: Create a user with SSO as login method
|
|
description: Example request to create a with SSO as login method user on the
|
|
company level
|
|
value:
|
|
name:
|
|
firstName: John
|
|
lastName: Smith
|
|
username: johnsmith
|
|
email: john.smith@example.com
|
|
loginMethod: SSO
|
|
timeZoneCode: Europe/Amsterdam
|
|
roles:
|
|
- Merchant standard role
|
|
- Merchant admin
|
|
associatedMerchantAccounts:
|
|
- YOUR_MERCHANT_ACCOUNT
|
|
post-companies-companyId-users-create-user:
|
|
summary: Create a user
|
|
description: Example request to create a user on the company level
|
|
value:
|
|
name:
|
|
firstName: John
|
|
lastName: Smith
|
|
username: johnsmith
|
|
email: john.smith@example.com
|
|
timeZoneCode: Europe/Amsterdam
|
|
roles:
|
|
- Merchant standard role
|
|
- Merchant admin
|
|
associatedMerchantAccounts:
|
|
- YOUR_MERCHANT_ACCOUNT
|
|
post-companies-companyId-users-create-user-200:
|
|
summary: User created on the company level
|
|
description: Example response after creating a user on the company level
|
|
value:
|
|
id: S2-5C334C6770
|
|
name:
|
|
firstName: John
|
|
lastName: Smith
|
|
email: john.smith@example.com
|
|
timeZoneCode: Europe/Amsterdam
|
|
username: johnsmith
|
|
roles:
|
|
- Merchant standard role
|
|
- Merchant admin
|
|
active: true
|
|
_links:
|
|
self:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/users/S2-5C334C6770
|
|
associatedMerchantAccounts:
|
|
- YOUR_MERCHANT_ACCOUNT
|
|
post-companies-companyId-webhooks-post-company-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
|
|
communicationFormat: soap
|
|
acceptsExpiredCertificate: false
|
|
acceptsSelfSignedCertificate: true
|
|
acceptsUntrustedRootCertificate: true
|
|
populateSoapActionHeader: false
|
|
filterMerchantAccountType: includeAccounts
|
|
filterMerchantAccounts:
|
|
- YOUR_MERCHANT_ACCOUNT
|
|
post-companies-companyId-webhooks-post-company-webhook-200:
|
|
summary: OK 200 - Add a webhook configuration
|
|
description: Example response for adding a webhook configuration.
|
|
value:
|
|
id: S2-6933523D2772
|
|
type: standard
|
|
url: YOUR_WEBHOOK_URL
|
|
description: Webhook for YOUR_COMPANY_ACCOUNT - YOUR_COMPANY_CODE
|
|
filterMerchantAccountType: includeAccounts
|
|
filterMerchantAccounts:
|
|
- YOUR_MERCHANT_ACCOUNT
|
|
username: myuser
|
|
hasPassword: true
|
|
active: true
|
|
hasError: false
|
|
communicationFormat: soap
|
|
acceptsExpiredCertificate: false
|
|
acceptsSelfSignedCertificate: true
|
|
acceptsUntrustedRootCertificate: true
|
|
certificateAlias: signed-test.adyen.com_2024
|
|
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/companies/YOUR_COMPANY_ACCOUNT/webhooks/S2-6933523D2772
|
|
company:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT
|
|
generateHmac:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/webhooks/S2-6933523D2772/generateHmac
|
|
testWebhook:
|
|
href: https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/webhooks/S2-6933523D2772/test
|
|
post-companies-companyId-webhooks-webhookId-generateHmac-post-company-webhook-generateHmac-200:
|
|
summary: OK 200 - Generate a webhook HMAC key
|
|
description: Example response for generating a webhook HMAC.
|
|
value:
|
|
hmacKey: 7052E6804F0AF40DCC390464C817F4F963516FA42AC8816D518DC5D39F41E902
|
|
post-companies-companyId-webhooks-webhookId-test-post-company-webhook-test:
|
|
summary: Test a webhook event
|
|
description: Example request for testing a webhook event.
|
|
value:
|
|
merchantIds:
|
|
- YOUR_MERCHANT_ACCOUNT
|
|
types:
|
|
- AUTHORISATION
|
|
post-companies-companyId-webhooks-webhookId-test-post-company-webhook-test-200:
|
|
summary: OK 200 - Test a webhook event
|
|
description: Example response for testing a webhook event.
|
|
value:
|
|
data:
|
|
- merchantId: YOUR_MERCHANT_ACCOUNT_AU
|
|
output: ''
|
|
requestSent: '{"live":"false","notificationItems":[{"NotificationRequestItem":{"amount":{"currency":"EUR","value":100},"eventCode":"AUTHORISATION","eventDate":"2022-05-10T16:57:19+02:00","merchantAccountCode":"YOUR_MERCHANT_ACCOUNT_AU","merchantReference":"6GZBF5ML","operations":["CANCEL","CAPTURE","REFUND"],"paymentMethod":"visa","pspReference":"KDN7UP7S1JIK6XES","reason":"","success":"true"}}]}'
|
|
responseCode: '200'
|
|
responseTime: 657 ms
|
|
status: success
|
|
post-companies-companyId-webhooks-webhookId-test-post-company-webhook-test-custom:
|
|
summary: Test a custom webhook event
|
|
description: Example request for testing a custom webhook event.
|
|
value:
|
|
notification:
|
|
paymentMethod: visa
|
|
eventCode: AUTHORISATION
|
|
amount:
|
|
currency: EUR
|
|
value: 2000
|
|
reason: Authorize visa payment
|
|
success: true
|
|
types:
|
|
- CUSTOM
|
|
merchantIds:
|
|
- YOUR_MERCHANT_ACCOUNT_AU
|
|
- YOUR_MERCHANT_ACCOUNT_EU
|
|
- YOUR_MERCHANT_ACCOUNT_US
|
|
post-companies-companyId-webhooks-webhookId-test-post-company-webhook-test-custom-200:
|
|
summary: OK 200 - Test a custom webhook event
|
|
description: Example response for testing a custom webhook event.
|
|
value:
|
|
data:
|
|
- merchantId: YOUR_MERCHANT_ACCOUNT_AU
|
|
output: ''
|
|
requestSent: '{"live":"false","notificationItems":[{"NotificationRequestItem":{"amount":{"currency":"EUR","value":100},"eventCode":"AUTHORISATION","eventDate":"2022-05-10T16:57:19+02:00","merchantAccountCode":"YOUR_MERCHANT_ACCOUNT_AU","merchantReference":"6GZBF5ML","operations":["CANCEL","CAPTURE","REFUND"],"paymentMethod":"visa","pspReference":"KDN7UP7S1JIK6XES","reason":"","success":"true"}}]}'
|
|
responseCode: '200'
|
|
responseTime: 657 ms
|
|
status: success
|
|
- merchantId: YOUR_MERCHANT_ACCOUNT_EU
|
|
output: ''
|
|
requestSent: '{"live":"false","notificationItems":[{"NotificationRequestItem":{"amount":{"currency":"EUR","value":100},"eventCode":"AUTHORISATION","eventDate":"2022-05-10T16:57:19+02:00","merchantAccountCode":"YOUR_MERCHANT_ACCOUNT_EU","merchantReference":"6GZBF5ML","operations":["CANCEL","CAPTURE","REFUND"],"paymentMethod":"visa","pspReference":"KDN7UP7S1JIK6XES","reason":"","success":"true"}}]}'
|
|
responseCode: '200'
|
|
responseTime: 590 ms
|
|
status: success
|
|
- merchantId: YOUR_MERCHANT_ACCOUNT_US
|
|
output: ''
|
|
requestSent: '{"live":"false","notificationItems":[{"NotificationRequestItem":{"amount":{"currency":"EUR","value":100},"eventCode":"AUTHORISATION","eventDate":"2022-05-10T16:57:19+02:00","merchantAccountCode":"YOUR_MERCHANT_ACCOUNT_US","merchantReference":"6GZBF5ML","operations":["CANCEL","CAPTURE","REFUND"],"paymentMethod":"visa","pspReference":"KDN7UP7S1JIK6XES","reason":"","success":"true"}}]}'
|
|
responseCode: '200'
|
|
responseTime: 248 ms
|
|
status: success
|
|
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-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:
|
|
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
|
|
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-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
|
|
post-merchants-merchantId-paymentMethodSettings-add-payment-method:
|
|
summary: Request a payment method
|
|
description: Example request to add a payment method
|
|
value:
|
|
type: visa
|
|
currencies:
|
|
- USD
|
|
countries:
|
|
- US
|
|
post-merchants-merchantId-paymentMethodSettings-add-payment-method-200:
|
|
summary: Response code - 200 OK
|
|
description: Example response after sending a request to add a payment method
|
|
value:
|
|
id: PM3227C223224K5FH84M8CBNH
|
|
type: visa
|
|
countries:
|
|
- US
|
|
currencies:
|
|
- USD
|
|
post-merchants-merchantId-paymentMethodSettings-add-payment-method-partner-model:
|
|
summary: Request to add Swish
|
|
description: Example request to add Swish with a partner model setup
|
|
value:
|
|
businessLineId: BL322KV223222D5F8H2J4BQ6C
|
|
type: swish
|
|
swish:
|
|
swishNumber: '1231111111'
|
|
currencies:
|
|
- SEK
|
|
countries:
|
|
- SE
|
|
post-merchants-merchantId-paymentMethodSettings-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
|
|
type: swish
|
|
countries:
|
|
- SE
|
|
currencies:
|
|
- SEK
|
|
swish:
|
|
swishNumber: '1231111111'
|
|
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
|
|
post-merchants-merchantId-paymentMethodSettings-paymentMethodId-addApplePayDomains-add-applepay-domain-202:
|
|
summary: Apple Pay domain requested - 202 OK
|
|
description: Example response after sending a request to add an Apple Pay domain
|
|
value:
|
|
domains:
|
|
- https://example.com
|
|
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: 08012
|
|
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: 08012
|
|
city: Barcelona
|
|
stateOrProvince: ''
|
|
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
|
|
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
|
|
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-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
|
|
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: '13123456789'
|
|
reference: Spring_store_2
|
|
address:
|
|
country: US
|
|
line1: 200 Main Street
|
|
line2: Building 5A
|
|
line3: Suite 3
|
|
city: Springfield
|
|
stateOrProvince: NY
|
|
postalCode: '20250'
|
|
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: '13123456789'
|
|
reference: Spring_store_2
|
|
status: active
|
|
_links:
|
|
self:
|
|
href: https://management-test.adyen.com/v1/stores/YOUR_STORE_ID
|
|
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
|
|
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-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
|
|
post-merchants-merchantId-users-create-email-user:
|
|
summary: Create a user with email as login method
|
|
description: Example request to create a user with email as login method on
|
|
the merchant level
|
|
value:
|
|
name:
|
|
firstName: John
|
|
lastName: Smith
|
|
username: johnsmith
|
|
email: john.smith@example.com
|
|
loginMethod: Email
|
|
timeZoneCode: Europe/Amsterdam
|
|
roles:
|
|
- Merchant standard role
|
|
post-merchants-merchantId-users-create-sso-user:
|
|
summary: Create a user with SSO as login method
|
|
description: Example request to create a user with SSO as login method on the
|
|
merchant level
|
|
value:
|
|
name:
|
|
firstName: John
|
|
lastName: Smith
|
|
username: johnsmith
|
|
email: john.smith@example.com
|
|
loginMethod: SSO
|
|
timeZoneCode: Europe/Amsterdam
|
|
roles:
|
|
- Merchant standard role
|
|
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
|
|
post-merchants-merchantId-users-create-user-200:
|
|
summary: User created on the merchant level
|
|
description: Example response after creating a user on the merchant level
|
|
value:
|
|
id: S2-3B3C3C3B22
|
|
name:
|
|
firstName: John
|
|
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
|
|
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
|
|
communicationFormat: json
|
|
acceptsExpiredCertificate: false
|
|
acceptsSelfSignedCertificate: true
|
|
acceptsUntrustedRootCertificate: true
|
|
populateSoapActionHeader: false
|
|
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
|
|
communicationFormat: json
|
|
acceptsExpiredCertificate: false
|
|
acceptsSelfSignedCertificate: true
|
|
acceptsUntrustedRootCertificate: true
|
|
certificateAlias: signed-test.adyen.com_2024
|
|
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-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:
|
|
summary: Test a custom webhook event
|
|
description: Example request for testing a custom webhook event.
|
|
value:
|
|
types:
|
|
- AUTHORISATION
|
|
post-merchants-merchantId-webhooks-webhookId-test-post-merchant-webhook-test-200:
|
|
summary: OK 200 - Test a webhook event
|
|
description: Example response for testing a webhook event.
|
|
value:
|
|
data:
|
|
- merchantId: YOUR_MERCHANT_ACCOUNT
|
|
output: ''
|
|
requestSent: '{"live":"false","notificationItems":[{"NotificationRequestItem":{"amount":{"currency":"EUR","value":21000},"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
|
|
post-merchants-merchantId-webhooks-webhookId-test-post-merchant-webhook-test-custom:
|
|
summary: Test a custom webhook event
|
|
description: Example request for testing a custom webhook event.
|
|
value:
|
|
notification:
|
|
paymentMethod: visa
|
|
eventCode: AUTHORISATION
|
|
amount:
|
|
currency: HUF
|
|
value: 1000
|
|
reason: Authorize visa payment
|
|
success: true
|
|
types:
|
|
- CUSTOM
|
|
post-merchants-merchantId-webhooks-webhookId-test-post-merchant-webhook-test-custom-200:
|
|
summary: OK 200 - Test a webhook event
|
|
description: Example response for testing a webhook event.
|
|
value:
|
|
data:
|
|
- merchantId: YOUR_MERCHANT_ACCOUNT
|
|
output: ''
|
|
requestSent: '{"live":"false","notificationItems":[{"NotificationRequestItem":{"amount":{"currency":"HUF","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
|
|
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
|
|
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
|
|
post-stores-post-stores:
|
|
summary: Create a store
|
|
description: Example request to create a store
|
|
value:
|
|
merchantId: YOUR_MERCHANT_ACCOUNT_ID
|
|
description: City centre store
|
|
shopperStatement: Springfield Shop
|
|
phoneNumber: '+13123456789'
|
|
reference: Spring_store_2
|
|
address:
|
|
country: US
|
|
line1: 200 Main Street
|
|
line2: Building 5A
|
|
line3: Suite 3
|
|
city: Springfield
|
|
stateOrProvince: NY
|
|
postalCode: '20250'
|
|
post-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: '+13123456789'
|
|
reference: Spring_store_2
|
|
status: active
|
|
_links:
|
|
self:
|
|
href: https://management-test.adyen.com/v1/stores/YOUR_STORE_ID
|
|
post-terminals-scheduleActions-install-app:
|
|
summary: Schedule installing an Android app
|
|
description: Example request to schedule installing an Android app
|
|
value:
|
|
terminalIds:
|
|
- S1E-000150183300032
|
|
- S1E-000150183300033
|
|
- S1F2-000150183300034
|
|
storeId: ''
|
|
scheduledAt: 2021-12-12T20:21:22-0100
|
|
actionDetails:
|
|
type: InstallAndroidApp
|
|
appId: ANDA422LZ223223K5F694GCCF732K8
|
|
post-terminals-scheduleActions-install-app-200:
|
|
summary: Response code - 200 OK
|
|
description: Example response after scheduling the installation of an Android
|
|
app
|
|
value:
|
|
actionDetails:
|
|
appId: ANDA422LZ223223K5F694GCCF732K8
|
|
type: InstallAndroidApp
|
|
scheduledAt: 2021-12-12T20:21:22-0100
|
|
storeId: ''
|
|
items:
|
|
- id: TRAC422T2223223K5GFMQHM6WQ4KB6
|
|
terminalId: S1E-000150183300032
|
|
- id: TRAC4224X22338VQ5GD4CQJCQT5PC2
|
|
terminalId: S1E-000150183300033
|
|
- id: TRAC4224Z223223K5GD89RLBWQ6CWT
|
|
terminalId: S1F2-000150183300034
|
|
terminalsWithErrors: {}
|
|
totalScheduled: 3
|
|
totalErrors: 0
|
|
post-terminals-scheduleActions-uninstall-cert:
|
|
summary: Schedule uninstalling an Android certificate
|
|
description: Example request to schedule uninstalling an Android certificate
|
|
value:
|
|
terminalIds:
|
|
- S1E-000150183300032
|
|
- S1E-000150183300033
|
|
- S1F2-000150183300034
|
|
storeId: ''
|
|
scheduledAt: 2021-12-12T20:21:22-0100
|
|
actionDetails:
|
|
type: UninstallAndroidCertificate
|
|
certificateId: ANDC422LZ223223K5F78NVN9SL4VPH
|
|
post-terminals-scheduleActions-uninstall-cert-200:
|
|
summary: Response code - 200 OK
|
|
description: Example response after scheduling the removal of an Android certificate
|
|
value:
|
|
actionDetails:
|
|
certificateId: ANDC422LZ223223K5F78NVN9SL4VPH
|
|
type: UninstallAndroidCertificate
|
|
scheduledAt: 2021-12-12T20:21:22-0100
|
|
storeId: ''
|
|
items:
|
|
- id: TRAC422T2223223K5GFMQHM6WQ4KB6
|
|
terminalId: S1E-000150183300032
|
|
- id: TRAC4224X22338VQ5GD4CQJCQT5PC2
|
|
terminalId: S1E-000150183300033
|
|
- id: TRAC4224Z223223K5GD89RLBWQ6CWT
|
|
terminalId: S1F2-000150183300034
|
|
terminalsWithErrors: {}
|
|
totalScheduled: 3
|
|
totalErrors: 0
|
|
post-terminals-scheduleActions-verification-error:
|
|
summary: Invalid terminal ID in the request
|
|
description: Example request to see what validation errors look like
|
|
value:
|
|
terminalIds:
|
|
- S1E-000150183300032
|
|
- S1E-000150183300033
|
|
- S1F2-000150183300034
|
|
storeId: ''
|
|
scheduledAt: 2021-12-11T20:21:22-0100
|
|
actionDetails:
|
|
type: InstallAndroidApp
|
|
appId: ANDA422LZ223223K5F694GCCF621J7
|
|
post-terminals-scheduleActions-verification-error-422:
|
|
summary: Response code - 422 Unprocessable Entity
|
|
description: Example response for failed verification of terminal IDs
|
|
value:
|
|
type: https://docs.adyen.com/errors/unprocessable-entity
|
|
errorCode: '02_005'
|
|
title: Terminal ID verification failed.
|
|
status: 422
|
|
detail: Terminal IDs are empty
|
|
post-terminals-terminalId-reassign-post-terminals-terminalId-reassign-merchant:
|
|
summary: Reassign a terminal to your merchant account
|
|
description: Example request to reassign terminal to your merchant account
|
|
value:
|
|
merchantId: YOUR_MERCHANT_ID
|
|
inventory: false
|
|
post-terminals-terminalId-reassign-post-terminals-terminalId-reassign-store:
|
|
summary: Reassign a terminal to your store
|
|
description: Example request to reassign terminal to your store
|
|
value:
|
|
storeId: YOUR_STORE_ID
|