Sign in

v50

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

Get a merchant account

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
get/merchants/{merchantId}

Path parameters

merchantIdstring required

The unique identifier of the merchant account.

Response

OK - the request has succeeded.

captureDelaystring

The capture delay set for the merchant account.

Possible values:

  • Immediate
  • Manual
  • Number of days from 1 to 29
companyIdstring

The unique identifier of the company account this merchant belongs to

defaultShopperInteractionstring

The default shopperInteraction value used when processing payments through this merchant account.

descriptionstring

Your description for the merchant account, maximum 300 characters

idstring

The unique identifier of the merchant account.

merchantCitystring

The city where the legal entity of this merchant account is registered.

namestring

The name of the legal entity associated with the merchant account.

pricingPlanstring

Only applies to merchant accounts managed by Adyen's partners. The name of the pricing plan assigned to the merchant account.

primarySettlementCurrencystring

The currency of the country where the legal entity of this merchant account is registered. Format: ISO currency code. For example, a legal entity based in the United States has USD as the primary settlement currency.

referencestring

Reference of the merchant account.

shopWebAddressstring

The URL for the ecommerce website used with this merchant account.

statusstring

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.