v1

latestOpenAPI 3.0.02026-07-26167441.9 MB

Transfers

Reverse Standalone Transfer

post/split-marketplace/transfers/{transfer_id}/reverse

Path parameters

transfer_idstring required

The unique ID of the transfer flow to reverse.

Headers

X-Idempotency-Keystring required

Unique key for request idempotency.

Request body

account_idstring required

The unique identifier of the account.

reasonstring

The reason for the reversal.

descriptionstring

A human-readable description for the reversal.

merchant_referencestring

Merchant's unique identifier for tracking this reversal.

Example request

{
  "amount": {
    "value": 150,
    "currency": "USD"
  }
}

Response

idstring

recipient_idstring uuid

statusstring

reasonstring

descriptionstring

merchant_referencestring

created_atstring date-time

updated_atstring date-time

completed_atstring date-time

providerstring nullable

Example response

{
  "id": "TRF_7kB2mQ9xPnL4vR",
  "recipient_id": "550e8400-e29b-41d4-a716-446655440000",
  "amount": {
    "value": 150,
    "currency": "USD"
  },
  "status": "SUCCEEDED",
  "reason": "ORDER_CANCELLED",
  "description": "Weekly marketplace earnings",
  "merchant_reference": "TRANSFER-2026-02-15-001",
  "provider_data": {
    "id": "adyen",
    "recipient_id": "SE322KT223222B5CM82WL9TB",
    "transfer_id": "TRF_8535296827453920",
    "response_code": "000",
    "response_message": "Transfer completed"
  },
  "created_at": "2026-02-16T10:30:00Z",
  "updated_at": "2026-02-16T10:30:15Z",
  "completed_at": "2026-02-16T10:30:15Z",
  "transactions": [
    {
      "code": "9eee65d1-6c3a-4076-9ef9-fa4bff73d597",
      "type": "SPLIT_TRANSFER",
      "status": "ERROR",
      "provider_transfer_id": "tr_1T9PTLIiMnPsFcbbFKyh1Nds",
      "provider_response_message": "...",
      "provider_raw_response": "{.... }",
      "created_at": "2026-03-10T13:39:19.342902Z",
      "updated_at": "2026-03-10T13:39:19.342914Z"
    }
  ]
}