{"title":"Process online payments","category":"default","creationDate":1676564580,"content":"<p>With an Adyen for Platforms integration, you can process online transactions on behalf of your users using Adyen's payment processing platform. For each transaction you process, you can split the funds between your users' balance accounts and your liable balance account, and deduct fees and costs as needed.<\/p>\n<h2>Requirements<\/h2>\n<p>Take into account the following requirements, limitations, and preparations to start processing payments.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Requirement<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><strong>Integration&nbsp;type<\/strong><\/td>\n<td style=\"text-align: left;\">You must have an Adyen <a href=\"\/pt\/online-payments\/build-your-integration\">online payments integration and a checkout UI<\/a>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong><a href=\"\/pt\/development-resources\/api-credentials\/\">API credentials<\/a><\/strong><\/td>\n<td style=\"text-align: left;\">You must have credentials for the following APIs:<ul><li markdown=\"1\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/overview\" class=\" external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Checkout API<\/a><\/li><li markdown=\"1\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers\/latest\/overview\" class=\" external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Transfers API<\/a><\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong><a href=\"\/pt\/development-resources\/webhooks\">Webhooks<\/a><\/strong><\/td>\n<td style=\"text-align: left;\">Ensure that your server can receive and accept <a href=\"\/pt\/development-resources\/webhooks\">standard webhooks<\/a>.<br>Subscribe to any of the following webhooks:<ul><li markdown=\"1\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfer-webhooks\/latest\/overview\" class=\" external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Transfer webhooks<\/a><\/li><li markdown=\"1\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transaction-webhooks\/latest\/overview\" class=\" external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Transaction webhooks<\/a><\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong><a href=\"\/pt\/platforms\/verification-overview\/capabilities\">Capabilities<\/a><\/strong><\/td>\n<td style=\"text-align: left;\">Make sure that your account holders have the following capabilities:<ul><li markdown=\"1\"><strong>receivePayments<\/strong><\/li><li markdown=\"1\"><strong>receiveFromPlatformPayments<\/strong><\/li><li markdown=\"1\"><strong>sendToTransferInstrument<\/strong><\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Limitations<\/strong><\/td>\n<td style=\"text-align: left;\">If an account holder does not have the <strong>receiveFromPlatformPayments<\/strong> capability in a <strong>valid<\/strong> state, the funds cannot be allocated to their balance account. The full amount is booked to your liable balance account.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <strong>Setup steps<\/strong><\/td>\n<td style=\"text-align: left;\">When you build your online payments integration, choose between the following server-side flows:<ul><li markdown=\"1\"><strong>[Sessions flow]<\/strong> (\/online-payments\/build-your-integration\/sessions-flow): your server makes a single Checkout API request to the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/sessions\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/sessions<\/a> endpoint.<\/li><li markdown=\"1\"><strong>[Advanced flow]<\/strong> (\/online-payments\/build-your-integration\/advanced-flow): your server makes three Checkout API requests to the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/paymentMethods\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/paymentMethods<\/a>,  <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>, and  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments\/details\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/payments\/details<\/a> endpoints.<\/li><\/ul>The advanced flow supports more use cases. However, sessions is the default integration that we recommend and that meets the requirements of most online payments integrations.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"split-online-transactions\">Split transactions<\/h2>\n<p>To make sure that the pay-in, settlement, and payout processes run smoothly for all users' transactions, you must book the funds and fees to the correct balance accounts.<\/p>\n<p>This means that you must define instructions about how to split the funds between your user's balance accounts and your platform's liable balance account. You can define these instructions in the following ways:<\/p>\n<ul>\n<li>Automatically split all transactions processed through your user's store by setting up <a href=\"\/pt\/platforms\/automatic-split-configuration\">split configuration profiles<\/a>.<\/li>\n<li>Split transactions by defining instructions for each API request. The instructions you provide in your API requests override the instructions you defined in your split configuration profiles.<\/li>\n<\/ul>\n<p>If you do not provide any split instructions in a split configuration profile or through an API request, the whole transaction amount and fees are booked to your liable balance account.<\/p>\n<p>For more information, see <a href=\"\/pt\/platforms\/online-payments\/split-transactions\">Split transactions<\/a>.<\/p>\n<h2>Flow of funds<\/h2>\n<p>The following diagram shows the flow of funds from the moment your user's customer pays to when your user's and your platform's funds are paid out.<\/p>\n<p><a rel=\"lightbox\" href=\"\/user\/pages\/docs\/05.platforms\/23.online-payments\/platform_ecom.svg\" src=\"\">\n  <img alt=\"\" src=\"\/user\/pages\/docs\/05.platforms\/23.online-payments\/platform_ecom.svg\" \/>\n<\/a><\/p>\n<ol>\n<li>The customer pays USD 400.00 for the goods or services.<\/li>\n<li>The payment is processed through Adyen's payment processing platform.<\/li>\n<li>Based on the split instructions included in the payment request, we book the following amounts to the balance accounts in your balance platform:\n<ul>\n<li>USD 396.00 credited to your user's balance account<\/li>\n<li>USD 4.00 credited to your liable balance account as your commission<\/li>\n<li>USD 2.00 deducted from your liable balance account as the transaction fees<\/li>\n<\/ul><\/li>\n<li>The funds from the payment and commission settle in your user's balance account and in your liable balance account, respectively.<\/li>\n<li>The funds are paid out:\n<ul>\n<li>The remaining USD 2.00 to your <span class=\"tooltip hint--top\" data-hint=\"A bank account verified by Adyen.\">transfer instrument<\/span><\/li>\n<li>USD 396.00 to your user's transfer instrument<\/li>\n<\/ul><\/li>\n<\/ol>","url":"https:\/\/docs.adyen.com\/pt\/platforms\/online-payments","articleFields":{"description":"Learn how to process online payments on behalf of your users.","feedback_component":true,"next_steps":[{"title":"Split transactions manually","description":"Learn how to manually split each online transaction in your platform.","url":"\/platforms\/online-payments\/split-transactions","required":false},{"title":"Split transactions automatically","description":"Learn how to configure automatic payment splits in your platform.","url":"\/platforms\/automatic-split-configuration","required":false}],"id":"25142904","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"28-04-2023 17:05","filters_component":false,"parameters":{"directoryPath":"\/platforms","model":"platform","channel":"ecom","pageType":"overview"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/platforms\/online-payments","title":"Process online payments","content":"With an Adyen for Platforms integration, you can process online transactions on behalf of your users using Adyen's payment processing platform. For each transaction you process, you can split the funds between your users' balance accounts and your liable balance account, and deduct fees and costs as needed.\nRequirements\nTake into account the following requirements, limitations, and preparations to start processing payments.\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration&nbsp;type\nYou must have an Adyen online payments integration and a checkout UI.\n\n\nAPI credentials\nYou must have credentials for the following APIs: Checkout API Transfers API\n\n\nWebhooks\nEnsure that your server can receive and accept standard webhooks.Subscribe to any of the following webhooks: Transfer webhooks Transaction webhooks\n\n\nCapabilities\nMake sure that your account holders have the following capabilities:receivePaymentsreceiveFromPlatformPaymentssendToTransferInstrument\n\n\nLimitations\nIf an account holder does not have the receiveFromPlatformPayments capability in a valid state, the funds cannot be allocated to their balance account. The full amount is booked to your liable balance account.\n\n\n Setup steps\nWhen you build your online payments integration, choose between the following server-side flows:[Sessions flow] (\/online-payments\/build-your-integration\/sessions-flow): your server makes a single Checkout API request to the  \/sessions endpoint.[Advanced flow] (\/online-payments\/build-your-integration\/advanced-flow): your server makes three Checkout API requests to the  \/paymentMethods,  \/payments, and  \/payments\/details endpoints.The advanced flow supports more use cases. However, sessions is the default integration that we recommend and that meets the requirements of most online payments integrations.\n\n\n\nSplit transactions\nTo make sure that the pay-in, settlement, and payout processes run smoothly for all users' transactions, you must book the funds and fees to the correct balance accounts.\nThis means that you must define instructions about how to split the funds between your user's balance accounts and your platform's liable balance account. You can define these instructions in the following ways:\n\nAutomatically split all transactions processed through your user's store by setting up split configuration profiles.\nSplit transactions by defining instructions for each API request. The instructions you provide in your API requests override the instructions you defined in your split configuration profiles.\n\nIf you do not provide any split instructions in a split configuration profile or through an API request, the whole transaction amount and fees are booked to your liable balance account.\nFor more information, see Split transactions.\nFlow of funds\nThe following diagram shows the flow of funds from the moment your user's customer pays to when your user's and your platform's funds are paid out.\n\n  \n\n\nThe customer pays USD 400.00 for the goods or services.\nThe payment is processed through Adyen's payment processing platform.\nBased on the split instructions included in the payment request, we book the following amounts to the balance accounts in your balance platform:\n\nUSD 396.00 credited to your user's balance account\nUSD 4.00 credited to your liable balance account as your commission\nUSD 2.00 deducted from your liable balance account as the transaction fees\n\nThe funds from the payment and commission settle in your user's balance account and in your liable balance account, respectively.\nThe funds are paid out:\n\nThe remaining USD 2.00 to your transfer instrument\nUSD 396.00 to your user's transfer instrument\n\n","type":"page","locale":"pt","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Platforms","lvl2":"Process online payments"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/platforms","lvl2":"\/pt\/platforms\/online-payments"},"levels":3,"category":"Platforms","category_color":"green","tags":["Process","online","payments"]},"articleFiles":{"platform_ecom.svg":"<img alt=\"\" src=\"https:\/\/docs.adyen.com\/user\/pages\/docs\/05.platforms\/23.online-payments\/platform_ecom.svg\" \/>"}}
