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

Get a merchant account

GET
/merchants/{merchantId}

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:

  • Management API—Account read

Authorization

AuthorizationBasic <token>

In: header

Path Parameters

merchantId*string

The unique identifier of the merchant account.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/merchants/string"

Example response with details of the merchant account

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

Create a merchant account POST

Creates a merchant account for the company account specified in the request. Use this endpoint if your integration requires it, such as Adyen for Platforms Manage. Your Adyen contact will set up your access. To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Accounts read and write

Request to activate a merchant account POST

Sends a request to activate the merchant account identified in the path. You get the result of the activation asynchronously through a [`merchant.updated`](https://docs.adyen.com/api-explorer/ManagementNotification/latest/post/merchant.updated) webhook. Once the merchant account is activated, you can start using it to accept payments and payouts. Use this endpoint if your integration requires it, such as Adyen for Platforms Manage. Your Adyen contact will set up your access. To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Accounts read and write