{"title":"Process in-person payments","category":"default","creationDate":1678203060,"content":"<p>With an Adyen for Platforms integration, you can process in-person transactions at the point of sale 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 in-person 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;\">For in-person payments with Adyen, your POS app must be integrated with the <a href=\"\/pt\/point-of-sale\/design-your-integration\/terminal-api\">Terminal API<\/a> and then either use <a href=\"\/pt\/point-of-sale\/what-we-support\/select-your-terminals\">payment terminals<\/a> or a <a href=\"\/pt\/point-of-sale\/ipp-mobile\">Mobile solution<\/a>. The <a href=\"\/pt\/point-of-sale\/standalone\">standalone solution<\/a> can serve as a fallback.<\/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  <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>. <br>Additional API credentials depend on the in-person payments integration type. Refer to the relevant integration instructions.<\/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\"><span translate=\"no\"><strong>receivePayments<\/strong><\/span><\/li> <li markdown=\"1\"><span translate=\"no\"><strong>receiveFromPlatformPayments<\/strong><\/span><\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Limitations<\/strong><\/td>\n<td style=\"text-align: left;\">The standalone solution supports split configuration profiles, but does not support splitting individual payment or refund requests.<\/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 a point-of-sale integration with Adyen, you must take action on the topics mentioned in <a href=\"\/pt\/point-of-sale\/design-your-integration\">Design your integration<\/a> and the requirements and checklists for the type of integration: <ul><li markdown=\"1\">For Terminal API with payment terminals, see <a href=\"\/pt\/point-of-sale\/get-started\">Integration overview<\/a>.<\/li> <li markdown=\"1\">For an Android Mobile solution, see the <a href=\"\/pt\/point-of-sale\/mobile-android\/requirements\">Android system requirements<\/a> and the <a href=\"\/pt\/point-of-sale\/mobile-android\/checklists\">Android checklists<\/a>.<\/li> <li markdown=\"1\">For an iOS Mobile solution, see the <a href=\"\/pt\/point-of-sale\/mobile-ios\/requirements\">iOS system requirements<\/a> and the <a href=\"\/pt\/point-of-sale\/mobile-ios\/checklists\">iOS checklists<\/a>.<\/li> <li markdown=\"1\">For standalone, see <a href=\"\/pt\/point-of-sale\/standalone\/standalone-build\">Build a standalone solution<\/a>.<\/li><\/ul><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"split-in-person-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\/in-person-payments\/split-transactions\">Split transactions<\/a>.<\/p>\n<h3>Split transactions and integration type<\/h3>\n<p>In a Terminal API integration with either payment terminals or a Mobile solution, you can use both ways to provide split instructions.<\/p>\n<p>If you use the standalone solution, either as a fallback for network connection issues or as a way to get started with in-person payments, be aware that this only supports split configuration profiles. On a standalone terminal it is not possible to provide split instructions for individual request.<\/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\/24.in-person-payments\/platform_pos.svg\" src=\"\">\n  <img alt=\"\" src=\"\/user\/pages\/docs\/05.platforms\/24.in-person-payments\/platform_pos.svg\" \/>\n<\/a><\/p>\n<ol>\n<li>The customer pays USD 620.00 for the goods or services at your user's store.<\/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 600.00 credited to your user's balance account<\/li>\n<li>USD 20.00 credited to your liable balance account as your commission<\/li>\n<li>USD 5.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>USD 600.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 15.00 to your transfer instrument<\/li>\n<\/ul><\/li>\n<\/ol>","url":"https:\/\/docs.adyen.com\/pt\/platforms\/in-person-payments","articleFields":{"description":"Process in-person payments on behalf of your users.","feedback_component":true,"last_edit_on":"07-03-2023 16:31","parameters":{"directoryPath":"\/platforms","model":"platform","channel":"pos"},"next_steps":[{"title":"Split transactions manually","description":"Learn how to manually split each in-person transaction in your platform.","url":"\/platforms\/in-person-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}]},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/platforms\/in-person-payments","title":"Process in-person payments","content":"With an Adyen for Platforms integration, you can process in-person transactions at the point of sale 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 in-person payments.\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration&nbsp;type\nFor in-person payments with Adyen, your POS app must be integrated with the Terminal API and then either use payment terminals or a Mobile solution. The standalone solution can serve as a fallback.\n\n\nAPI credentials\nYou must have credentials for the  Transfers API. Additional API credentials depend on the in-person payments integration type. Refer to the relevant integration instructions.\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: receivePayments receiveFromPlatformPayments\n\n\nLimitations\nThe standalone solution supports split configuration profiles, but does not support splitting individual payment or refund requests.\n\n\nSetup steps\nWhen you build a point-of-sale integration with Adyen, you must take action on the topics mentioned in Design your integration and the requirements and checklists for the type of integration: For Terminal API with payment terminals, see Integration overview. For an Android Mobile solution, see the Android system requirements and the Android checklists. For an iOS Mobile solution, see the iOS system requirements and the iOS checklists. For standalone, see Build a standalone solution.\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.\nSplit transactions and integration type\nIn a Terminal API integration with either payment terminals or a Mobile solution, you can use both ways to provide split instructions.\nIf you use the standalone solution, either as a fallback for network connection issues or as a way to get started with in-person payments, be aware that this only supports split configuration profiles. On a standalone terminal it is not possible to provide split instructions for individual request.\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 620.00 for the goods or services at your user's store.\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 600.00 credited to your user's balance account\nUSD 20.00 credited to your liable balance account as your commission\nUSD 5.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\nUSD 600.00 to your user's transfer instrument\nUSD 15.00 to your transfer instrument\n\n","type":"page","locale":"pt","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Platforms","lvl2":"Process in-person payments"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/platforms","lvl2":"\/pt\/platforms\/in-person-payments"},"levels":3,"category":"Platforms","category_color":"green","tags":["Process","in-person","payments"]},"articleFiles":{"platform_pos.svg":"<img alt=\"\" src=\"https:\/\/docs.adyen.com\/user\/pages\/docs\/05.platforms\/24.in-person-payments\/platform_pos.svg\" \/>"}}
