{"title":"Platforms integration and go live checklist","category":"Classic Platforms","creationDate":1590586560,"content":"<div class=\"sc-notice info\"><div>\n<p>This page is for classic Adyen for Platforms integrations. If you are just starting your implementation, refer to our <a href=\"\/pt\/adyen-for-platforms-model\">new integration guide<\/a> instead.<\/p>\n<\/div><\/div>\n<p>On this page, you can find the checks that you can perform to make sure you have set up your Adyen for Platforms integration correctly before you go live.<\/p>\n<h2>Requirements<\/h2>\n<p>The <a href=\"#afp-integration-check\">integration checklist<\/a> and the <a href=\"#afp-golive\">go live checklist<\/a> on this page assume that you have set up a test integration and that you are familiar with the Adyen for Platforms integration options and choices. If you haven't started yet, check out the <a href=\"\/pt\/classic-platforms\/quick-start\">Platforms quick start guide<\/a>.<\/p>\n<p>The choices you make have an impact how and what you should verify for your integration. Make sure that you have made a decision on how you:<\/p>\n<ul>\n<li>Collect information necessary for verifying sub-merchants; <a href=\"\/pt\/classic-platforms\/onboard-users\">staggered or all at once<\/a>.<\/li>\n<li><strong>Onboard<\/strong> sub-merchants as account holders; using a <a href=\"\/pt\/classic-platforms\/onboard-users\/hosted-onboarding-page\">Hosted Onboarding Page (HOP)<\/a> or using <a href=\"\/pt\/classic-platforms\/onboard-users\/custom-onboarding\">your own onboarding flow<\/a>.<\/li>\n<li>Handle <strong>payouts<\/strong>; <a href=\"\/pt\/classic-platforms\/payouts\/scheduled-payout\">automatically<\/a> trigger scheduled payouts to bank accounts, or <a href=\"\/pt\/classic-platforms\/payouts\/manual-payout\">manually<\/a> send payouts to bank accounts or eligible cards.<\/li>\n<\/ul>\n<p>Also, make sure that you are familiar with:<\/p>\n<ul>\n<li>The <a href=\"\/pt\/classic-platforms\/account-structure\">account structure<\/a> of Adyen for Platforms.<\/li>\n<li>The endpoints in the <a href=\"\/pt\/classic-platforms\/api\">Platforms API<\/a> and the <a href=\"\/pt\/classic-platforms\/error-codes\">error codes<\/a>.<\/li>\n<li>The Adyen for Platforms reports: the <a href=\"\/pt\/classic-platforms\/reports-and-fees\/marketpay-balance-report\">balance report<\/a>, the <a href=\"\/pt\/reporting\/marketpay-payments-accounting-report\">payments accounting report<\/a> and the <a href=\"\/pt\/classic-platforms\/reports-and-fees\/marketpay-payout-report\">payout report<\/a> (for automatic payouts only).<\/li>\n<\/ul>\n<h2 id=\"afp-integration-check\">Integration checklist<\/h2>\n<p>Onboard a test sub-merchant as an account holder, test a payment and test your integration before you configure your live environment, process real payments and start payouts. Follow the steps in this checklist:<\/p>\n<ul>\n<li><a href=\"#afp-testaccount\">Step 1: Verify your test account<\/a><\/li>\n<li><a href=\"#afp-onboarding\">Step 2: Test your onboarding and verification process<\/a><\/li>\n<li><a href=\"#afp-payments\">Step 3: Processing payments<\/a><\/li>\n<li><a href=\"#afp-payouts\">Step 4: Verify payouts<\/a><\/li>\n<li><a href=\"#afp-notifications\">Step 5: Set up and test notifications<\/a><\/li>\n<li><a href=\"#afp-reports\">Step 6: Reconcile transactions using reports<\/a><\/li>\n<\/ul>\n<p><\/p>\n<h2 id=\"afp-testaccount\">Step 1: Verify your test account<\/h2>\n<p>Before you start your integration test, check that you have an Adyen for Platforms <a href=\"\/pt\/classic-platforms\/quick-start#before-you-begin\">test account<\/a> with the required API credentials. You can only verify your integration if these are in place.<\/p>\n<ol>\n<li>Log in to your test Customer Area with your Adyen for Platforms test account.<\/li>\n<li>Select your platform merchant account, and then <strong>Accounts<\/strong> &gt; <strong>API credentials<\/strong>.<\/li>\n<li>Check that you have API credentials for your platform account and for processing payments:\n<ol>\n<li>Platform: <span translate=\"no\"><strong>ws_[123456]@MarketPlace.[YourPlatformAccount]<\/strong><\/span>.<\/li>\n<li>Payments: <span translate=\"no\"><strong>ws@Company.<\/strong><\/span><strong>[YourCompanyAccount]<\/strong>.<\/li>\n<\/ol><\/li>\n<li>By default, the <a href=\"\/pt\/payment-methods\/cards\">cards payment method<\/a> is added to your platform test account. If you want to test other payment methods, make sure you <a href=\"\/pt\/payment-methods\/add-payment-methods\">request<\/a> them first.<\/li>\n<\/ol>\n<h2 id=\"afp-onboarding\">Step 2: Test your onboarding and verification process<\/h2>\n<p>Configure <a href=\"#afp-kyc-notifications\">verification notifications<\/a> and then sign up, onboard a sub-merchant as an account holder, and perform checks to verify that your process works. Test the process that you have chosen: using a <a href=\"#afp-hop\">Hosted Onboarding Page<\/a> or using your <a href=\"#afp-own-onboarding\">own onboarding flow<\/a>.<\/p>\n<h3 id=\"afp-kyc-notifications\">Set up verification notifications<\/h3>\n<p>Because the verification process is such an important part of your platform, we strongly recommend that you set up the <a href=\"\/pt\/classic-platforms\/notification-types\">notifications<\/a> <code>ACCOUNT_HOLDER_CREATED<\/code>, <code>ACCOUNT_HOLDER_UPDATED<\/code>, <code>ACCOUNT_HOLDER_STATUS_CHANGE<\/code> and <code>ACCOUNT_HOLDER_VERIFICATION<\/code> to be able to fully verify that your onboarding process works.<\/p>\n<p>Once you go live, you will use these notifications to monitor an account holder's <a href=\"\/pt\/classic-platforms\/verification-process\/check-verification-results#verification-statuses\">verification status<\/a>, so that you can take the appropriate follow-up action and communicate with account holder about their onboarding status.<\/p>\n<div class=\"notices green\">\n<p>You have to complete the <a href=\"\/pt\/classic-platforms\/verification-process\">verification process<\/a> in order to send <a href=\"#afp-payouts\">payouts<\/a> to an account holder.<\/p>\n<\/div>\n<ol>\n<li><strong>Set up verification notifications<\/strong>.<br \/>\n<a href=\"\/pt\/classic-platforms\/configure-notifications\">Create a notification configuration<\/a> for the following notification types:\n<ul>\n<li><code>ACCOUNT_HOLDER_CREATED<\/code><\/li>\n<li><code>ACCOUNT_HOLDER_UPDATED<\/code><\/li>\n<li><code>ACCOUNT_HOLDER_STATUS_CHANGE<\/code><\/li>\n<li><code>ACCOUNT_HOLDER_VERIFICATION<\/code><\/li>\n<\/ul><\/li>\n<li><strong>Expose an endpoint to handle notifications<\/strong>.<br \/>\nBy <a href=\"\/pt\/development-resources\/webhooks\/configure-and-manage#expose-an-endpoint-on-your-server\">exposing an endpoint<\/a>, you make sure that you can <a href=\"\/pt\/classic-platforms\/configure-notifications#accept-notifications\">accept notifications<\/a>.<\/li>\n<li><strong>Test the notifications while you test your onboarding process<\/strong>.<br \/>\nContinue with the onboarding verification steps in using a <a href=\"#afp-hop\">Hosted Onboarding Page<\/a> or using your <a href=\"#afp-own-onboarding\">own onboarding flow<\/a> to verify that the notifications work.<\/li>\n<\/ol>\n<h3 id=\"afp-hop\">Onboard using a Hosted Onboarding Page (HOP)<\/h3>\n<p>Sign up, onboard a sub-merchant as an account holder, and perform a check to verify that the process works.<\/p>\n<p>You can use the details from the Adyen for Platforms <a href=\"\/pt\/classic-platforms\/test-scenarios\">test scenarios<\/a> when you fill out the Hosted Onboarding Page.<\/p>\n<ol>\n<li><strong>Create an account holder<\/strong>.<br \/>\n<a href=\"\/pt\/classic-platforms\/account-holders-and-accounts#create-an-account-holder\">Create an account holder<\/a> with a POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Account\/latest\/post\/createAccountHolder\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/createAccountHolder<\/a> request. The minimum required information depends on the legal entity type and the country where the account holder is based.<\/li>\n<li><strong>Test your <a href=\"\/pt\/classic-platforms\/onboard-users\/hosted-onboarding-page\">Hosted Onboarding Page<\/a><\/strong>.\n<ul>\n<li>Start the verification process and get the HOP URL.<\/li>\n<li>When you <a href=\"\/pt\/classic-platforms\/onboard-users\/hosted-onboarding-page#handle-redirect\">redirect<\/a> the sub-merchant to your return URL, inform them of their onboarding progress based on the notification webhooks you receive.<\/li>\n<li>Look at the <a href=\"#afp-kyc-notifications\">notifications<\/a> to determine if the sub-merchant is successfully onboarded as an account holder, stopped the process or that you require additional information to complete the verification.<\/li>\n<\/ul><\/li>\n<\/ol>\n<div class=\"notices green\">\n<p>You are responsible for following up on the <a href=\"\/pt\/classic-platforms\/verification-process\">verification status<\/a> and communicating with sub-merchants onboarding on your platform.<\/p>\n<\/div>\n<h3 id=\"afp-own-onboarding\">Onboard using your own verification process<\/h3>\n<p>When you build your own verification process, you need a webpage or an app that sub-merchants can use to fill out their information.<\/p>\n<p>To test your onboarding process, make sure that you have a webpage or an app ready to collect the required information, and that you understand how to send the information to Adyen. See <a href=\"\/pt\/classic-platforms\/onboard-users\/custom-onboarding\">Build your own implementation<\/a> for more information.<\/p>\n<p>You can use the details from the Adyen for Platforms <a href=\"\/pt\/classic-platforms\/test-scenarios\">test scenarios<\/a> when you fill out your onboarding webpage or app.<\/p>\n<ol>\n<li><strong>Create an account holder<\/strong>.<br \/>\n<a href=\"\/pt\/classic-platforms\/account-holders-and-accounts#create-an-account-holder\">Create an account holder<\/a> for with a POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Account\/latest\/post\/createAccountHolder\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/createAccountHolder<\/a> request. The minimum required information depends on the legal entity type and the country where the account holder is based.<\/li>\n<li><strong>Test your webpage or app: onboard a sub-merchant as an account holder<\/strong>.\n<ul>\n<li>On your webpage or app, collect the relevant details based on <a href=\"\/pt\/classic-platforms\/verification-process\/required-information\">country requirements and their legal entity type<\/a>. Send the information to Adyen with a POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Account\/latest\/post\/updateAccountHolder\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/updateAccountHolder<\/a> request.<\/li>\n<li>Look at the <a href=\"#afp-kyc-notifications\">notifications<\/a> to determine if the sub-merchant is successfully onboarded as an account holder, stopped the process or that you require additional information to complete the verification.<\/li>\n<\/ul><\/li>\n<\/ol>\n<div class=\"notices green\">\n<p>You are responsible for following up on the <a href=\"\/pt\/classic-platforms\/verification-process\">verification status<\/a> and communicating with sub-merchants onboarding on your platform.<\/p>\n<\/div>\n<h2 id=\"afp-payments\">Step 3: Processing payments<\/h2>\n<p>When a customer pays on your platform, you can automatically split these funds between multiple accounts. With every payment, capture, or refund you can customize the split between any number of <a href=\"\/pt\/classic-platforms\/account-structure#your-platform\">accounts in your platform<\/a> and amounts including your liable account. How you want to split your payments, and at what stage in the payment - immediately at <a href=\"\/pt\/classic-platforms\/processing-payments#providing-split-instructions\">authorisation<\/a> or later at <a href=\"\/pt\/classic-platforms\/processing-payments#split-at-capture\">capture<\/a> - is your decision. For more information, see <a href=\"\/pt\/classic-platforms\/processing-payments\">processing payments<\/a>.<\/p>\n<ol>\n<li>\n<p><strong>Provide split instructions<\/strong><br \/>\nProvide an array of  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-splits\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">splits<\/a> objects in the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/payments<\/a> call.<\/p>\n<\/li>\n<li>\n<p><strong>Check if split payments work<\/strong><br \/>\nTest a split payment with your preferred way of splitting with a <a href=\"\/pt\/development-resources\/test-cards-and-credentials\/test-card-numbers\">test card number<\/a>. To check what happens to the payment, see <a href=\"\/pt\/classic-platforms\/processing-payments#payment-statuses\">payment statuses<\/a>.<\/p>\n<\/li>\n<\/ol>\n<p>We recommend to test the following:<\/p>\n<ul>\n<li>Split at <a href=\"\/pt\/classic-platforms\/processing-payments#providing-split-instructions\">authorization<\/a><\/li>\n<li>Split at <a href=\"\/pt\/classic-platforms\/processing-payments#split-at-capture\">capture<\/a><\/li>\n<li>Split a <a href=\"\/pt\/classic-platforms\/processing-payments#split-a-refund\">refund<\/a><\/li>\n<li><a href=\"\/pt\/classic-platforms\/processing-payments#chargeback-and-disputes\">Chargebacks<\/a> and <a href=\"\/pt\/classic-platforms\/fund-transfer\">fund transfer<\/a><\/li>\n<\/ul>\n<h2 id=\"afp-payouts\">Step 4: Verify payouts<\/h2>\n<p>To be able to perform payouts, account holders have to pass the verification checks and you have to know the <code>accountCode<\/code> and, for manual payouts, the <code>accountHolderCode<\/code>. Your platform's liable account also has its own <code>accountCode<\/code>. For more information, see <a href=\"\/pt\/classic-platforms\/payouts\">payouts<\/a> and <a href=\"\/pt\/classic-platforms\/account-structure\/#your-platform\">accounts<\/a>.<\/p>\n<ol>\n<li><strong>Test a one-off payout<\/strong><br \/>\nUse the test account holder and make a POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Fund\/latest\/post\/payoutAccountHolder\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/payoutAccountHolder<\/a> request.<\/li>\n<li><strong>Verify the payout<\/strong><br \/>\nCheck that you get a successful <code>200<\/code> response to confirm that the payout is successful.<\/li>\n<\/ol>\n<p>You can also set up and test notifications for payouts, see the next step.<\/p>\n<h2 id=\"afp-notifications\">Step 5: Set up and test notifications<\/h2>\n<p>Because the requests you send to the Platforms API are asynchronous, you have to set up notification webhooks to know the final result of the request. In step 2, you set up and tested the essential <a href=\"#afp-kyc-notifications\">verification checks<\/a>. In this step, you verify any other notifications that you want to use.<\/p>\n<p>You configure notification webhooks to be able to get notifications of:<\/p>\n<ul>\n<li>The verification process, as mentioned earlier.<\/li>\n<li>Status changes of your <strong>accounts<\/strong> and <strong>account holders<\/strong>, as mentioned earlier.<\/li>\n<li>Fund management: notifications of <strong>payouts<\/strong>, <strong>transfers<\/strong> and <strong>refunds<\/strong>.<\/li>\n<li>Availability of <strong>reports<\/strong>.<\/li>\n<\/ul>\n<p>For more information, see <a href=\"\/pt\/classic-platforms\/notifications\">Notifications<\/a>.<\/p>\n<ol>\n<li><strong>Create a notification configuration<\/strong>.<br \/>\n<a href=\"\/pt\/classic-platforms\/configure-notifications\">Configure a notification configuration<\/a> for the notifications that you want to receive.<\/li>\n<li><strong>Test your notification configuration<\/strong>.<br \/>\nFollow the steps in the documentation to <a href=\"\/pt\/classic-platforms\/configure-notifications#test-a-notification\">test your notification configuration<\/a>.<\/li>\n<\/ol>\n<h2 id=\"afp-reports\">Step 6: Reconcile transactions using reports<\/h2>\n<p>Use the reports generated in the test environment to test your reconciliation processes.<\/p>\n<p>For more information on how you can use the reports, refer to <a href=\"\/pt\/classic-platforms\/reconciliation-use-cases\">Reconcile transactions through reports<\/a>.<\/p>\n<p>Make sure that you are able to:<\/p>\n<ol>\n<li><a href=\"\/pt\/reporting\/downloading-reports\">Download reports<\/a>.<\/li>\n<li>Run your reconciliation process.<\/li>\n<\/ol>\n<h2 id=\"afp-golive\">Go live checklist<\/h2>\n<p>After you have built out and tested your Adyen for Platforms integration, you will want to go live. When you are ready, follow these steps:<\/p>\n<ol>\n<li><strong>Request your account to be taken live<\/strong><br \/>\nMake sure that you have signed the Adyen for Platforms contract to get a live account. Your sales or account manager will help you with this process.<\/li>\n<li><strong>Access the live Customer Area<\/strong><br \/>\nOnce you get an email confirmation that your live account is ready, use the live credentials to log in to the <a href=\"https:\/\/ca-live.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">live Customer Area<\/a>.<\/li>\n<li><strong>Update account settings<\/strong><br \/>\nWhen your account is taken live, some settings are copied over, but you need to update the settings for the following:\n<ul>\n<li>Notifications<\/li>\n<li>Report subscriptions<\/li>\n<li>API responses<\/li>\n<li>Shopper statements for payouts and payments, aligned with your sales or account manager.<\/li>\n<li><a href=\"\/pt\/online-payments\/tokenization\/make-token-payments#test-and-go-live\">Recurring payment details<\/a> (if applicable)<\/li>\n<\/ul><\/li>\n<li><strong>Set up risk configurations<\/strong><br \/>\nIt is important that risk management is set up to handle live transactions, including selecting a <a href=\"\/pt\/risk-management\/create-and-use-risk-profiles\/\">risk profile<\/a> that best matches your business.<\/li>\n<li><strong>Add a platform payout account<\/strong><br \/>\nProvide information for the payout account where you want to receive payments for the platform merchant account.<\/li>\n<li><strong>Request additional payment methods<\/strong><br \/>\nReview the payment methods in your <a href=\"\/pt\/classic-platforms\/account-structure#your-adyen-account\">Adyen merchant account<\/a>. Based on where your platform is located, you will have some default payment methods that are ready for use. You can add <a href=\"\/pt\/classic-platforms\/processing-payments#supported-payment-methods\">more payment methods<\/a>. Once your platform is live, onboarded and verified account holders can offer all the payment methods that you add to your platform merchant account.<\/li>\n<li><strong>Update code base<\/strong><br \/>\nUpdate your code base and platform merchant account settings.\n<ul>\n<li><strong>Switch to live API credentials<\/strong><br \/>\nGenerate API keys in your <a href=\"https:\/\/ca-live.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">live Customer Area<\/a>. Copy these keys to your live platform.<\/li>\n<li><strong>Switch your test endpoints to your live, custom URLs<\/strong><br \/>\nChange the <a href=\"\/pt\/classic-platforms\/api\">Platforms API<\/a> endpoints that you used to test your integration to live endpoints.<br \/>\nFor example, to change the <a href=\"https:\/\/docs.adyen.com\/api-explorer\/#\/Account\/overview\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Account API<\/a> from <span translate=\"no\"><strong>test<\/strong><\/span> to <span translate=\"no\"><strong>live<\/strong><\/span>, change <code>https:\/\/cal-test.adyen.com\/cal\/services\/Account\/v5<\/code> to <code>https:\/\/cal-live.adyen.com\/cal\/services\/Account\/v5<\/code>.<br \/>\nAlso change the <a href=\"\/pt\/development-resources\/live-endpoints\">payment endpoints<\/a> to live.<\/li>\n<\/ul><\/li>\n<li>\n<p><strong>End-to-end test<\/strong><br \/>\nMake sure that your platform can handle the entire payment lifecycle from authorization and refusals through payout and reconciliation. We suggest testing the following:<\/p>\n<ul>\n<li>\n<p>Payments:<\/p>\n<ul>\n<li>Test the happy flow by making payments with real cards, and payments with real details for other payment methods that you support.<\/li>\n<li>Test non-happy payment flows to ensure your integration can handle errors and refusal reasons.<\/li>\n<li>\n<p>Test the 3D Secure flow, if you implemented that.<\/p>\n   <!-- list separator -->\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Payment modifications, like cancellations and refunds.<\/p>\n<\/li>\n<li>\n<p>Notification webhooks: Confirm you are able to acknowledge any <a href=\"\/pt\/classic-platforms\/configure-notifications\">notification type<\/a> with an <code>[accepted]<\/code> response, to prevent notifications being queued.<\/p>\n<\/li>\n<li>\n<p>Order handling.<\/p>\n<\/li>\n<li>\n<p>Bank statements: Verify that payments appear correctly on the shopper's bank statement.<\/p>\n<\/li>\n<li>\n<p>Payouts: Confirm you can onboard merchants, perform verification checks and can send and receive payouts.<\/p>\n<\/li>\n<li>\n<p>Reconciliation: Confirm your system completes the reconciliation process.<\/p>\n<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<h2 id=\"see-also\">See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/classic-platforms\/quick-start\"\n                        target=\"_self\"\n                        >\n                    Platforms quick start\n                <\/a><\/li><li><a href=\"\/classic-platforms\/test-scenarios\"\n                        target=\"_self\"\n                        >\n                    Test scenarios\n                <\/a><\/li><li><a href=\"\/classic-platforms\/api\"\n                        target=\"_self\"\n                        >\n                    Adyen for Platforms API\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/classic-platforms\/platforms-integration-checklist","articleFields":{"description":"Understand the core integration checks you can perform before you go live. ","search_category":"Classic Platforms","last_edit_on":"01-02-2021 15:26","parameters":{"directoryPath":"\/classic-platforms"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/classic-platforms\/platforms-integration-checklist","title":"Platforms integration and go live checklist","content":"\nThis page is for classic Adyen for Platforms integrations. If you are just starting your implementation, refer to our new integration guide instead.\n\nOn this page, you can find the checks that you can perform to make sure you have set up your Adyen for Platforms integration correctly before you go live.\nRequirements\nThe integration checklist and the go live checklist on this page assume that you have set up a test integration and that you are familiar with the Adyen for Platforms integration options and choices. If you haven't started yet, check out the Platforms quick start guide.\nThe choices you make have an impact how and what you should verify for your integration. Make sure that you have made a decision on how you:\n\nCollect information necessary for verifying sub-merchants; staggered or all at once.\nOnboard sub-merchants as account holders; using a Hosted Onboarding Page (HOP) or using your own onboarding flow.\nHandle payouts; automatically trigger scheduled payouts to bank accounts, or manually send payouts to bank accounts or eligible cards.\n\nAlso, make sure that you are familiar with:\n\nThe account structure of Adyen for Platforms.\nThe endpoints in the Platforms API and the error codes.\nThe Adyen for Platforms reports: the balance report, the payments accounting report and the payout report (for automatic payouts only).\n\nIntegration checklist\nOnboard a test sub-merchant as an account holder, test a payment and test your integration before you configure your live environment, process real payments and start payouts. Follow the steps in this checklist:\n\nStep 1: Verify your test account\nStep 2: Test your onboarding and verification process\nStep 3: Processing payments\nStep 4: Verify payouts\nStep 5: Set up and test notifications\nStep 6: Reconcile transactions using reports\n\n\nStep 1: Verify your test account\nBefore you start your integration test, check that you have an Adyen for Platforms test account with the required API credentials. You can only verify your integration if these are in place.\n\nLog in to your test Customer Area with your Adyen for Platforms test account.\nSelect your platform merchant account, and then Accounts &gt; API credentials.\nCheck that you have API credentials for your platform account and for processing payments:\n\nPlatform: ws_[123456]@MarketPlace.[YourPlatformAccount].\nPayments: ws@Company.[YourCompanyAccount].\n\nBy default, the cards payment method is added to your platform test account. If you want to test other payment methods, make sure you request them first.\n\nStep 2: Test your onboarding and verification process\nConfigure verification notifications and then sign up, onboard a sub-merchant as an account holder, and perform checks to verify that your process works. Test the process that you have chosen: using a Hosted Onboarding Page or using your own onboarding flow.\nSet up verification notifications\nBecause the verification process is such an important part of your platform, we strongly recommend that you set up the notifications ACCOUNT_HOLDER_CREATED, ACCOUNT_HOLDER_UPDATED, ACCOUNT_HOLDER_STATUS_CHANGE and ACCOUNT_HOLDER_VERIFICATION to be able to fully verify that your onboarding process works.\nOnce you go live, you will use these notifications to monitor an account holder's verification status, so that you can take the appropriate follow-up action and communicate with account holder about their onboarding status.\n\nYou have to complete the verification process in order to send payouts to an account holder.\n\n\nSet up verification notifications.\nCreate a notification configuration for the following notification types:\n\nACCOUNT_HOLDER_CREATED\nACCOUNT_HOLDER_UPDATED\nACCOUNT_HOLDER_STATUS_CHANGE\nACCOUNT_HOLDER_VERIFICATION\n\nExpose an endpoint to handle notifications.\nBy exposing an endpoint, you make sure that you can accept notifications.\nTest the notifications while you test your onboarding process.\nContinue with the onboarding verification steps in using a Hosted Onboarding Page or using your own onboarding flow to verify that the notifications work.\n\nOnboard using a Hosted Onboarding Page (HOP)\nSign up, onboard a sub-merchant as an account holder, and perform a check to verify that the process works.\nYou can use the details from the Adyen for Platforms test scenarios when you fill out the Hosted Onboarding Page.\n\nCreate an account holder.\nCreate an account holder with a POST  \/createAccountHolder request. The minimum required information depends on the legal entity type and the country where the account holder is based.\nTest your Hosted Onboarding Page.\n\nStart the verification process and get the HOP URL.\nWhen you redirect the sub-merchant to your return URL, inform them of their onboarding progress based on the notification webhooks you receive.\nLook at the notifications to determine if the sub-merchant is successfully onboarded as an account holder, stopped the process or that you require additional information to complete the verification.\n\n\n\nYou are responsible for following up on the verification status and communicating with sub-merchants onboarding on your platform.\n\nOnboard using your own verification process\nWhen you build your own verification process, you need a webpage or an app that sub-merchants can use to fill out their information.\nTo test your onboarding process, make sure that you have a webpage or an app ready to collect the required information, and that you understand how to send the information to Adyen. See Build your own implementation for more information.\nYou can use the details from the Adyen for Platforms test scenarios when you fill out your onboarding webpage or app.\n\nCreate an account holder.\nCreate an account holder for with a POST  \/createAccountHolder request. The minimum required information depends on the legal entity type and the country where the account holder is based.\nTest your webpage or app: onboard a sub-merchant as an account holder.\n\nOn your webpage or app, collect the relevant details based on country requirements and their legal entity type. Send the information to Adyen with a POST  \/updateAccountHolder request.\nLook at the notifications to determine if the sub-merchant is successfully onboarded as an account holder, stopped the process or that you require additional information to complete the verification.\n\n\n\nYou are responsible for following up on the verification status and communicating with sub-merchants onboarding on your platform.\n\nStep 3: Processing payments\nWhen a customer pays on your platform, you can automatically split these funds between multiple accounts. With every payment, capture, or refund you can customize the split between any number of accounts in your platform and amounts including your liable account. How you want to split your payments, and at what stage in the payment - immediately at authorisation or later at capture - is your decision. For more information, see processing payments.\n\n\nProvide split instructions\nProvide an array of  splits objects in the  \/payments call.\n\n\nCheck if split payments work\nTest a split payment with your preferred way of splitting with a test card number. To check what happens to the payment, see payment statuses.\n\n\nWe recommend to test the following:\n\nSplit at authorization\nSplit at capture\nSplit a refund\nChargebacks and fund transfer\n\nStep 4: Verify payouts\nTo be able to perform payouts, account holders have to pass the verification checks and you have to know the accountCode and, for manual payouts, the accountHolderCode. Your platform's liable account also has its own accountCode. For more information, see payouts and accounts.\n\nTest a one-off payout\nUse the test account holder and make a POST  \/payoutAccountHolder request.\nVerify the payout\nCheck that you get a successful 200 response to confirm that the payout is successful.\n\nYou can also set up and test notifications for payouts, see the next step.\nStep 5: Set up and test notifications\nBecause the requests you send to the Platforms API are asynchronous, you have to set up notification webhooks to know the final result of the request. In step 2, you set up and tested the essential verification checks. In this step, you verify any other notifications that you want to use.\nYou configure notification webhooks to be able to get notifications of:\n\nThe verification process, as mentioned earlier.\nStatus changes of your accounts and account holders, as mentioned earlier.\nFund management: notifications of payouts, transfers and refunds.\nAvailability of reports.\n\nFor more information, see Notifications.\n\nCreate a notification configuration.\nConfigure a notification configuration for the notifications that you want to receive.\nTest your notification configuration.\nFollow the steps in the documentation to test your notification configuration.\n\nStep 6: Reconcile transactions using reports\nUse the reports generated in the test environment to test your reconciliation processes.\nFor more information on how you can use the reports, refer to Reconcile transactions through reports.\nMake sure that you are able to:\n\nDownload reports.\nRun your reconciliation process.\n\nGo live checklist\nAfter you have built out and tested your Adyen for Platforms integration, you will want to go live. When you are ready, follow these steps:\n\nRequest your account to be taken live\nMake sure that you have signed the Adyen for Platforms contract to get a live account. Your sales or account manager will help you with this process.\nAccess the live Customer Area\nOnce you get an email confirmation that your live account is ready, use the live credentials to log in to the live Customer Area.\nUpdate account settings\nWhen your account is taken live, some settings are copied over, but you need to update the settings for the following:\n\nNotifications\nReport subscriptions\nAPI responses\nShopper statements for payouts and payments, aligned with your sales or account manager.\nRecurring payment details (if applicable)\n\nSet up risk configurations\nIt is important that risk management is set up to handle live transactions, including selecting a risk profile that best matches your business.\nAdd a platform payout account\nProvide information for the payout account where you want to receive payments for the platform merchant account.\nRequest additional payment methods\nReview the payment methods in your Adyen merchant account. Based on where your platform is located, you will have some default payment methods that are ready for use. You can add more payment methods. Once your platform is live, onboarded and verified account holders can offer all the payment methods that you add to your platform merchant account.\nUpdate code base\nUpdate your code base and platform merchant account settings.\n\nSwitch to live API credentials\nGenerate API keys in your live Customer Area. Copy these keys to your live platform.\nSwitch your test endpoints to your live, custom URLs\nChange the Platforms API endpoints that you used to test your integration to live endpoints.\nFor example, to change the Account API from test to live, change https:\/\/cal-test.adyen.com\/cal\/services\/Account\/v5 to https:\/\/cal-live.adyen.com\/cal\/services\/Account\/v5.\nAlso change the payment endpoints to live.\n\n\nEnd-to-end test\nMake sure that your platform can handle the entire payment lifecycle from authorization and refusals through payout and reconciliation. We suggest testing the following:\n\n\nPayments:\n\nTest the happy flow by making payments with real cards, and payments with real details for other payment methods that you support.\nTest non-happy payment flows to ensure your integration can handle errors and refusal reasons.\n\nTest the 3D Secure flow, if you implemented that.\n   \n\n\n\n\nPayment modifications, like cancellations and refunds.\n\n\nNotification webhooks: Confirm you are able to acknowledge any notification type with an [accepted] response, to prevent notifications being queued.\n\n\nOrder handling.\n\n\nBank statements: Verify that payments appear correctly on the shopper's bank statement.\n\n\nPayouts: Confirm you can onboard merchants, perform verification checks and can send and receive payouts.\n\n\nReconciliation: Confirm your system completes the reconciliation process.\n\n\n\n\nSee also\n\n\n                    Platforms quick start\n                \n                    Test scenarios\n                \n                    Adyen for Platforms API\n                \n","type":"page","locale":"pt","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Classic integration","lvl2":"Platforms integration and go live checklist"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/classic-platforms","lvl2":"\/pt\/classic-platforms\/platforms-integration-checklist"},"levels":3,"category":"Classic Platforms","category_color":"green","tags":["Platforms","integration","checklist"]}}