Design your integration

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.

Requirements

Before you begin, check if the information on this page applies to you.

Requirement	Description
Integration type	The information on this page is relevant if you want to set up in-person payments with Adyen.

Account structure

All solutions.
The 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.

Terminal models

Terminal API integration and standalone solution with payment terminals.
Mobile solutions.
You 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.

Local or cloud communications

Terminal API integration.
Standalone solution, Mobile solutions.
You 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.

Network and connectivity configuration

Terminal API integration.
Standalone solution, Mobile solutions.
To 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.

Terminal API

Terminal API integration, Mobile solutions.
Standalone solution.
For 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.

Notifications and webhooks

Webhooks: Terminal API integration, Mobile solutions. Terminal notifications: Terminal API integration with terminals.
Standalone solution.
Both 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.

Next steps

Select a topic to view an explanation of your options and/or implementation instructions.