Last Updated: 14 May 2025 | 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

Ready to integrate? Use our API Reference and set your headers.

Request

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

Example request

{
  "sourceAccountNumber": "0000001212121212",
  "targetAccountNumber": "1212121212121415",
  "amount": "77.22",
  "narrative": "A narrative",
  "quoteId": "string"
}

Request Schema:

sourceAccountNumberstring= 16 charactersrequired

The source account number.

Example: "1111550000000001"
targetAccountNumberstring= 16 charactersrequired

The target account number.

Example: "1111550000000002"
amountnumber(double)required

The amount. A maximum of seven digits before the decimal place. A maximum of two decimal places.

Example: "77.22"
narrativestring[ 6 .. 34 ] characters^[a-zA-Z0-9\s-]required

You can use this to describe what the transfer is for.

Example: "A narrative"
quoteIdstring or null

The quoteId returned by the FX API.

Example: "QuoteId"

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.