--- title: "Receive funds" description: "Receive funds from your pay-in partner in your multi pay-in account." url: "https://docs.adyen.com/marketplaces/multi-pay-in/receive-funds" source_url: "https://docs.adyen.com/marketplaces/multi-pay-in/receive-funds.md" canonical: "https://docs.adyen.com/marketplaces/multi-pay-in/receive-funds" last_modified: "2026-05-08T17:09:18+02:00" language: "en" --- # Receive funds Receive funds from your pay-in partner in your multi pay-in account. 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](https://docs.adyen.com/api-explorer/transfer-webhooks/latest/post/balancePlatform.transfer.created) | Notifies you of the incoming fund transfer. | | [balancePlatform.transfer.updated](https://docs.adyen.com/api-explorer/transfer-webhooks/latest/post/balancePlatform.transfer.updated) | Notifies you of the changes in the status of the transfer. | | [balancePlatform.transaction.created](https://docs.adyen.com/api-explorer/transaction-webhooks/latest/post/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](https://ca-test.adyen.com/). ### 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](https://docs.adyen.com/api-explorer/transfer-webhooks/latest/post/balancePlatform.transfer.created#request-data-category) | Specifies the category of the transfer. | **bank** | | [direction](https://docs.adyen.com/api-explorer/transfer-webhooks/latest/post/balancePlatform.transfer.created#request-data-direction) | The direction of the transfer, based on the multi pay-in account. | **incoming** | | [type](https://docs.adyen.com/api-explorer/transfer-webhooks/latest/post/balancePlatform.transfer.created#request-data-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](https://docs.adyen.com/api-explorer/transfer-webhooks/latest/post/balancePlatform.transfer.created) webhook with `direction` **incoming** and `status` **received**. **Incoming bank transfer received** ```json { "data": { "accountHolder": { "description": "Your description for your liable account holder", "id": "AH00000000000000000LIABLE", "reference": "Your reference for your liable account holder" }, "amount": { "currency": "USD", "value": 10000 }, "balanceAccount": { "description": "Your description for your multi pay-in account", "id": "BA00000000000000000000005", "reference": "Your description for your multi pay-in account" }, "balancePlatform": "YOUR_BALANCE_PLATFORM", "balances": [ { "currency": "USD", "received": 10000 } ], "category": "bank", "creationDate": "2024-08-28T13:30:05+02:00", "description": "Your pay-in partner's description for the transfer", "direction": "incoming", "events": [ { "bookingDate": "2024-08-28T13:30:18+02:00", "id": "EVJN00000000000000000000000001", "mutations": [ { "currency": "USD", "received": 10000 } ], "status": "received", "type": "accounting", "valueDate": "2024-09-01T12:58:25+01:00" } ], "id": "2KT1M09KXYPP6XWN", "reason": "approved", "reference": "Your pay-in partner's reference for the transfer", "referenceForBeneficiary": "Your pay-in partner's reference for you", "sequenceNumber": 1, "status": "received", "type": "bankTransfer" }, "environment": "test", "type": "balancePlatform.transfer.created" } ``` ** ### 2. Transfer authorized When the transfer request is authorized, we send you a [balancePlatform.transfer.updated](https://docs.adyen.com/api-explorer/transfer-webhooks/latest/post/balancePlatform.transfer.updated) webhook with `status` **authorised**. **Incoming bank transfer authorized** ```json { "data": { "accountHolder": { "description": "Your description for your liable account holder", "id": "AH00000000000000000LIABLE", "reference": "Your reference for your liable account holder" }, "amount": { "currency": "USD", "value": 10000 }, "balanceAccount": { "description": "Your description for your multi pay-in account", "id": "BA00000000000000000000005", "reference": "Your reference for your multi pay-in account" }, "balancePlatform": "YOUR_BALANCE_PLATFORM", "balances": [ { "currency": "USD", "received": 0, "reserved": 10000 } ], "category": "bank", "creationDate": "2024-08-28T13:30:05+02:00", "description": "Your pay-in partner's description for the transfer", "direction": "incoming", "events": [ { "bookingDate": "2024-08-28T13:30:18+02:00", "id": "EVJN00000000000000000000000001", "mutations": [ { "currency": "USD", "received": 10000 } ], "status": "received", "type": "accounting", "valueDate": "2024-09-01T12:58:25+01:00" }, { "bookingDate": "2024-08-28T13:30:18+02:00", "id": "EVJN00000000000000000000000002", "mutations": [ { "currency": "USD", "received": -10000, "reserved": 10000 } ], "status": "authorised", "type": "accounting", "valueDate": "2024-09-01T12:58:25+01:00" } ], "id": "2KT1M09KXYPP6XWN", "reason": "approved", "reference": "Your pay-in partner's reference for the transfer", "referenceForBeneficiary": "Your pay-in partner's reference for you", "sequenceNumber": 2, "status": "received", "type": "bankTransfer" }, "environment": "test", "type": "balancePlatform.transfer.updated" } ``` ** ### 3. Transfer booked When the funds are credited to your multi pay-in account, we send you a [balancePlatform.transfer.updated](https://docs.adyen.com/api-explorer/transfer-webhooks/latest/post/balancePlatform.transfer.updated) webhook with `status` **booked** and the `transactionId`. **Incoming bank transfer booked** ```json { "data": { "accountHolder": { "description": "Your description for your liable account holder", "id": "AH00000000000000000LIABLE", "reference": "Your reference for your liable account holder" }, "amount": { "currency": "USD", "value": 10000 }, "balanceAccount": { "description": "Your description for your multi pay-in account", "id": "BA00000000000000000000005", "reference": "Your description for your multi pay-in account" }, "balancePlatform": "YOUR_BALANCE_PLATFORM", "balances": [ { "balance": 10000, "currency": "USD", "received": 0, "reserved": 0 } ], "category": "bank", "creationDate": "2024-08-28T13:30:05+02:00", "description": "Your pay-in partner's description for the payout", "direction": "incoming", "events": [ { "bookingDate": "2024-08-28T13:30:18+02:00", "id": "EVJN00000000000000000000000001", "mutations": [ { "currency": "USD", "received": 10000 } ], "status": "received", "type": "accounting", "valueDate": "2024-09-01T12:58:25+01:00" }, { "bookingDate": "2024-08-28T13:30:18+02:00", "id": "EVJN00000000000000000000000002", "mutations": [ { "currency": "USD", "received": -10000, "reserved": 10000 } ], "status": "authorised", "type": "accounting", "valueDate": "2024-09-01T12:58:25+01:00" }, { "bookingDate": "2024-08-28T13:30:18+02:00", "id": "EVJN00000000000000000000000003", "mutations": [ { "balance": 10000, "currency": "USD", "received": 0, "reserved": -10000 } ], "status": "booked", "transactionId": "1WT1N05XXY7P9XGB", "type": "accounting", "valueDate": "2024-09-01T12:58:25+01:00" } ], "id": "2KT1M09KXYPP6XWN", "reason": "approved", "reference": "Your pay-in partner's reference for the payout", "referenceForBeneficiary": "Your pay-in partner's reference for you", "sequenceNumber": 3, "transactionRulesResult": { "allHardBlockRulesPassed": true }, "status": "booked", "transactionId": "EVJN42272224222B5JB8BRC84N686ZUSD", "type": "bankTransfer" }, "environment": "test", "type": "balancePlatform.transfer.updated" } ``` ** ### 4. Transaction booked When the funds are credited to your multi pay-in account, we send you a [balancePlatform.transaction.created](https://docs.adyen.com/api-explorer/transaction-webhooks/latest/post/balancePlatform.transaction.created) webhook with information about the related transfer. **Transaction booked** ```json { "data": { "id": "EVJN42272224222B5JB8BRC84N686ZUSD", "amount": { "value": 10000, "currency": "USD" }, "status": "booked", "transfer": { "id": "2KT1M09KXYPP6XWN", "reference": "Your pay-in partner's reference for the payout" }, "valueDate": "2024-09-01T12:58:25+01:00", "bookingDate": "2024-08-28T13:30:18+02:00", "creationDate": "2024-08-28T13:30:05+02:00", "accountHolder": { "id": "AH00000000000000000LIABLE", "description": "Your description for your liable account holder", "reference": "Your reference for your liable account holder" }, "balanceAccount": { "id": "BA00000000000000000000005", "description": "Your description for your multi pay-in account" }, "balancePlatform": "YOUR_BALANCE_PLATFORM" }, "type": "balancePlatform.transaction.created", "environment": "test" } ``` ## Next steps [Top up multi pay-in account](/marketplaces/multi-pay-in/refunds) [Top up the balance of your multi pay-in account with funds from your liable balance account.](/marketplaces/multi-pay-in/refunds) [required](/marketplaces/multi-pay-in/payments) [Allocate third-party payments](/marketplaces/multi-pay-in/payments) [Transfer and allocate funds using multi pay-in.](/marketplaces/multi-pay-in/payments) [required](/marketplaces/multi-pay-in/refunds) [Refund third-party payments](/marketplaces/multi-pay-in/refunds) [Refund payments processed through a pay-in partner.](/marketplaces/multi-pay-in/refunds)