Skip to main content
POST
/
split-marketplace
/
transfers
Create Standalone Transfer
curl --request POST \
  --url https://api-sandbox.y.uno/v1/split-marketplace/transfers \
  --header 'Content-Type: application/json' \
  --header 'PRIVATE-SECRET-KEY: <api-key>' \
  --header 'PUBLIC-API-KEY: <api-key>' \
  --header 'X-Idempotency-Key: <x-idempotency-key>' \
  --data '
{
  "account_id": "<string>",
  "recipient_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "provider_id": "<string>",
  "amount": {
    "value": 150,
    "currency": "USD"
  },
  "description": "<string>",
  "merchant_reference": "<string>",
  "metadata": [
    {
      "key": "<string>",
      "value": "<string>"
    }
  ]
}
'
{
  "id": "94036ceb-5cca-4384-b144-e2a5a908af77",
  "recipient_id": "e56c3329-f3d9-48e5-a677-284b147abf95",
  "amount": {
    "currency": "USD",
    "value": 100
  },
  "status": "SUCCEEDED",
  "description": "test transfer",
  "merchant_reference": "c19e858a-ffd6-4635-8a31-4f60c5becf4d",
  "metadata": [],
  "provider": null,
  "transactions": [
    {
      "code": "7ac2c5f3-7c79-4e99-b45e-aa5952620188",
      "type": "SPLIT_TRANSFER",
      "status": "SUCCEEDED",
      "provider_transfer_id": "tr_1T9eKVIiMnPsFcbbRTb8ObsZ",
      "provider_response_message": null,
      "provider_raw_response": "{\n  \"id\": \"tr_1T9eKVIiMnPsFcbbRTb8ObsZ\",\n  \"object\": \"transfer\",\n  \"amount\": 10000,\n  \"amount_reversed\": 0,\n  \"balance_transaction\": \"txn_1T9eKVIiMnPsFcbbOPnvz3xM\",\n  \"created\": 1773203107,\n  \"currency\": \"usd\",\n  \"description\": \"test transfer\",\n  \"destination\": \"acct_1T9PSQIZEg1WWTvj\",\n  \"destination_payment\": \"py_1T9eKVIZEg1WWTvjbVjmnzFK\",\n  \"livemode\": false,\n  \"metadata\": {},\n  \"reversals\": {\n    \"object\": \"list\",\n    \"data\": [],\n    \"has_more\": false,\n    \"total_count\": 0,\n    \"url\": \"/v1/transfers/tr_1T9eKVIiMnPsFcbbRTb8ObsZ/reversals\"\n  },\n  \"reversed\": false,\n  \"source_transaction\": null,\n  \"source_type\": \"card\",\n  \"transfer_group\": null\n}",
      "created_at": "2026-03-11T04:25:06.229027Z",
      "updated_at": "2026-03-11T04:25:07.917364Z"
    }
  ],
  "created_at": "2026-03-11T04:25:06.208761Z",
  "updated_at": "2026-03-11T04:25:07.928000342Z",
  "completed_at": "2026-03-11T04:25:07.927971142Z"
}
Create a forward transfer to distribute funds from your organization balance to your recipients independently of a payment.

Authorizations

​
PUBLIC-API-KEY
string
header
required
​
PRIVATE-SECRET-KEY
string
header
required

Headers

​
X-Idempotency-Key
string
required

Unique key for request idempotency.

Body

application/json
​
account_id
string
required

The unique identifier of the account.

​
recipient_id
string<uuid>
required

The target recipient identifier.

​
provider_id
string
required

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

​
amount
object
required
​
description
string

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

​
merchant_reference
string

Merchant's unique identifier for idempotency and tracking.

​
metadata
object[]

Response

Created

​
id
string
Example:

"TRF_7kB2mQ9xPnL4vR"

​
recipient_id
string<uuid>
Example:

"550e8400-e29b-41d4-a716-446655440000"

​
amount
object
​
status
string
Example:

"SUCCEEDED"

​
reason
string
Example:

"ORDER_CANCELLED"

​
description
string
Example:

"Weekly marketplace earnings"

​
merchant_reference
string
Example:

"TRANSFER-2026-02-15-001"

​
metadata
object[]
​
provider_data
object
​
created_at
string<date-time>
Example:

"2026-02-16T10:30:00Z"

​
updated_at
string<date-time>
Example:

"2026-02-16T10:30:15Z"

​
completed_at
string<date-time>
Example:

"2026-02-16T10:30:15Z"

​
provider
string | null
Example:

null

​
transactions
object[]