v5

latestOpenAPI 3.1.02026-07-262421791.5 MB

transfer

Create a partner licence transfer

{% admonition type="warning" name="Deprecated" %} This endpoint is deprecated and only maintained for existing legacy integrations. Do not use it for new integrations. Use Create a transfer or Create a third party transfer instead. {% /admonition %}

This is similar to the Create a transfer endpoint, but the originator datablock is additionally required.

You need to save the transfer ID for tracking its status later via webhooks.

Avoiding duplicate transfers

The customerTransactionId field is used to avoid duplicate transfer requests. If your initial call fails (error or timeout), retry the call using the same customerTransactionId value. Subsequent retry messages are treated as repeat messages and will not create duplicate transfers.

post/v1/profiles/{profileId}/partner-licence-transfers

Path parameters

profileIdinteger required

The profile 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

sourceAccountinteger

Refund recipient account ID

targetAccountinteger required

Recipient account ID. You can create multiple transfers to same recipient account

quotestring required

V2 quote ID. You can only create one transfer per one quote. You cannot use same quote ID to create multiple transfers

customerTransactionIdstring required

Unique transfer ID in your system. Also used to perform idempotency check to avoid duplicate transfers. You can only submit one transfer with same customerTransactionId

Response

Partner licence transfer successfully created.

idinteger

Transfer ID

userinteger

Your user ID

targetAccountinteger

Recipient account ID

sourceAccountinteger nullable

Refund recipient account ID

quotestring

Quote ID

statusstring

Transfer current status. See Tracking Transfers for all possible statuses.

referencestring

Deprecated, use details.reference instead

ratenumber

Exchange rate value

createdstring date-time

Timestamp when transfer was created

businessinteger nullable

Your business profile ID

transferRequestinteger nullable

Deprecated

hasActiveIssuesboolean

Are there any pending issues which stop executing the transfer?

sourceCurrencystring

Source currency code

sourceValuenumber

Transfer amount in source currency

targetCurrencystring

Target currency code

targetValuenumber

Transfer amount in target currency

originalTransferIdstring

Unique identifier randomly generated per transfer request by the calling client

payinSessionIdstring uuid

ID of the Payin Session generated for the transfer, which can be used for certain payin methods when funding the transfer

Example response

{
  "id": 16521632,
  "user": 4342275,
  "targetAccount": 8692237,
  "quote": "8fa9be20-ba43-4b15-abbb-9424e1481050",
  "status": "cancelled",
  "reference": "reference text",
  "rate": 0.89,
  "created": "2025-10-29T12:28:16.000Z",
  "details": {
    "reference": "Testing"
  },
  "originator": {
    "legalEntityType": "PRIVATE",
    "reference": "CST-2991992",
    "name": {
      "givenName": "John",
      "middleNames": [
        "Ryan"
      ],
      "familyName": "Godspeed",
      "fullName": "John Godspeed"
    },
    "dateOfBirth": "1977-07-01",
    "address": {
      "firstLine": "Salu tee 14",
      "city": "Tallinn",
      "countryCode": "EE",
      "postCode": "12112"
    },
    "accountDetails": "23456789"
  },
  "sourceCurrency": "EUR",
  "targetCurrency": "GBP",
  "targetValue": 150,
  "originalTransferId": "54a6bc09-cef9-49a8-9041-f1f0c654cd88",
  "payinSessionId": "23330542-8e9e-419f-95eb-312b880f92ad"
}