{"title":"Process 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\/marketplaces\/verification-overview\/capabilities\">Capabilities<\/a><\/strong><\/td>\n<td style=\"text-align: left;\">Make sure that your account holders have the following capability in a <a href=\"\/pt\/marketplaces\/verification-overview\/capabilities#verification-status-of-a-capability\">valid<\/a> state:<ul><li markdown=\"1\"><strong>receiveFromPlatformPayments<\/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>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. This means that in each individual payment, capture, and refund request that you send on behalf of your users, you have to include instructions on how to split the funds between your user's balance accounts and your marketplace's liable balance account.<\/p>\n<p>If you do not provide any split instructions in a split configuration profile or through and 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\/marketplaces\/split-transactions\">Split transactions<\/a>.<\/p>\n<h2>Fund settlement<\/h2>\n<p>After processing transactions for your users, Adyen settles the funds to the balance accounts in your marketplace according to the split instructions you defined. On each balance account, you can configure settlement models that define how the sales funds are settled to your users' transfer instruments.<\/p>\n<p>For more information, see <a href=\"\/pt\/marketplaces\/settle-funds\">Settle funds<\/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 marketplace's funds are paid out.<\/p>\n<p><a rel=\"lightbox\" href=\"\/user\/pages\/docs\/04.marketplaces\/19.process-payments\/marketplace_split_funds.svg\" src=\"\">\n  <img alt=\"\" src=\"\/user\/pages\/docs\/04.marketplaces\/19.process-payments\/marketplace_split_funds.svg\" \/>\n<\/a><\/p>\n<ol>\n<li>The customer pays USD 400.00 for the goods or services.<br \/>\nThe 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 accounts as the transaction fees<\/li>\n<\/ul><\/li>\n<li>Depending on your payout schedule, we pay out the funds:\n<ul>\n<li>USD 396.00 to your user's <span class=\"tooltip hint--top\" data-hint=\"A bank account verified by Adyen.\">transfer instrument<\/span><\/li>\n<li>USD 2.00 to your transfer instrument<\/li>\n<\/ul><\/li>\n<\/ol>\n<h2>Webhooks<\/h2>\n<p>Adyen sends webhooks to inform you of payment-related events that occur in your marketplace. Subscribe to the  <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> and  <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> to keep track of these events and their status.<\/p>\n<h2>See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/marketplaces\/checkout-components\"\n                        target=\"_self\"\n                        >\n                    Checkout components\n                <\/a><\/li><li><a href=\"\/marketplaces\/payment-methods\"\n                        target=\"_self\"\n                        >\n                    Payment methods\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/marketplaces\/process-payments","articleFields":{"description":"Learn how to enable your users to accept payments, and how split them between balance account in your platform.","section_label":"Process payments","feedback_component":true,"next_steps":[{"title":"Split payments at authorization","description":"Learn how to split a transaction at the time of payment.","url":"\/marketplaces\/split-transactions\/split-payments-at-authorization","required":true},{"title":"Split payments at capture","description":"Learn how to split a transaction at the time of capture.","url":"\/marketplaces\/split-transactions\/split-payments-at-capture","required":false}],"id":"25142904","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"28-04-2023 17:05","filters_component":false,"parameters":{"directoryPath":"\/marketplaces","model":"marketplace","pageType":"overview","channel":"ecom"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/marketplaces\/process-payments","title":"Process 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 capability in a valid state:receiveFromPlatformPayments\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. This means that in each individual payment, capture, and refund request that you send on behalf of your users, you have to include instructions on how to split the funds between your user's balance accounts and your marketplace's liable balance account.\nIf you do not provide any split instructions in a split configuration profile or through and API request, the whole transaction amount and fees are booked to your liable balance account.\nFor more information, see Split transactions.\nFund settlement\nAfter processing transactions for your users, Adyen settles the funds to the balance accounts in your marketplace according to the split instructions you defined. On each balance account, you can configure settlement models that define how the sales funds are settled to your users' transfer instruments.\nFor more information, see Settle funds.\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 marketplace'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 accounts as the transaction fees\n\nDepending on your payout schedule, we pay out the funds:\n\nUSD 396.00 to your user's transfer instrument\nUSD 2.00 to your transfer instrument\n\n\nWebhooks\nAdyen sends webhooks to inform you of payment-related events that occur in your marketplace. Subscribe to the  Transfer webhooks and  Transaction webhooks to keep track of these events and their status.\nSee also\n\n\n                    Checkout components\n                \n                    Payment methods\n                \n","type":"page","locale":"pt","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Marketplaces","lvl2":"Process payments"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/marketplaces","lvl2":"\/pt\/marketplaces\/process-payments"},"levels":3,"category":"Marketplaces","category_color":"green","tags":["Process","payments"]},"articleFiles":{"marketplace_split_funds.svg":"<img alt=\"\" src=\"https:\/\/docs.adyen.com\/user\/pages\/docs\/04.marketplaces\/19.process-payments\/marketplace_split_funds.svg\" \/>"}}
