Process Transfers for a single Order

As of October 8th 2025: Duplicate transfer requests now return a 409 Conflict error instead of a 2XX response with an empty result.

When attempting to process transfers for orders that have already had their distributions settled, the API returns the following error:

{
  "error": "transfer_already_processed",
  "error_code": "4461",
  "error_message": "All transfers for this entity have already been processed."
}

Process Transfers for a single Order

post

Path parameters

order_idinteger · int64Required

Header parameters

X-Violet-TokenstringRequired

X-Violet-App-SecretstringRequired

X-Violet-App-Idinteger · int32Required

Responses

200

Process Transfers for an Order

application/json

Responsestring

post

/orders/{order_id}/transfer_funds

HTTPcURLJavaScriptPython

POST /v1/orders/{order_id}/transfer_funds HTTP/1.1
Host: sandbox-api.violet.io
X-Violet-Token: text
X-Violet-App-Secret: text
X-Violet-App-Id: 1
Accept: */*

200

Process Transfers for an Order

[
  {
    "id": 93557,
    "payment_provider_id": "tr_1QNJxRKUtPkD6xdUyTAqNfEw",
    "payout_account_id": 1025,
    "amount": 180000,
    "currency": "USD",
    "status": "SENT",
    "payment_provider": "EXTERNAL",
    "related_orders": [
      "149393"
    ],
    "related_bags": [
      "139861"
    ],
    "date_created": "2024-11-20T19:53:01+0000",
    "date_last_modified": "2024-11-20T19:53:01+0000",
    "errors": [],
    "payment_service": "EXTERNAL",
    "external_id": "tr_1QNJxRKUtPkD6xdUyTAqNfEw"
  }
]