{"title":"Activate merchant account","category":"default","creationDate":1684770360,"content":"
\n

If you onboarded your users in Essentials<\/a>, the configurations described on this page are done automatically according to the setup you previously agreed on with your Adyen contact.<\/p>\n<\/div>\n

If you onboarded your users through Adyen's hosted onboarding page<\/a> or chose the API onboarding<\/a> option, you must configure and activate the created merchant accounts.<\/p>\n

Step 1: Configure payment methods<\/h2>\n

For the initial setup or when your users want to offer a new payment method to their customers, they must contact you to add that payment method to their merchant account.<\/p>\n

To request adding a payment method to your user's store, make a POST \/paymentMethodSettings<\/a> request with your user's merchant account in the path. In your request, specify:<\/p>\n\n\n\n\n\n\n\n\n\n
Parameter<\/th>\nRequired<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
type<\/a><\/td>\n\"-white_check_mark-\"<\/td>\nPayment method type<\/a>. Some payment methods require an additional object with payment method details.<\/td>\n<\/td>\n<\/tr>\n
businessLineId<\/a><\/td>\n\"-white_check_mark-\"<\/td>\nThe unique identifier of your user's business line that you want to request a payment method for.<\/td>\n<\/td>\n<\/tr>\n
storeIds<\/a><\/td>\n<\/td>\nThe id<\/code> of the store that you get when creating a store.<\/td>\n<\/tr>\n
countries<\/a><\/td>\n<\/td>\nThe list of countries to enable with the payment method. To enable all countries supported by the payment method, set to ANY<\/strong><\/span> or send empty.<\/td>\n<\/tr>\n
currencies<\/a><\/td>\n<\/td>\nThe list of currencies to enable with the payment method. To enable all currencies supported by the payment method, set to ANY<\/strong><\/span> or send empty.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\n

Some payment methods require additional parameters. Make sure to collect this information from your users before adding the payment method.<\/p>\n<\/div>\n

After a payment method is successfully added to the merchant account, you will receive a paymentMethod.created<\/a> webhook.<\/p>\n

The following example shows the notification you receive after adding visa<\/code> payment method to a merchant account.<\/p>\n

\n <\/code-sample>\n<\/div>\n

Step 2 (Optional): Get the bank account details<\/h2>\n

If you collected your user's information through the hosted onboarding page<\/a>, you must send an API request to query the ID of their transfer instrument. The transfer instrument resource is created automatically when your user enters their bank account details. You will need this ID to enable payouts for your user.<\/p>\n

To get the ID of the transfer instrument, send a GET \/legalEntities\/{id}<\/a> request, specifying the ID of the main legal entity in the path.<\/p>\n

The response contains the transferInstruments.id<\/a> resource.<\/p>\n

\n <\/code-sample>\n<\/div>\n

Step 3: Enable payouts<\/h2>\n
\n

Before you enable payouts, make sure that the sendToTransferInstrument<\/code> capability is allowed<\/strong><\/span> for the merchant account. You can find this information in the merchant.updated<\/a> webhook you receive after your user submits their verification data, or in the response for the GET \/legalEntities\/{id}<\/a> request.<\/p>\n<\/div>\n

To enable payouts for your user, make a \/merchants\/{merchantId}\/payoutSettings<\/a> call with the merchant account's ID in the path, and specifying the following in the body of the request:<\/p>\n\n\n\n\n\n\n\n
Parameter<\/th>\nRequired<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
enabled<\/a><\/td>\n<\/td>\nSet to true<\/strong><\/span>.<\/td>\n<\/tr>\n
enabledFromDate<\/a><\/td>\n<\/td>\nThe date when Adyen starts paying out to this bank account.<\/td>\n<\/tr>\n
transferInstrumentId<\/a><\/td>\n\"-white_check_mark-\"<\/td>\nThe unique identifier of the transfer instrument that contains the details of the bank account.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\n <\/code-sample>\n<\/div>\n

Step 4: Activate merchant account<\/h2>\n

You can decide when to activate your user's merchant account depending on your onboarding flow. For the fastest process, request activation after you create the account and configure payment methods<\/a>. Make a POST \/merchants\/{merchantId}\/activate<\/a> call, specifying the merchant account ID in the path.<\/p>\n

The account is then activated when:<\/p>\n