Search

Are you looking for test card numbers?

Would you like to contact support?

Marketpay icon

Fund transfer

Learn how to manually transfer funds to and from your sub-merchants.

You can manually control the balance of each sub-merchant or, in other words, account holder. This may be required, for example, when you need to send a bonus to a specific sub-merchant in your platform, or when it's necessary to transfer funds from one account holder to another.

To control the balance of an account holder, you can use the following calls:

Before you begin

Before you can transfer funds, or refund a fund transfer, you have to enable the functionality and define your transfer reason codes. Which codes you can use depends on your platform account.

  1. Contact our Support Team to enable fund transfers, and to define your individual transfer reason codes.
  2. Make sure that you've set up notifications with the event types TRANSFER_FUNDS and REFUND_FUNDS_TRANSFER. These notifications will inform you of the final result of your /transferFunds and /refundFundsTransfer requests.

Transfer funds

To transfer funds to an account holder:

  • Make a POST request to the /transferFunds endpoint, specifying:

    Parameter Required Description
    sourceAccountCode -white_check_mark- The code of the account from which the funds are to be debited. The state of the account holder of this account must be Active and allow payouts.
    destinationAccountCode -white_check_mark- The code of the account to which the funds are to be credited. The state of the account holder of this account must be Active.
    amount -white_check_mark- The currency and value of the funds you are transferring.
    transferCode -white_check_mark- The transfer code that you defined. This code is related to the type of transfer you are performing.
    merchantReference You can use this field to link multiple transactions to one another.
    Transfer funds request
    {
       "sourceAccountCode":"100000000",
       "destinationAccountCode":"190324759",
       "amount":{
          "currency":"EUR",
          "value":2000
       },
       "transferCode":"CODE_A"
    }
    Response
    {
       "pspReference":"9914828517650017",
       "resultCode":"Received"
    }

You will also receive:

Refund the funds transfer

If you, for any reason, need to revert a previous funds transfer, you can refund the transfer for the full amount or a partial amount by making a /refundFundsTransfer call.

The /refundFundsTransfer call works 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 request to the /refundFundsTransfer endpoint, 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 You can use this field to link multiple transactions to one another.
    Refund funds request
    {
       "originalReference": "9914828517650017",
       "amount": {
         "currency": "EUR",
         "value": 2000
       },
    "merchantReference": "YOUR_MERCHANT_REFERENCE"
    }
    Response
    {
       "pspReference": "8815789044698840",
       "resultCode": "Received",
       "merchantReference": "YOUR_MERCHANT_REFERENCE"
    }

You will also receive:

Next steps