Transfer funds

You can transfer funds between two active Tango accounts that live on the same Tango platform. The accounts must have the same currency such as, USD to USD, or CAD to CAD.

Use the following endpoint to transfer funds from one Tango Account to the other with the same currency:

Endpoint	Description
`POST {URI}/transferFunds`	Transfer funds from one Tango Account to the other

📘
Note:

We accept AUD, CAD, EUR, GBP, or USD currency. Only one currency can be specified. Currency can never be changed. The currency defaults to USD if no currency is specified.

You can only transfer funds between accounts of the same currency, such as: USD to USD, or CAD to CAD. Funds cannot be transferred between accounts if they have different currencies, such as USD to EUR.

When funding an account using a credit card, you must ensure that the transaction is processed correctly and securely, using the appropriate body parameters.externalRefID is an idempotent field used to prevent accidental transfer duplication. It ensures that the same transfer is not processed multiple times. The externalRefID is returned in the funding response, funding details, and funding history.

The following body parameters are used to send data with this endpoint:

Body params	Data type	Requirement	Description
externalRefID	string	optional	Specify the external reference ID to associate with this funding action. This value must be unique. Duplicate `externalRefID` is blocked at the account level. If a duplicate `externalRefID` is submitted, the funding request fails showing a 409 error message: “`externalRefID` is not unique. Duplicate funding request.”
transferFrom	string	required	The `accountIdentifier` for the Account transferring funds from.
transferTo	string	required	The `accountIdentifier` for the Account transferring funds to.
amount	number	required	The currency amount of the funds being transferred. We only accept CAD, EUR, GBP, or USD. Only one currency can be specified. Currency can never be changed. The currency defaults to USD if no currency is specified.
transferNotes	string	optional	Add notes when transferring funds (up to 150 characters)

See the following payload example when you use this endpoint to transfer funds:

{
  "transferDate": "2025-04-29T22:53:23.806Z",
  "transferredAmount": 0,
  "transferNotes": "string",
  "transferFrom": {
    "accountIdentifier": "string",
    "accountNumber": "string",
    "displayName": "string",
    "currencyCode": "string",
    "startingBalance": 0,
    "endingBalance": 0,
    "status": "string",
    "contactEmail": "string"
  },
  "transferTo": {
    "accountIdentifier": "string",
    "accountNumber": "string",
    "displayName": "string",
    "currencyCode": "string",
    "startingBalance": 0,
    "endingBalance": 0,
    "status": "string",
    "contactEmail": "string"
  },
  "externalRefID": "string"
}

Here's an example payload for when you receive an error:

{
  "timestamp": "2025-02-21T23:23:13.930Z",
  "requestId": "string",
  "path": "string",
  "httpCode": 0,
  "httpPhrase": "string",
  "i18nKey": "string",
  "message": "The error message will show here for error codes ",
  "errors": [
    {}
  ]
}

The possible response codes for this endpoint are as follows. For details, see i18nkey codes and their error messages:

200 OK
400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
409 Conflick: Duplicate Exists
500 Internal Server Error
503 Service Unavailable

📘Note:

📘
Note: