Last Updated: 27 July 2023 | Change Log

Transfer API

Transfer funds between your currency accounts.

Important

Make yourself familiar with our API Principles to ensure a resilient integration.

Get started

Get started using our API Reference and set your headers.

Request

POST https://try.access.worldpay.com/accounts/transfer/

Request Schema:

sourceAccountNumberstring

The 16-digit transfer source account number.

targetAccountNumberstring

A 16-digit transfer destination account number.

amountnumber(double)

A decimal value for the transfer. Currency is defined by the source account currency.

narrativestring

A description about the transfer.

quoteIdstring

The ID of the quote of an exchange rate for the transfer. Not currently used - can set as empty guid value (all zeros).

Example request

{
"sourceAccountNumber":"1111550000000001",
"targetAccountNumber":"1111550000000002",
"amount":123.45,
"narrative":"CurrencyTransfer12",
"quoteID":"Q0000000BV"
}

Response

Response examples

Body of the response

There is no body for a successful response. Only HTTP status 202 will be returned.

Errors

Check out our API reference for the full error code schema.