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.
Prerequisites
Before you can start processing transactions on behalf of your users, you must:
- Integrate your POS app with Adyen's terminals and Terminal API. When you build a point-of-sale integration with Adyen, you must take action on the following topics:
- Account structure : Choose how to represent the physical locations (stores) where you take in-person payments in your Adyen account. You can create and add stores to your Adyen merchant accounts.
- Terminal models : Choose the types of terminals you want your users to use, as well as the way they connect to the internet.
- Integration architecture : Choose how your POS system communicates with your terminals – over the local network or through the cloud.
- Network and connectivity configuration : Choose and configure your network and assign IP addresses to your terminals.
- Terminal API : Get familiar with the endpoints and message structure of Terminal API.
- Point-of-sale notifications and webhooks : To receive transaction updates, configure and subscribe to point-of-sale notifications and webhooks.
- Configure payment methods for the stores in your platform.
- Ensure that your server can receive and accept payment webhooks specific to your platform.
- Have API credentials for the Terminal API. You can generate your API key from your Customer Area.
Send split instructions
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 you must define instructions on how to split the funds between your user's balance accounts and your platform's liable balance account. You can either define these instructions in the following ways:
- Automatically split all transactions processed through a specific store by setting up split configuration profiles.
- Split specific transactions by defining instructions manually for each API request you send.
The instructions you provide in your API requests override the instructions you defined in your split configuration profiles.
If you do not provide any split instructions, the whole transaction is booked to your platform's liable balance account, including all associated fees.
For more information, see Split transactions.