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"
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.