{"title":"Onboard sellers","category":"default","creationDate":1776961628,"content":"<p>Each seller you add to your Mirakl marketplace goes through a KYC verification for their onboarding. The connector supports sellers that offer products, services, or both.<\/p>\n<p>If a seller has multiple shops to accept payments in different currencies, each shop is treated as a separate legal entity by Adyen. Therefore, each shop needs to be onboarded separately.<\/p>\n<h2>How it works<\/h2>\n<ol>\n<li>You add a seller to your Mirakl marketplace.\n<ul>\n<li>The seller is required to provide the following information to create the legal entity in Adyen. The data provided must match the <a href=\"\/pt\/marketplaces\/verification-requirements\/data-formats-per-country\">data format per country\/region<\/a>, for the country\/region where the seller is based.\n<ul>\n<li>Email<\/li>\n<li>Company name (<code>legalBusinessName<\/code>)<\/li>\n<\/ul><\/li>\n<li>When address is provided, it must include the following fields:\n<ul>\n<li>City<\/li>\n<li>Country\/region<\/li>\n<li>Postal code<\/li>\n<li>Street<\/li>\n<li>State or Province (only required if the address is in the US or Canada)<\/li>\n<\/ul><\/li>\n<li>When bank account is provided, it must include the following fields:\n<ul>\n<li>Currency code<\/li>\n<li>Owner name<\/li>\n<li>Country code<\/li>\n<li>IBAN<\/li>\n<\/ul><\/li>\n<\/ul><\/li>\n<li>The connector submits the seller's information to Adyen in a <a href=\"\/pt\/marketplaces\/onboard-users\/onboarding-steps\">\n  <code>\/legalEntities<\/code>\n<\/a> request.<\/li>\n<li>With the next sync, the Hosted Onboarding Page (HOP) link is created and the seller can access it in Mirakl.<br \/>\nTo check if a link was created successfully:\n<ol>\n<li>In the Mirakl back office, go to <strong>Shops<\/strong> &gt; <strong>All shop accounts<\/strong>.<\/li>\n<li>Select the shop account for which you want to check if the HOP is generated.<\/li>\n<li>On the shop account page, check if the <strong>Additional Information<\/strong> &gt; <strong>Hop Url<\/strong> field is populated with a link.<\/li>\n<\/ol><\/li>\n<li>When the seller clicks on the link, they are directed to a connector page where they have to answer security questions.<\/li>\n<li>After the seller correctly responds to the security questions, the connector redirects the seller to the Adyen HOP.<\/li>\n<li>On the Adyen HOP page, the account holder and any additional shareholders go through KYC checks.<\/li>\n<li>When the checks are completed, the <a href=\"#kyc-status\">KYC status<\/a> in Mirakl is updated. The statuses between Mirakl and Adyen are automatically synced by the connector.\n<ul>\n<li>If the seller passes the checks, their KYC process is successfully completed. The seller receives an email that they have passed KYC verification.<\/li>\n<li>If the seller does not pass the checks, the seller receives <a href=\"\/pt\/plugins\/mirakl\/set-up-the-connector#update-email-settings-in-mirakl\">an email about the issue<\/a>. The Mirakl shop page shows information related to the issue as well.<\/li>\n<\/ul><\/li>\n<\/ol>\n<h3 id=\"kyc-statuses\">KYC statuses<\/h3>\n<p>The sellers that are in the KYC verification process can have one of the following statuses:<\/p>\n<ul>\n<li>Awaiting KYC data<\/li>\n<li>Awaiting KYC verification<\/li>\n<li>KYC failed<\/li>\n<\/ul>\n<h2>Data sync from Mirakl to Adyen<\/h2>\n<p>To ensure that your sellers' information is synced correctly to Adyen, the information fields must be filled according to the data format requirements. Your sellers must follow the requirements below, in addition to the <a href=\"\/pt\/marketplaces\/verification-requirements\/data-formats-per-country\">data formats per country or region<\/a>.<\/p>\n<h3>Phone numbers<\/h3>\n<p>Your sellers must enter phone numbers using the <code>+<\/code> sign and country code. For example, a seller with a Dutch phone number must be filled as <code>+31612345678<\/code>, where <code>31<\/code> is the country code.<\/p>\n<p>This requirement also applies to the phone number field that sellers must fill in the Adyen HOP.<\/p>\n<h3>Bank data<\/h3>\n<p>There are different types of data that a seller can provide about their bank account. For example, bank name, <a href=\"https:\/\/en.wikipedia.org\/wiki\/ISO_9362\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">business identifier code<\/a> (BIC) of the bank, and IBAN.<\/p>\n<p>In Mirakl, the <strong>Bank name<\/strong> and <strong>BIC<\/strong> fields are mandatory, but the Adyen HOP only requires the seller to provide an IBAN. As a consequence:<\/p>\n<ul>\n<li>If the data is provided by the seller through the Mirakl seller form, the connector syncs this information to Adyen.<\/li>\n<li>If the data is provided through the Adyen HOP, the IBAN is synced to Adyen and the connector populates dummy values for the <strong>Bank name<\/strong> and <strong>BIC<\/strong> fields.<\/li>\n<\/ul>\n<p>Therefore, we recommend to populate bank details in Mirakl first, before proceeding to the Adyen hosted onboarding process. You can also explain this flow to your sellers to avoid receiving questions about the dummy values the connector populates.<\/p>","url":"https:\/\/docs.adyen.com\/pt\/plugins\/mirakl\/onboard-sellers","articleFields":{"description":"Understand how Adyen's Mirakl connector manages onboarding and handles KYC checks.","next_steps":[{"title":"Set up payment flows","description":"Learn about implementing payments, refunds, and chargebacks.","url":"\/plugins\/mirakl\/set-up-payment-flows","required":true},{"title":"Seller payouts and commissions","description":"Learn how the connector handles seller payouts and commissions.","url":"\/plugins\/mirakl\/payouts","required":true}],"feedback_component":true,"status":"current","page_id":"04613b48-c6ef-467a-8a3e-7d7e2ec6df51","filters_component":false,"decision_tree":"[]"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/plugins\/mirakl\/onboard-sellers","title":"Onboard sellers","content":"Each seller you add to your Mirakl marketplace goes through a KYC verification for their onboarding. The connector supports sellers that offer products, services, or both.\nIf a seller has multiple shops to accept payments in different currencies, each shop is treated as a separate legal entity by Adyen. Therefore, each shop needs to be onboarded separately.\nHow it works\n\nYou add a seller to your Mirakl marketplace.\n\nThe seller is required to provide the following information to create the legal entity in Adyen. The data provided must match the data format per country\/region, for the country\/region where the seller is based.\n\nEmail\nCompany name (legalBusinessName)\n\nWhen address is provided, it must include the following fields:\n\nCity\nCountry\/region\nPostal code\nStreet\nState or Province (only required if the address is in the US or Canada)\n\nWhen bank account is provided, it must include the following fields:\n\nCurrency code\nOwner name\nCountry code\nIBAN\n\n\nThe connector submits the seller's information to Adyen in a \n  \/legalEntities\n request.\nWith the next sync, the Hosted Onboarding Page (HOP) link is created and the seller can access it in Mirakl.\nTo check if a link was created successfully:\n\nIn the Mirakl back office, go to Shops &gt; All shop accounts.\nSelect the shop account for which you want to check if the HOP is generated.\nOn the shop account page, check if the Additional Information &gt; Hop Url field is populated with a link.\n\nWhen the seller clicks on the link, they are directed to a connector page where they have to answer security questions.\nAfter the seller correctly responds to the security questions, the connector redirects the seller to the Adyen HOP.\nOn the Adyen HOP page, the account holder and any additional shareholders go through KYC checks.\nWhen the checks are completed, the KYC status in Mirakl is updated. The statuses between Mirakl and Adyen are automatically synced by the connector.\n\nIf the seller passes the checks, their KYC process is successfully completed. The seller receives an email that they have passed KYC verification.\nIf the seller does not pass the checks, the seller receives an email about the issue. The Mirakl shop page shows information related to the issue as well.\n\n\nKYC statuses\nThe sellers that are in the KYC verification process can have one of the following statuses:\n\nAwaiting KYC data\nAwaiting KYC verification\nKYC failed\n\nData sync from Mirakl to Adyen\nTo ensure that your sellers' information is synced correctly to Adyen, the information fields must be filled according to the data format requirements. Your sellers must follow the requirements below, in addition to the data formats per country or region.\nPhone numbers\nYour sellers must enter phone numbers using the + sign and country code. For example, a seller with a Dutch phone number must be filled as +31612345678, where 31 is the country code.\nThis requirement also applies to the phone number field that sellers must fill in the Adyen HOP.\nBank data\nThere are different types of data that a seller can provide about their bank account. For example, bank name, business identifier code (BIC) of the bank, and IBAN.\nIn Mirakl, the Bank name and BIC fields are mandatory, but the Adyen HOP only requires the seller to provide an IBAN. As a consequence:\n\nIf the data is provided by the seller through the Mirakl seller form, the connector syncs this information to Adyen.\nIf the data is provided through the Adyen HOP, the IBAN is synced to Adyen and the connector populates dummy values for the Bank name and BIC fields.\n\nTherefore, we recommend to populate bank details in Mirakl first, before proceeding to the Adyen hosted onboarding process. You can also explain this flow to your sellers to avoid receiving questions about the dummy values the connector populates.","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Plugins","lvl2":"Mirakl","lvl3":"Onboard sellers"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/plugins","lvl2":"https:\/\/docs.adyen.com\/pt\/plugins\/mirakl","lvl3":"\/pt\/plugins\/mirakl\/onboard-sellers"},"levels":4,"category":"Plugins","category_color":"green","tags":["Onboard","sellers"]}}