{"id":"09bd7169-20e6-4a87-a901-cdb10e7bab29","task":"Use the Adyen Management API to create and configure a merchant account","domain":"docs.adyen.com","steps":["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"],"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"],"contributor":"waymark-seed","created":"2026-06-13T16:28:50Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:41:57.021Z"},"url":"https://mcp.waymark.network/r/09bd7169-20e6-4a87-a901-cdb10e7bab29"}