APIMatic Adyen APIs
Sign Up to APIMatic
HomeSDKsAPI ReferenceContext Plugin
ManagementAccountAccount merchant level

Create a merchant account

POST
/merchants

Creates a merchant account for the company account specified in the request.

Use this endpoint if your integration requires it, such as Adyen for Platforms Manage. Your Adyen contact will set up your access.

To make this request, your API credential must have the following roles:

  • Management API—Accounts read and write

Authorization

AuthorizationBasic <token>

In: header

Request Body

application/json

businessLineId?string

The unique identifier of the business line. Required for an Adyen for Platforms Manage integration.

companyId*string

The unique identifier of the company account.

description?string

Your description for the merchant account, maximum 300 characters.

Lengthlength <= 300
legalEntityId?string

The unique identifier of the legal entity. Required for an Adyen for Platforms Manage integration.

pricingPlan?string

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.

reference?string

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.

salesChannels?array<string>

List of sales channels that the merchant will process payments with

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/merchants" \  -H "Content-Type: application/json" \  -d '{    "companyId": "YOUR_COMPANY_ACCOUNT",    "legalEntityId": "YOUR_LEGAL_ENTITY_ID",    "businessLineId": "YOUR_BUSINESS_LINE_ID",    "description": "YOUR_DESCRIPTION",    "reference": "YOUR_OWN_REFERENCE"  }'

Example response for creating a merchant account

{  "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"}

Get a list of merchant accounts GET

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. To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Account read

Get a merchant account GET

Returns the merchant account specified in the path. Your API credential must have access to the merchant account. To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Account read