Ensure both the source and destination balance accounts exist and belong to your Adyen Platforms configuration; retrieve their balance account IDs
POST to the /transfers endpoint specifying the balanceAccountId source and destination, the amount and currency, and a category of internal to indicate an intra-platform transfer
Include a reference string for reconciliation and set the description for the statement line
Subscribe to the balancePlatform.transfer.created and balancePlatform.transfer.updated webhook events to track transfer status asynchronously
When the transfer status transitions to booked, update your internal ledger to reflect the movement between the two balance accounts
For cross-currency transfers between balance accounts, include the conversion object in the transfer request to lock an FX rate
Known gotchas
Balance transfers between accounts in different currencies require FX capability to be enabled on your Adyen Platforms configuration; transfers without it will fail
The source balance account must have sufficient available balance at the time of transfer; partial transfers are not supported and the entire transfer will fail if funds are insufficient
Internal balance transfers do not generate external bank movements; use them only for moving funds within your Adyen Platforms ecosystem, not for paying out to external accounts
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp