Sign in

v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-131362831.1 MB
Account - merchant level

Create a merchant account

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
post/merchants

Request body

businessLineIdstring

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

companyIdstring required

The unique identifier of the company account.

descriptionstring

Your description for the merchant account, maximum 300 characters.

legalEntityIdstring

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

pricingPlanstring

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.

referencestring

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.

salesChannelsstring[]

List of sales channels that the merchant will process payments with

Response

OK - the request has succeeded.

businessLineIdstring

The unique identifier of the business line.

companyIdstring

The unique identifier of the company account.

descriptionstring

Your description for the merchant account, maximum 300 characters.

idstring

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.

legalEntityIdstring

The unique identifier of the legal entity.

pricingPlanstring

Partner pricing plan for the merchant, applicable for merchants under AfP managed company accounts.

referencestring

Your reference for the merchant account.