Transfer Funding

Once a transfer has been created, it needs to be funded. For Bulk Settlement, we can mark a transfer as funded using API.

For a full reference, please see the fund a transfer API reference.

Use TRUSTED_PRE_FUND_BULK as the type when calling the API.

Upon funding completion, the transfer will move from the incoming_payment_waiting status to the processing status.

The funding API acts as a guarantee that you will send the funds to Wise at the end of the agreed settlement period and this is legally binding. Only call the API when you are certain you will send the funds to us.

When calling the funding API for Bulk settlement, you may encounter the following error responses.

DescriptionReasonHTTP CodeError Code
Unauthorized accessYou can only fund a transfer with a user token that owns the transfer being funded.403transfer.not-accessible-for-user
Transfer does not existYou can only attempt to fund a transfer that exists404transfer.not-found
Invalid transfer stateIf this transfer is already funded (by calling this endpoint or by another payment) then the attempt to mark the transfer as funded will fail as you can’t fund a transfer twice. Additionally if the transfer is canceled or already being processed it cannot be funded.422transfer.invalid-state
Using a non-permitted type parameterBulk settlement is not enable.422trustedprefundbulk.payment-option-unavailable

Of these errors, the only one you are likely to see after going live should be transfer.invalid-state. The others should never happen if your integration works and passes the testing phase.

This error will normally only occur if you attempt to retry calling the funding API for a transfer that you already called it for, as it is unlikely the customer will fund the transfer directly, although this is possible. In the case of a failed retry, you can generally assume that the first call would have been successful and the transfer will be processed.

Regardless of whether this API returns CREATED or REJECTED you should still send the funds to Wise .

In the unlikely event a transfer has had no successful payment attempts, the transfer will still be processed on receipt of the funds and/or settlement file containing the transfer. The difference is the customer will have to wait until this time rather than having an instant payment experience.

Example Response
"status": "REJECTED",
"errorCode": "transfer.invalid-state",
"errorMessage": null

In order to limit exposure and risk, Wise might prevent payments from being paid out instantly in case the total amount owed to Wise for the current settlement period is above the collateral we are currently holding for your institution. In this case you will still receive a successful response with an HTTP status code 200.

The payment will still be created but the payout to the recipient will be delayed until we confirm that the funds arrive to Wise upon the settlement funds arriving after the end of the settlement period.

You should not cause the user process to fail or error at this point, and should consider the API call successful (hence the 200). However, you may wish to trigger some logic based on this response to run your settlement process earlier or alert a member of staff to do so, in order to prevent delays in processing of transfers.

Please discuss and agree on a suitable process with our implementation team on how to proceed once the limits are reached.

Example Response
"status": "CREATED",
"errorCode": "trustedprefundbulk.limit-reached",
"errorMessage": null