Search Transfers
20
1
Parameters used to filter and retrieve payout transfers based on criteria such as order, merchant, status, and creation date.
Filter transfers associated with a specific order.
Filter transfers associated with a specific bag.
Filter transfers based on a collection of transferIds.
Filter transfers associated with multiple orders.
Filter transfers associated with multiple bags.
Filter transfers related to a specific merchant.
Filter transfers directed to a specific payout account.
Filter transfers associated with a specific payout.
Filter transfers with a sepcific payment provider transfer Id.
Filter transfers based on their current status.
Return transfers created on or after this timestamp (inclusive).
Return transfers created before this timestamp (exclusive).
POST /v1/payments/transfers 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: 252
{
"order_id": 1,
"bag_id": 1,
"transfer_ids": [
1
],
"order_ids": [
1
],
"bag_ids": [
1
],
"merchant_id": 1,
"payout_account_id": 1,
"payout_id": 1,
"paypro_transfer_id": 1,
"status": "SENT",
"created_after": "2025-07-30T10:59:29.675Z",
"created_before": "2025-07-30T10:59:29.675Z"
}
default response
{
"totalPages": 1,
"totalElements": 1,
"size": 1,
"content": [
{
"id": 1,
"payment_transaction": 1,
"payout_id": 1,
"payment_provider_id": "text",
"payment_provider_payout_id": "text",
"payout_account_id": 1,
"bag_amount": 1,
"bag_currency": "text",
"amount": 1,
"currency": "text",
"status": "SENT",
"type": "MERCHANT",
"payment_provider": "STRIPE",
"related_orders": [
"text"
],
"related_bags": [
"text"
],
"related_distributions": [
"text"
],
"transfer_reversals": [
"text"
],
"idempotency_key": "text",
"date_created": "2025-07-30T10:59:29.675Z",
"date_last_modified": "2025-07-30T10:59:29.675Z",
"errors": [
{
"id": 1,
"error_code": 1,
"error_message": "text",
"resolved": true,
"date_resolved": "2025-07-30T10:59:29.675Z",
"date_created": "2025-07-30T10:59:29.675Z",
"payout_transfer_id": 1
}
],
"externalId": "text",
"payoutExternalId": "text",
"paymentService": "STRIPE"
}
],
"number": 1,
"sort": {
"empty": true,
"sorted": true,
"unsorted": true
},
"first": true,
"numberOfElements": 1,
"pageable": {
"offset": 1,
"sort": {
"empty": true,
"sorted": true,
"unsorted": true
},
"paged": true,
"unpaged": true,
"pageNumber": 1,
"pageSize": 1
},
"last": true,
"empty": true
}
Last updated
Was this helpful?