Authenticate with an API key that has the Management API role and target the Management API base URL (distinct from the Checkout and Payments base URLs)
POST to /v3/merchants to create a new merchant account under your company account, supplying legalEntityId, businessLineId, and the desired reference name
Poll GET /v3/merchants/{merchantId} until the status transitions from PreActive to Active — this reflects Adyen's internal provisioning and may take minutes
Configure payment method settings by POSTing to /v3/merchants/{merchantId}/paymentMethodSettings with the desired payment method and country/currency combinations
Set notification webhook URLs via POST /v3/merchants/{merchantId}/webhooks to direct payment and payout notifications to your endpoint
Known gotchas
The Management API uses its own versioned base URL (management-test.adyen.com or management-live.adyen.com) and is not the same host as the Checkout or Payments API
Merchant account creation requires a legalEntityId from the Legal Entity Management API; you cannot create a merchant without a verified legal entity attached
Payment method enablement via the Management API requires that the method is already contracted at the company account level; requesting an uncontricted method returns a 422 validation error
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp