{"title":"Design your integration","category":"default","creationDate":1702991340,"content":"<p>Before building a point-of-sale integration with Adyen, there are some topics you need to know about so you can make the right choices for your business. This page gives a brief overview of these topics, and indicates for which <a href=\"\/pt\/point-of-sale\/what-we-support\/solutions\">integration solution<\/a> the topic is relevant.<\/p>\n<h2>Requirements<\/h2>\n<p>Before you begin, check if the information on this page applies to you.<\/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 type<\/strong><\/td>\n<td style=\"text-align: left;\">The information on this page is relevant if you want to set up in-person payments with Adyen.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>Account structure<\/h2>\n<p><div data-component-wrapper=\"tag\">\n    <tag :variant=&quot;success&quot;>\n        Applies to:\n    <\/tag>\n<\/div>\n All solutions.<br \/>\nThe stores or other physical locations where you take in-person payments must be represented in your Adyen account. You can add stores to a merchant account, or add a merchant account for each store. The choice you make influences the payout of funds and your reconciliation, among other things.<\/p>\n<h2>Terminal models<\/h2>\n<p><div data-component-wrapper=\"tag\">\n    <tag :variant=&quot;success&quot;>\n        Applies to:\n    <\/tag>\n<\/div>\n Terminal API integration and standalone solution with payment terminals.<br \/>\n<div data-component-wrapper=\"tag\">\n    <tag :variant=&quot;error&quot;>\n        Does not apply to:\n    <\/tag>\n<\/div>\n Mobile solutions.<br \/>\nYou can choose from mobile and portable terminals that can be carried around, stationary countertop and multimedia terminals, and unattended terminals for use in self-service situations. The terminals support one or more connectivity options such as Wi-Fi, Ethernet, and cellular, and for all use cases there is an Android all-in-one model available.<\/p>\n<h2>Local or cloud communications<\/h2>\n<p><div data-component-wrapper=\"tag\">\n    <tag :variant=&quot;success&quot;>\n        Applies to:\n    <\/tag>\n<\/div>\n Terminal API integration.<br \/>\n<div data-component-wrapper=\"tag\">\n    <tag :variant=&quot;error&quot;>\n        Does not apply to:\n    <\/tag>\n<\/div>\n Standalone solution, Mobile solutions.<br \/>\nYou can let your POS system communicate with the terminals over your local network or through the cloud. Either choice has advantages and disadvantages. For example, cloud communications is a natural choice for mobile or portable terminals. But when the internet connection drops, you cannot process payments unless you have implemented a fallback.<\/p>\n<h2>Network and connectivity configuration<\/h2>\n<p><div data-component-wrapper=\"tag\">\n    <tag :variant=&quot;success&quot;>\n        Applies to:\n    <\/tag>\n<\/div>\n Terminal API integration.<br \/>\n<div data-component-wrapper=\"tag\">\n    <tag :variant=&quot;error&quot;>\n        Does not apply to:\n    <\/tag>\n<\/div>\n Standalone solution, Mobile solutions.<br \/>\nTo enable communications between your POS system, the terminals, and Adyen, you need to configure your network and assign IP addresses to the terminals. It is also good to be aware of the steps to take for various connectivity types.<\/p>\n<h2>Terminal API<\/h2>\n<p><div data-component-wrapper=\"tag\">\n    <tag :variant=&quot;success&quot;>\n        Applies to:\n    <\/tag>\n<\/div>\n Terminal API integration, Mobile solutions.<br \/>\n<div data-component-wrapper=\"tag\">\n    <tag :variant=&quot;error&quot;>\n        Does not apply to:\n    <\/tag>\n<\/div>\n Standalone solution.<br \/>\nFor a Terminal API integration or a mobile integration, you need to become familiar with the general message structure of Terminal API and the structure of specific requests such as payments and refunds.<\/p>\n<h2>Notifications and webhooks<\/h2>\n<p><div data-component-wrapper=\"tag\">\n    <tag :variant=&quot;success&quot;>\n        Applies to:\n    <\/tag>\n<\/div>\n Webhooks: Terminal API integration, Mobile solutions. Terminal notifications: Terminal API integration with terminals.<br \/>\n<div data-component-wrapper=\"tag\">\n    <tag :variant=&quot;error&quot;>\n        Does not apply to:\n    <\/tag>\n<\/div>\n Standalone solution.<br \/>\nBoth the payment terminals and the plataforma de pagamentos da Adyen generate transaction updates that can be sent to an endpoint on your POS system. You need to decide if your architecture or use cases require receiving these webhooks.<\/p>\n<h2>Next steps<\/h2>\n<p>Select a topic to view an explanation of your options and\/or implementation instructions.<\/p>\n<div style=\"text-align: center;\">\n<div class=\"next-steps\" id=\"next-steps\" >\n<a href=\"\/point-of-sale\/design-your-integration\/determine-account-structure\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><img src=\"\/user\/themes\/adyen\/images\/illustrations\/platforms.svg\"><h6 class=\"next-steps__title\">Account<\/h6><p>Determine your Adyen account structure and create stores.<\/p><\/p><\/a><a href=\"\/point-of-sale\/what-we-support\/select-your-terminals\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><img src=\"\/user\/themes\/adyen\/images\/illustrations\/pos.svg\"><h6 class=\"next-steps__title\">Terminals<\/h6><p>Choose from various payment terminal models.<\/p><\/p><\/a><a href=\"\/point-of-sale\/design-your-integration\/choose-your-architecture\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><img src=\"\/user\/themes\/adyen\/images\/illustrations\/acting.svg\"><h6 class=\"next-steps__title\">Cloud or local?<\/h6><p>Decide on the integration architecture.<\/p><\/p><\/a><a href=\"\/point-of-sale\/design-your-integration\/choose-your-architecture\/local\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><img src=\"\/user\/themes\/adyen\/images\/illustrations\/ethernet.svg\"><h6 class=\"next-steps__title\">Local integration<\/h6><p>Learn how to build an integration with local communications.<\/p><\/p><\/a><a href=\"\/point-of-sale\/design-your-integration\/choose-your-architecture\/cloud\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><img src=\"\/user\/themes\/adyen\/images\/illustrations\/cloud.svg\"><h6 class=\"next-steps__title\">Cloud integration<\/h6><p>Learn how to build an integration with cloud communications.<\/p><\/p><\/a><a href=\"\/point-of-sale\/design-your-integration\/network-and-connectivity\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><img src=\"\/user\/themes\/adyen\/images\/illustrations\/network.svg\"><h6 class=\"next-steps__title\">Network<\/h6><p>Configure your network and implement connectivity options.<\/p><\/p><\/a><a href=\"\/point-of-sale\/design-your-integration\/terminal-api\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><img src=\"\/user\/themes\/adyen\/images\/illustrations\/code.svg\"><h6 class=\"next-steps__title\">Terminal API<\/h6><p>Understand endpoints and message structure.<\/p><\/p><\/a><a href=\"\/point-of-sale\/design-your-integration\/notifications\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><img src=\"\/user\/themes\/adyen\/images\/illustrations\/monitoring.svg\"><h6 class=\"next-steps__title\">Webhooks<\/h6><p>Receive transaction updates on your POS system.<\/p><\/p><\/a><\/div>\n\n<\/div>","url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/design-your-integration","articleFields":{"description":"Learn about the basic choices to make for your in-person payments integration.","last_edit_on":"19-12-2023 14:09","feedback_component":true,"filters_component":false,"decision_tree":"[]","page_id":"9558402e-1844-4816-91c4-5a6a0ed1b075"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/design-your-integration","title":"Design your integration","content":"Before building a point-of-sale integration with Adyen, there are some topics you need to know about so you can make the right choices for your business. This page gives a brief overview of these topics, and indicates for which integration solution the topic is relevant.\nRequirements\nBefore you begin, check if the information on this page applies to you.\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nThe information on this page is relevant if you want to set up in-person payments with Adyen.\n\n\n\nAccount structure\n\n    \n        Applies to:\n    \n\n All solutions.\nThe stores or other physical locations where you take in-person payments must be represented in your Adyen account. You can add stores to a merchant account, or add a merchant account for each store. The choice you make influences the payout of funds and your reconciliation, among other things.\nTerminal models\n\n    \n        Applies to:\n    \n\n Terminal API integration and standalone solution with payment terminals.\n\n    \n        Does not apply to:\n    \n\n Mobile solutions.\nYou can choose from mobile and portable terminals that can be carried around, stationary countertop and multimedia terminals, and unattended terminals for use in self-service situations. The terminals support one or more connectivity options such as Wi-Fi, Ethernet, and cellular, and for all use cases there is an Android all-in-one model available.\nLocal or cloud communications\n\n    \n        Applies to:\n    \n\n Terminal API integration.\n\n    \n        Does not apply to:\n    \n\n Standalone solution, Mobile solutions.\nYou can let your POS system communicate with the terminals over your local network or through the cloud. Either choice has advantages and disadvantages. For example, cloud communications is a natural choice for mobile or portable terminals. But when the internet connection drops, you cannot process payments unless you have implemented a fallback.\nNetwork and connectivity configuration\n\n    \n        Applies to:\n    \n\n Terminal API integration.\n\n    \n        Does not apply to:\n    \n\n Standalone solution, Mobile solutions.\nTo enable communications between your POS system, the terminals, and Adyen, you need to configure your network and assign IP addresses to the terminals. It is also good to be aware of the steps to take for various connectivity types.\nTerminal API\n\n    \n        Applies to:\n    \n\n Terminal API integration, Mobile solutions.\n\n    \n        Does not apply to:\n    \n\n Standalone solution.\nFor a Terminal API integration or a mobile integration, you need to become familiar with the general message structure of Terminal API and the structure of specific requests such as payments and refunds.\nNotifications and webhooks\n\n    \n        Applies to:\n    \n\n Webhooks: Terminal API integration, Mobile solutions. Terminal notifications: Terminal API integration with terminals.\n\n    \n        Does not apply to:\n    \n\n Standalone solution.\nBoth the payment terminals and the plataforma de pagamentos da Adyen generate transaction updates that can be sent to an endpoint on your POS system. You need to decide if your architecture or use cases require receiving these webhooks.\nNext steps\nSelect a topic to view an explanation of your options and\/or implementation instructions.\n\n\nAccountDetermine your Adyen account structure and create stores.TerminalsChoose from various payment terminal models.Cloud or local?Decide on the integration architecture.Local integrationLearn how to build an integration with local communications.Cloud integrationLearn how to build an integration with cloud communications.NetworkConfigure your network and implement connectivity options.Terminal APIUnderstand endpoints and message structure.WebhooksReceive transaction updates on your POS system.\n\n","type":"page","locale":"pt","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Design your integration"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/point-of-sale","lvl2":"\/pt\/point-of-sale\/design-your-integration"},"levels":3,"category":"In-person payments","category_color":"green","tags":["Design","integration"]}}
