Process Transfers for Orders

This endpoint only accepts order_ids in the request body. Passing in any other fields will result in an exception.

Process Transfers for Orders

post

Initiates payout transfers for multiple orders in a single batch request. The request body must contain a list of order IDs to process. Transfers are sent to the merchant's configured payout account via the appropriate payment provider (e.g., Stripe, External). The response separates results into successful and failed transfers, allowing callers to identify and retry failures independently. Dashboard and admin users must specify a target app_id query parameter; channel users can only process transfers for their own application.

Header parameters

X-Violet-TokenstringRequired

API token for authentication

X-Violet-App-SecretstringRequired

Application secret key

X-Violet-App-Idinteger · int32Required

Application ID

Example: 10000

Body

application/json

Request to process pending transfers for a given list of Order or Bag identifiers

application_idinteger · int32Optional

Identifier of the app that this request is being made for.

developer_idinteger · int32Optional

Identifier of the channel making this request.

order_idsinteger · int64[]Optional

List of Violet Order identifiers for which to process pending transfers.

bag_idsinteger · int64[]Optional

List of Violet Bag identifiers for which to process pending transfers.

Responses

200

ok

application/json

Summary of process transfers request, split by successful and failed transfers.

400

bad request

application/json

403

forbidden

application/json

500

internal server error

application/json

post

/orders/transfer_funds

HTTPcURLJavaScriptPython

POST /v1/orders/transfer_funds HTTP/1.1
Host: sandbox-api.violet.io
X-Violet-Token: text
X-Violet-App-Secret: text
X-Violet-App-Id: 1
Content-Type: application/json
Accept: */*
Content-Length: 29

{
  "order_ids": [
    149483,
    149484
  ]
}

{
  "successful_transfers": {
    "count": 1,
    "order_count": 2,
    "order_ids": [
      149483,
      149484
    ],
    "bag_ids": [
      139970,
      139971
    ],
    "transfers": [
      {
        "id": 93645,
        "payment_provider_id": "tr_1QNNs5KUtPkD6xdUHFhGa9HH",
        "payout_account_id": 1025,
        "amount": 360000,
        "currency": "USD",
        "status": "SENT",
        "payment_provider": "STRIPE",
        "related_orders": [
          "149483",
          "149484"
        ],
        "related_bags": [
          "139971",
          "139970"
        ],
        "related_distributions": [
          "89086",
          "89084"
        ],
        "date_created": "2024-11-21T00:03:45+0000",
        "date_last_modified": "2024-11-21T00:03:45+0000",
        "errors": [],
        "payment_service": "STRIPE",
        "external_id": "tr_1QNNs5KUtPkD6xdUHFhGa9HH"
      }
    ]
  },
  "failed_transfers": {
    "count": 0,
    "order_count": 0,
    "order_ids": [],
    "bag_ids": [],
    "transfers": []
  }
}