Skip to main content
POST
/
payments
/
{payment_id}
/
transactions
/
{transaction_id}
/
split-marketplace
/
transfer-reversal
cURL
curl --request POST \
  --url https://api-sandbox.y.uno/v1/payments/{payment_id}/transactions/{transaction_id}/split-marketplace/transfer-reversal \
  --header 'Content-Type: application/json' \
  --header 'private-secret-key: <api-key>' \
  --header 'public-api-key: <api-key>' \
  --data '
{
  "amount": {
    "currency": "",
    "value": ""
  },
  "description": ""
}
'
{
  "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",
      "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"
}

Documentation Index

Fetch the complete documentation index at: https://docs.y.uno/llms.txt

Use this file to discover all available pages before exploring further.

Enables marketplaces using Yuno Split Payments to request a transfer based on an existing payment. Request a transfer for a specified amount to one of the recipients participating in the split.

Authorizations

​
public-api-key
string
header
default:<Your public-api-key>
required
​
private-secret-key
string
header
default:<Your private-secret-key>
required

Headers

​
X-Idempotency-Key
string

Unique identifier used in HTTP headers to ensure that a request is processed only once, even if it is retried due to network issues or timeouts.

Path Parameters

​
payment_id
string
required

The unique identifier of the payment (MAX 64; MIN 36).

​
transaction_id
string
required

The unique identifier of the transaction (MAX 64; MIN 36).

Body

application/json
​
amount
object
required

The payment amount (multiple of 0.0001).

​
description
string
default:""

The unique identifier of the transaction (MAX 256; MIN 3).

Response

Created

​
code
string
Example:

"INVALID_REQUEST"

​
messages
string[]