Sign in
transfer

Fund a Transfer

{% admonition type="warning" %}
  This endpoint is SCA protected when it applies. If your profile is registered within the UK and/or EEA, SCA most likely applies to you.
  Please read more about [implementing SCA](/guides/developer/auth-and-security/sca-and-2fa).
{% /admonition %}

This API call is the final step for executing payouts when using a balance with Wise. Upon calling the endpoint, Wise will begin the processing of the transfer, depending on the status of funds.

When using the transfer by transfer settlement model, the following funding type(s) must be used:

* **BALANCE** — Funds are pulled from a multi-currency account held with Wise.

When funding through the Bulk Settlement model, the following funding type(s) must be used:

* **TRUSTED_PRE_FUND_BULK** — Funds for the transfer will be settled through a bulk payment at a later date. This method is not applicable for First Party partner account transfers.

If funding from `BALANCE`, and your multi-currency account does not have the required funds to complete the action, then this call will fail with an "insufficient funds" error. Once funds are added and available, you must call this endpoint again.
post/v3/profiles/{profileId}/transfers/{transferId}/payments

Path parameters

profileIdinteger required

Profile Id

Example:123456789

Profile Id

transferIdinteger required

Transfer Id

Example:16521632

Transfer Id

Headers

X-External-Correlation-Idstring uuid

Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more.

Request body

OR
OR

Example request

{
  "balanceId": 45678901
}

Response

FundTransfer 201 response

OR
OR

Example response

{
  "errorMessage": "Transfer not found",
  "balanceTransactionId": 987654321
}

Changes

Changed in 2 of the 5 revisions of this API.2311

  • 4907a1d269ab1See the full diff
    • ●

      removed the request property ////////

      request-property-removed

  • f3e7a0f6519a2211See the full diff
    • ▲

      the request's body type changed from object to no type

      request-body-type-changed

    • ▲

      removed the success response with the status

      response-success-status-removed

    • ●

      removed the request property

      request-property-removed

    • ●

      removed the request property

      request-property-removed

    • ○

      api operation id transferFund removed and replaced with transferfund

      api-operation-id-removed

    • ○

      request body became optional

      request-body-became-optional

    • ○

      added request discriminator

      request-body-discriminator-added

    • ○

      added to the request body oneOf list

      request-body-one-of-added

    • ○

      added the media type text/plain for the response with the status

      response-media-type-added

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      added the success response with the status

      response-success-status-added

    This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog