With multi pay-in, you receive payouts from your third-party acquirer or payment service provider (pay-in partner) in an account linked to your balance platform. This is account is your multi pay-in account, which we set up exclusively to serve as a link between your pay-in partner and your balance accounts at Adyen.
Multi pay-in accounts
Multi pay-in accounts are created and legally held by Adyen solely for your users' benefit. This account holds their funds before you allocate them to their balance accounts in your balance platform.
You must set your multi pay-in account as the payout account for your pay-in partner.
We add the bank account of your pay-in partner to an allowlist, and automatically rejects any other bank transfers to your multi pay-in account.
Depending on your region and processing currency, your multi pay-in account's account number can have the following formats:
| Currency | Country/region | Format | Example |
|---|---|---|---|
| EUR | Netherlands (eurozone) | 18-digit IBAN | NL12ADYB0123456789 |
| GBP | United Kingdom | 22-digit IBAN | GB37ADYX04295720004111 |
| USD | United States | 8-17 digit account number | Account number: 333720756 Routing number: 121045274 |
Get notified about incoming funds
After you set your multi pay-in account as the payout account for your pay-in partner, we send you the following webhooks to notify you of the incoming funds and the status of the transfer or transaction:
| Webhook | Description |
|---|---|
| balancePlatform.transfer.created | Notifies you of the incoming fund transfer. |
| balancePlatform.transfer.updated | Notifies you of the changes in the status of the transfer. |
| balancePlatform.transaction.created | Notifies you that the funds are credited to your multi pay-in account. |
Subscribe to the webhooks you want to receive in your Customer Area.
Webhooks for incoming funds
You can identify transfer webhooks triggered when funds arrive to your multi pay-in account from your pay-in partner by the following values:
| Parameter | Description | Value |
|---|---|---|
| category | Specifies the category of the transfer. | bank |
| direction | The direction of the transfer, based on the multi pay-in account. | incoming |
| type | Specifies the type of the transfer. | bankTransfer |
The following examples show the webhooks we send when your pay-in partner sends a USD 100.00 bank transfer to your multi pay-in account.
1. Transfer received
When your pay-in partner pays out to your multi pay-in account, we send you a balancePlatform.transfer.created webhook with direction incoming and status received.
2. Transfer authorized
When the transfer request is authorized, we send you a balancePlatform.transfer.updated webhook with status authorised.
3. Transfer booked
When the funds are credited to your multi pay-in account, we send you a balancePlatform.transfer.updated webhook with status booked and the transactionId.
4. Transaction booked
When the funds are credited to your multi pay-in account, we send you a balancePlatform.transaction.created webhook with information about the related transfer.