Before you get started building a point of sale integration, you will need to choose an integration architecture. This will determine how your integration connects to the Adyen payments platform.
We offer two integration architectures for our Terminal API:
- Local communications: Your cash register communicates directly with the terminal over your local network.
- Cloud communications: Your cash register communicates with the terminal through the Adyen payments platform.
If you don't need a fully featured API integration, we also offer a Standalone terminal solution.
Your cash register communicates directly with the terminal over your local network. To make a payment, you make an API request directly to the IP address of the terminal, for the shopper to complete the transaction. You receive the result of the payment synchronously.
Our local communications integration supports Offline EMV and Store-and-forward transactions. This means you can continue making transactions when you experience network issues in-store.
If your existing point of sale system is cloud-based, you may prefer to integrate using cloud communications.
With a cloud-based integration, your cash register communicates with the terminal over the internet. To make a payment, you make an API request to the Adyen payments platform. This request is forwarded to the terminal, for the shopper to complete the transaction. You can choose whether you want to receive the result of the payments either synchronously or asynchronously.
Unlike our local communications integration, a cloud integration does not support Offline EMV or Store-and-forward transactions. This means you will not be able to make transactions when your store experiences network issues.
Choose your integration
Once you've determined your architecture, you can start building your integration.