Search

Are you looking for test card numbers?

Would you like to contact support?

Marketpay icon

Fund transfer

Transfer funds between accounts using Customer Area or the API.

Depending on your use cases, there might be scenarios that require you to move funds between accounts in your platform. Some examples are if you want to send a bonus, or when it's necessary to transfer funds from one account holder's account to another.

You can transfer funds between accounts using:

After the funds have been transferred, you can also fully or partially refund a funds transfer using an API request.

Before you begin

Before you can transfer funds or refund a fund transfer, you must:

  1. Contact our Support Team to enable fund transfers and define your transfer codes. These codes specify the reason for the transfer and must be defined for your platform in compliance with local regulations.

  2. Set up notification webhooks for event types TRANSFER_FUNDS and REFUND_FUNDS_TRANSFER. Fund transfers and refund fund transfers are processed asynchronously, so you must rely on webhooks to know the outcome of your requests.

Transfer funds through the API

You can use the /transferFunds endpoint to programmatically initiate a fund transfer. In your POST request, specify:

Parameter Required Description
sourceAccountCode -white_check_mark- The code of the account from which the funds are to be debited. The status of the account's account holder be Active and payouts must be allowed.
destinationAccountCode -white_check_mark- The code of the account to which the funds are to be credited. The status of the account's account holder must be Active and processing must be allowed.
amount -white_check_mark- The currency and value of the fund transfer.
transferCode -white_check_mark- The reason for the transfer, preconfigured on Adyen's side. If you haven't defined this yet, contact our Support Team.
merchantReference A string that you provide so you can link multiple transactions.
Transfer funds request
curl https://cal-test.adyen.com/cal/services/Fund/v6/transferFunds \
-H "x-API-key: YOUR_X-API-KEY" \
-H "content-type: application/json" \
-d '{
   "sourceAccountCode":"100000000",
   "destinationAccountCode":"190324759",
   "amount":{
      "currency":"EUR",
      "value":2000
   },
   "transferCode":"CREDIT_DISCOUNT",
   "merchantReference":"MyTransferReference-6718A"
}'

Requests for fund transfers are processed asynchronously so in the response, we only inform you that we received your request. You'll get the result from the TRANSFER_FUNDS webhook.

The response returns a pspReference. You'll need the pspReference in case you have to refund the funds transfer.

Response
{
   "pspReference":"9914828517650017",
   "resultCode":"Received"
}

Successful fund transfers are reported with a FundTransfer journal entry in your Marketplace Payment Accounting Report.

Transfer funds through Customer Area

You can use the Customer Area to manually transfer funds. To do this you must have the Perform and manage Fund Transfers from the customer area role for your Customer Area user. If you don't have the role, contact your Admin user.

To transfer funds through Customer Area:

  1. Log in to your Customer Area and switch to your merchant account.
  2. Go to Platform > Sub-merchant.
  3. Select the source account holder, then select the Accounts tab. The source account holder must have an active status and have payouts allowed.
  4. Select the more actions menu (three dots) then select Transfer to another account.
  5. In the New transfer page, specify:

    • The source account. The source account must have a positive balance.
    • The destination accounts. The account's account holder must have an active status and have processing allowed.
    • The amount to be transferred.

    Then select the transfer code from the drop-down list. These codes are configured on Adyen's side. If you haven't defined this yet, contact our Support Team.

  6. Select Transfer to initiate the fund transfer.

You can check the status of the transfer in the Transactions tab. You can also get the result from the TRANSFER_FUNDS webhook.

Successful fund transfers are reported with a FundTransfer journal entry in your Marketplace Payment Accounting Report.

Refund the funds transfer

If you need to revert a previous funds transfer, you can refund the transfer for the full amount or a partial amount. You can revert a fund transfer regardless of the account holder status. This allows you to reverse a fund transfer from an account even if that account is no longer Active.

To completely or partially refund a funds transfer, make a POST /refundFundsTransfer request, specifying:

Parameter Required Description
originalReference -white_check_mark- The pspReference that you received in the response to the original funds transfer.
amount -white_check_mark- The currency and value of the funds transfer that you are refunding. This can be the full original amount or part of the original amount.
merchantReference A string that you provide so you can link multiple transactions.
Refund funds transfer request
curl https://cal-test.adyen.com/cal/services/Fund/v6/refundFundsTransfer \
-H "x-API-key: YOUR_X-API-KEY" \
-H "content-type: application/json" \
-d '{
   "originalReference": "9914828517650017",
   "amount": {
     "currency": "EUR",
     "value": 2000
   },
  "merchantReference": "MyTransferReference-6718A"
}'

Requests for refunding fund transfers are processed asynchronously so in the response, we only inform you that we received your request. You'll get the result from the REFUND_FUNDS_TRANSFER webhook.

Response
{
   "pspReference": "8815789044698840",
   "resultCode": "Received",
   "merchantReference": "YOUR_MERCHANT_REFERENCE"
}

Successfully refunded fund transfers are reported with a FundTransferReversed journal entry in your Marketplace Payment Accounting Report.

See also