v1

latestOpenAPI 3.0.02026-07-26167441.9 MB

Transfers

Create Standalone Transfer

post/split-marketplace/transfers

Headers

X-Idempotency-Keystring required

Unique key for request idempotency.

Request body

account_idstring required

The unique identifier of the account.

recipient_idstring uuid required

The target recipient identifier.

provider_idstring required

The payment provider code to use (e.g., adyen, stripe).

descriptionstring

A human-readable description for the transfer (3-255 chars). This is sent to the provider.

merchant_referencestring

Merchant's unique identifier for idempotency and tracking.

Example request

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

Response

Created

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"
    }
  ]
}