Transfers

Create a transfer

Transfers funds between managed accounts and managed cards belonging to the same corporate or consumer identity.

Both instruments must be active. Debit-mode cards can't be used because they don't hold a balance. The specified Transfer Profile, configured in the Multi Portal, determines the transaction's fees and restrictions.

Set scheduledTimestamp to schedule execution for a future UTC date and time.

post/transfers

Request

  • Base URL: https://sandbox.weavr.io/multi
  • URL: https://sandbox.weavr.io/multi/transfers
  • Auth: HTTP bearer and API key in header api-key

Headers

idempotency-refstring
Example:transfer-2026-08-07-001

A unique call reference generated by the caller that, taking into consideration the payload as well as the operation itself, helps avoid duplicate operations. Idempotency reference uniqueness is maintained for at least 24 hours.

Request body

profileIdstring required

The profile Id which a specific identity, instrument, or transaction type is linked to.

Profiles contain configuration and determine behavioral aspects of the newly created transaction, for example, fees that may apply.

You can have one or more profiles linked to your application, and these can be used to drive different behaviors according to your product's needs.

Profile Ids can be found in the Multi Portal, in the API Credentials page.

tagstring

The tag field is a custom field that can be used to search and filter.

descriptionstring

The description details that are included in the transaction as reference.

scheduledTimestampstring

The epoch timestamp at which the transaction is scheduled to be executed.

Example request

{
  "profileId": "10001",
  "tag": "customer-123",
  "source": {
    "id": "123456789",
    "type": "managed_accounts"
  },
  "destination": {
    "id": "123456789",
    "type": "managed_accounts"
  },
  "destinationAmount": {
    "currency": "GBP",
    "amount": 1250
  },
  "scheduledTimestamp": "1786118400000"
}

Response

Success

idstring required

The unique identifier of a Transfer transaction.

profileIdstring required

The profile Id which a specific identity, instrument, or transaction type is linked to.

Profiles contain configuration and determine behavioral aspects of the newly created transaction, for example, fees that may apply.

You can have one or more profiles linked to your application, and these can be used to drive different behaviors according to your product's needs.

Profile Ids can be found in the Multi Portal, in the API Credentials page.

tagstring

The tag field is a custom field that can be used to search and filter.

descriptionstring

The description details that are included in the transaction as reference.

state'INITIALISED' | 'COMPLETED' | 'REJECTED' | 'FAILED' | 'PENDING' | 'SCHEDULED' | 'CANCELLED' required

Status of the transaction.

creationTimestampinteger required

The time when the transaction was created, expressed in Epoch timestamp using millisecond precision.

scheduledTimestampstring

The epoch timestamp at which the transaction is scheduled to be executed.

executionTimestampstring

The epoch timestamp at which the transaction was executed, transitioning to a final state such as COMPLETED, REJECTED, or FAILED.

cancellationReasonstring

The reason the scheduled transaction was canceled.

Example response

{
  "id": "2468013579",
  "profileId": "10001",
  "tag": "invoice-2026-0042",
  "source": {
    "type": "managed_accounts",
    "id": "123456789"
  },
  "destination": {
    "type": "managed_accounts",
    "id": "987654321"
  },
  "destinationAmount": {
    "currency": "GBP",
    "amount": 1250
  },
  "description": "Invoice 2026-0042",
  "state": "COMPLETED",
  "creationTimestamp": 1786118400000,
  "executionTimestamp": "1786118401250"
}

Changes

No recorded changes to this operation across all 1 revision of this API.