Update the split of a paid transaction

PUT

payments

{payment_id}

transactions

{transaction_id}

split-marketplace

Update the split of a paid transaction

curl --request PUT \
  --url https://api-sandbox.y.uno/v1/payments/{payment_id}/transactions/{transaction_id}/split-marketplace \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency-Key: <x-idempotency-key>' \
  --header 'private-secret-key: <api-key>' \
  --header 'public-api-key: <api-key>' \
  --data '
{
  "split_marketplace": [
    {
      "provider_recipient_id": "4c036fbdd2a44786815c331e9c011367",
      "type": "MARKETPLACE",
      "amount": {
        "value": 6,
        "currency": "BRL"
      }
    }
  ],
  "description": "Same-day split replacement",
  "metadata": [
    {
      "key": "reason",
      "value": "same-day redistribution"
    }
  ]
}
'

import requests

url = "https://api-sandbox.y.uno/v1/payments/{payment_id}/transactions/{transaction_id}/split-marketplace"

payload = {
    "split_marketplace": [
        {
            "provider_recipient_id": "4c036fbdd2a44786815c331e9c011367",
            "type": "MARKETPLACE",
            "amount": {
                "value": 6,
                "currency": "BRL"
            }
        }
    ],
    "description": "Same-day split replacement",
    "metadata": [
        {
            "key": "reason",
            "value": "same-day redistribution"
        }
    ]
}
headers = {
    "X-Idempotency-Key": "<x-idempotency-key>",
    "public-api-key": "<api-key>",
    "private-secret-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {
    'X-Idempotency-Key': '<x-idempotency-key>',
    'public-api-key': '<api-key>',
    'private-secret-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    split_marketplace: [
      {
        provider_recipient_id: '4c036fbdd2a44786815c331e9c011367',
        type: 'MARKETPLACE',
        amount: {value: 6, currency: 'BRL'}
      }
    ],
    description: 'Same-day split replacement',
    metadata: [{key: 'reason', value: 'same-day redistribution'}]
  })
};

fetch('https://api-sandbox.y.uno/v1/payments/{payment_id}/transactions/{transaction_id}/split-marketplace', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-sandbox.y.uno/v1/payments/{payment_id}/transactions/{transaction_id}/split-marketplace",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'split_marketplace' => [
        [
                'provider_recipient_id' => '4c036fbdd2a44786815c331e9c011367',
                'type' => 'MARKETPLACE',
                'amount' => [
                                'value' => 6,
                                'currency' => 'BRL'
                ]
        ]
    ],
    'description' => 'Same-day split replacement',
    'metadata' => [
        [
                'key' => 'reason',
                'value' => 'same-day redistribution'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-Idempotency-Key: <x-idempotency-key>",
    "private-secret-key: <api-key>",
    "public-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-sandbox.y.uno/v1/payments/{payment_id}/transactions/{transaction_id}/split-marketplace"

	payload := strings.NewReader("{\n  \"split_marketplace\": [\n    {\n      \"provider_recipient_id\": \"4c036fbdd2a44786815c331e9c011367\",\n      \"type\": \"MARKETPLACE\",\n      \"amount\": {\n        \"value\": 6,\n        \"currency\": \"BRL\"\n      }\n    }\n  ],\n  \"description\": \"Same-day split replacement\",\n  \"metadata\": [\n    {\n      \"key\": \"reason\",\n      \"value\": \"same-day redistribution\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("X-Idempotency-Key", "<x-idempotency-key>")
	req.Header.Add("public-api-key", "<api-key>")
	req.Header.Add("private-secret-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api-sandbox.y.uno/v1/payments/{payment_id}/transactions/{transaction_id}/split-marketplace")
  .header("X-Idempotency-Key", "<x-idempotency-key>")
  .header("public-api-key", "<api-key>")
  .header("private-secret-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"split_marketplace\": [\n    {\n      \"provider_recipient_id\": \"4c036fbdd2a44786815c331e9c011367\",\n      \"type\": \"MARKETPLACE\",\n      \"amount\": {\n        \"value\": 6,\n        \"currency\": \"BRL\"\n      }\n    }\n  ],\n  \"description\": \"Same-day split replacement\",\n  \"metadata\": [\n    {\n      \"key\": \"reason\",\n      \"value\": \"same-day redistribution\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-sandbox.y.uno/v1/payments/{payment_id}/transactions/{transaction_id}/split-marketplace")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["X-Idempotency-Key"] = '<x-idempotency-key>'
request["public-api-key"] = '<api-key>'
request["private-secret-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"split_marketplace\": [\n    {\n      \"provider_recipient_id\": \"4c036fbdd2a44786815c331e9c011367\",\n      \"type\": \"MARKETPLACE\",\n      \"amount\": {\n        \"value\": 6,\n        \"currency\": \"BRL\"\n      }\n    }\n  ],\n  \"description\": \"Same-day split replacement\",\n  \"metadata\": [\n    {\n      \"key\": \"reason\",\n      \"value\": \"same-day redistribution\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "id": "d49f0691-55de-4045-a668-c17f338cd1a3",
  "idempotency_key": "496E09AE-D453-491C-9179-9FC1EDEDAD02",
  "origin": "YUNO",
  "account_code": "4be68036-738e-4841-8eb5-7a5927591a1b",
  "account_id": "4be68036-738e-4841-8eb5-7a5927591a1b",
  "description": "pay-test purchase",
  "country": "BR",
  "status": "SUCCEEDED",
  "sub_status": "APPROVED",
  "merchant_order_id": "pt-1789681395403",
  "created_at": "2026-09-17T21:43:16.119879Z",
  "updated_at": "2026-09-17T21:43:18.860706Z",
  "amount": {
    "captured": 0,
    "currency": "BRL",
    "currency_conversion": null,
    "refunded": 0,
    "value": 10
  },
  "checkout": {
    "session": "",
    "sdk_action_required": false
  },
  "customer_payer": null,
  "additional_data": {
    "airline": null,
    "transportations": null,
    "lodgings": null,
    "order": null,
    "seller_details": null,
    "device": null,
    "payer_risk_data": null
  },
  "taxes": null,
  "transactions": [
    {
      "id": "77b11fef-5c38-4ecf-9607-015594ee0bc4",
      "type": "PURCHASE",
      "status": "SUCCEEDED",
      "category": "CARD",
      "amount": 10,
      "provider_id": "ZOOP",
      "payment_method": {
        "vaulted_token": "",
        "type": "CARD",
        "vault_on_success": false,
        "vault_on_decline": false,
        "token": "",
        "parent_payment_method_type": null,
        "otp": {
          "length": 0,
          "retries": {}
        },
        "detail": {
          "card": {
            "verify": false,
            "capture": true,
            "installments": 1,
            "installments_plan_id": null,
            "first_installment_deferral": 0,
            "installments_type": "",
            "installment_amount": null,
            "installments_total_amount": null,
            "soft_descriptor": "",
            "authorization_code": "133937",
            "retrieval_reference_number": "20180510122911535",
            "voucher": null,
            "card_data": {
              "holder_name": "YUNO TESTER",
              "iin": "42424242",
              "lfd": "4242",
              "number_length": 16,
              "security_code_length": 3,
              "brand": "VISA",
              "scheme": "VISA",
              "issuer_name": "STRIPE PAYMENTS UK",
              "issuer_code": null,
              "country_code": "GB",
              "category": "CLASSIC",
              "type": "CREDIT",
              "three_d_secure": {
                "version": null,
                "electronic_commerce_indicator": null,
                "cryptogram": null,
                "transaction_id": null,
                "directory_server_transaction_id": null,
                "pares_status": null,
                "acs_id": null
              },
              "fingerprint": "4a4c0ff4-6e9e-455d-a104-3e771579a536",
              "expiration_month": 3,
              "expiration_year": 30
            },
            "stored_credentials": null,
            "verification_services": {
              "address_line_1_check": "UNCHECKED",
              "zip_code_check": "UNCHECKED",
              "card_holder_name_check": "UNCHECKED",
              "card_security_code_check": "UNCHECKED"
            }
          }
        }
      },
      "response_code": "SUCCEEDED",
      "response_message": "Transaction successful",
      "reason": null,
      "description": "pay-test purchase",
      "merchant_reference": "pt-1789681395403",
      "provider_data": {
        "id": "ZOOP",
        "transaction_id": "af8fd4e75b614591a03b2125b53907a4",
        "account_id": "",
        "status": "succeeded",
        "sub_status": "",
        "status_detail": "",
        "response_message": null,
        "response_code": "00",
        "raw_request": "\"{\\\"payment_type\\\":\\\"credit\\\",\\\"source\\\":{\\\"card\\\":{\\\"card_number\\\":\\\"a198286a-f433-4603-842b-e7dfc2ec0801\\\",\\\"security_code\\\":\\\"e2056811-39fc-444a-a355-41aa514c277f\\\",\\\"holder_name\\\":\\\"YUNO TESTER\\\",\\\"expiration_month\\\":\\\"3\\\",\\\"expiration_year\\\":\\\"2030\\\"},\\\"usage\\\":\\\"single_use\\\",\\\"amount\\\":1000,\\\"currency\\\":\\\"BRL\\\",\\\"type\\\":\\\"card\\\"},\\\"on_behalf_of\\\":\\\"4a8418ddc83f4b4fbd6f442902a4e3b3\\\",\\\"capture\\\":true,\\\"description\\\":\\\"pay-test purchase\\\",\\\"reference_id\\\":\\\"77b11fef-5c38-4ecf-9607-015594ee0bc4\\\",\\\"split_rules\\\":[{\\\"recipient\\\":\\\"3258673725454c5cafaec0210674eb8d\\\",\\\"liable\\\":false,\\\"charge_processing_fee\\\":false,\\\"amount\\\":600}]}\"",
        "raw_request_details": {
          "headers": {
            "Authorization": [
              "[REDACTED]"
            ],
            "X-Account-Integration-Code": [
              "[REDACTED]"
            ],
            "X-Dynamic-Mtls": [
              "[REDACTED]"
            ],
            "x-api-key": [
              "[REDACTED]"
            ]
          },
          "method": "POST",
          "url": "/v1/marketplaces/7fcca632f35f4efa8143238d28a89cd9/transactions"
        },
        "raw_response_details": {
          "http_status_code": 201
        },
        "third_party_transaction_id": "",
        "third_party_account_id": "",
        "iso8583_response_code": null,
        "iso8583_response_message": null,
        "retrieval_reference_number": null,
        "merchant_advice_code": null,
        "merchant_advice_code_message": null,
        "reason_code": null,
        "reason_description": null
      },
      "connection_data": {
        "id": "99d88722-2c77-4281-ad92-f74df11bc8b9",
        "name": "zoop"
      },
      "created_at": "2026-09-17T21:43:16.232391Z",
      "updated_at": "2026-09-17T21:43:18.778608Z",
      "split_marketplace": [
        {
          "recipient_id": null,
          "recipient_type": null,
          "provider_recipient_id": "4c036fbdd2a44786815c331e9c011367",
          "type": "MARKETPLACE",
          "merchant_reference": null,
          "amount": {
            "value": 6,
            "currency": "BRL"
          },
          "liability": null,
          "description": null
        }
      ],
      "merchant_advice_code": null,
      "merchant_advice_code_message": null
    }
  ],
  "split_marketplace": [],
  "workflow": "DIRECT",
  "fraud_screening": null,
  "metadata": [],
  "shipping": null,
  "payment_link_code": "",
  "routing_rules": {
    "smart_routing": false,
    "monitors": false,
    "condition": {
      "id": 279053,
      "name": null,
      "description": null
    }
  }
}

Marketplaces that redistribute an order after payment (a different seller delivers, an item is swapped) can replace the split of a paid transaction instead of refunding and charging again. The update replaces the whole split: the legs you send become the split, and legs you do not send are removed. The payment and the transaction keep their status, and no new transaction is created.

When an update is accepted

The transaction is a PURCHASE with status SUCCEEDED.
The provider still allows it: before settlement, and while the provider’s limit of split changes per transaction is not reached (each update uses that allowance once per leg). Both conditions belong to the provider; when one fails you get a 409 with SPLIT_UPDATE_WINDOW_CLOSED or SPLIT_UPDATE_LIMIT_REACHED, and the split is not changed. Yuno counts the changes already made and refuses an update that would pass the limit before it reaches the provider.
The payment has no refund (partial, total, or one waiting to be retried), no chargeback and no transfer reversal. Otherwise you get a 409 with SPLIT_UPDATE_NOT_ALLOWED.
The provider of the transaction supports it. Availability is enabled per connection; contact Yuno to enable it for yours.

Every leg must name its recipient (recipient_id or provider_recipient_id, never both) and its amount. The amounts must not add up to more than the transaction amount, in the currency of the payment.

Idempotency

X-Idempotency-Key is required. A timeout is not a failure: the update may have been applied at the provider even if you did not get the answer. Repeat the request with the same key and the same body and you get the outcome of the first attempt, without a second change at the provider: the same status, and the payment as it is at that moment (after a later update, the split shown is the current one). The same key with a different body is refused with SPLIT_UPDATE_IDEMPOTENCY_CONFLICT. If you repeat the request while the first attempt is still running (for example right after your own timeout), the answer is 400 OPERATION_IN_PROCESS and nothing changes: wait a few seconds and repeat it again with the same key. Use a new key only for a new change.

Where to read the split

The answer is the payment, in the same shape as Retrieve payment by ID. Read the split on transactions.split_marketplace; the payment-level split_marketplace array does not carry it. The same is true of every later GET /payments/{payment_id}.

When the provider does not confirm

If the provider does not confirm the outcome (a timeout at the provider, or a failure while it replaced the rules), the answer is a 502 with PROVIDER_ERROR and the update stays under review by Yuno. Do not send a new update for that transaction: it is refused with 409 SPLIT_UPDATE_NOT_ALLOWED until the review is complete. A retry with the same key returns the same 502. Refunds of that payment are refused until the review is complete too (next section).

Refunds while an update is open

While an update of a payment is in progress or under review, refunds of that payment (including cancel-or-refund) are refused with 400 OPERATION_IN_PROCESS, the same answer as for any other operation running on the payment. Under review, the message says so. Nothing is recorded for the refused refund: repeat it with the same idempotency key once the update finishes. Refunds requested in bulk are not retried automatically; request them again.

Response codes

HTTP	`code`	Meaning
200	—	The split was replaced. The answer is the payment.
400	`INVALID_PARAMETERS`	A field is missing or invalid: no idempotency key, an empty split, a leg without recipient or amount, both recipient ids in one leg, amounts above the transaction amount, another currency, a description shorter than 3 or longer than 255 characters.
400	`PAYMENT_NOT_FOUND`, `TRANSACTION_NOT_FOUND`	The payment, or the transaction of that payment, is not found for your account.
400	`OPERATION_IN_PROCESS`	Another operation on the payment is already running. Try again in a few seconds with the same key.
404	`RECIPIENT_NOT_FOUND`	A `recipient_id` is unknown, or the recipient is not onboarded with the provider of the transaction.
409	`SPLIT_UPDATE_NOT_ALLOWED`	The transaction is not a succeeded purchase, the provider is not enabled, the payment has a refund (including one waiting to be retried), chargeback or transfer reversal, or a previous update is under review.
409	`SPLIT_UPDATE_WINDOW_CLOSED`	The provider no longer accepts changes for this transaction. The split was not changed.
409	`SPLIT_UPDATE_LIMIT_REACHED`	The provider’s limit of split changes for this transaction was reached. The split was not changed.
409	`SPLIT_UPDATE_IN_PROGRESS`	Another update of this transaction is in progress. Try again in a few seconds.
409	`SPLIT_UPDATE_IDEMPOTENCY_CONFLICT`	The idempotency key was already used with a different body.
502	`PROVIDER_ERROR`	The provider did not confirm the outcome; the update is under review.

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

required

Required. Unique identifier of this update (MAX 64). A request that times out is not a failure: repeat it with the same key and you get the outcome of the first attempt. The same key with a different body is refused with SPLIT_UPDATE_IDEMPOTENCY_CONFLICT. A repeat sent while the first attempt is still running is answered 400 OPERATION_IN_PROCESS and changes nothing: wait a few seconds and repeat it again with the same key.

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 purchase transaction whose split is replaced (MAX 64; MIN 36).

Body

application/json

split_marketplace

object[]

required

The new split: every leg the transaction must have after the update.

Minimum array length: 1

Show child attributes

description

string

Description of the update (MAX 255; MIN 3).

metadata

object[]

Custom key-value pairs stored with the update.

Show child attributes

Response

The split was replaced. The answer is the payment, in the same shape as Retrieve payment by ID; read the new split on transactions.split_marketplace.

The payment object. See The payment object.

⌘I

Update the split of a paid transaction

curl --request PUT \
  --url https://api-sandbox.y.uno/v1/payments/{payment_id}/transactions/{transaction_id}/split-marketplace \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency-Key: <x-idempotency-key>' \
  --header 'private-secret-key: <api-key>' \
  --header 'public-api-key: <api-key>' \
  --data '
{
  "split_marketplace": [
    {
      "provider_recipient_id": "4c036fbdd2a44786815c331e9c011367",
      "type": "MARKETPLACE",
      "amount": {
        "value": 6,
        "currency": "BRL"
      }
    }
  ],
  "description": "Same-day split replacement",
  "metadata": [
    {
      "key": "reason",
      "value": "same-day redistribution"
    }
  ]
}
'

import requests

url = "https://api-sandbox.y.uno/v1/payments/{payment_id}/transactions/{transaction_id}/split-marketplace"

payload = {
    "split_marketplace": [
        {
            "provider_recipient_id": "4c036fbdd2a44786815c331e9c011367",
            "type": "MARKETPLACE",
            "amount": {
                "value": 6,
                "currency": "BRL"
            }
        }
    ],
    "description": "Same-day split replacement",
    "metadata": [
        {
            "key": "reason",
            "value": "same-day redistribution"
        }
    ]
}
headers = {
    "X-Idempotency-Key": "<x-idempotency-key>",
    "public-api-key": "<api-key>",
    "private-secret-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {
    'X-Idempotency-Key': '<x-idempotency-key>',
    'public-api-key': '<api-key>',
    'private-secret-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    split_marketplace: [
      {
        provider_recipient_id: '4c036fbdd2a44786815c331e9c011367',
        type: 'MARKETPLACE',
        amount: {value: 6, currency: 'BRL'}
      }
    ],
    description: 'Same-day split replacement',
    metadata: [{key: 'reason', value: 'same-day redistribution'}]
  })
};

fetch('https://api-sandbox.y.uno/v1/payments/{payment_id}/transactions/{transaction_id}/split-marketplace', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-sandbox.y.uno/v1/payments/{payment_id}/transactions/{transaction_id}/split-marketplace",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'split_marketplace' => [
        [
                'provider_recipient_id' => '4c036fbdd2a44786815c331e9c011367',
                'type' => 'MARKETPLACE',
                'amount' => [
                                'value' => 6,
                                'currency' => 'BRL'
                ]
        ]
    ],
    'description' => 'Same-day split replacement',
    'metadata' => [
        [
                'key' => 'reason',
                'value' => 'same-day redistribution'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-Idempotency-Key: <x-idempotency-key>",
    "private-secret-key: <api-key>",
    "public-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-sandbox.y.uno/v1/payments/{payment_id}/transactions/{transaction_id}/split-marketplace"

	payload := strings.NewReader("{\n  \"split_marketplace\": [\n    {\n      \"provider_recipient_id\": \"4c036fbdd2a44786815c331e9c011367\",\n      \"type\": \"MARKETPLACE\",\n      \"amount\": {\n        \"value\": 6,\n        \"currency\": \"BRL\"\n      }\n    }\n  ],\n  \"description\": \"Same-day split replacement\",\n  \"metadata\": [\n    {\n      \"key\": \"reason\",\n      \"value\": \"same-day redistribution\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("X-Idempotency-Key", "<x-idempotency-key>")
	req.Header.Add("public-api-key", "<api-key>")
	req.Header.Add("private-secret-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api-sandbox.y.uno/v1/payments/{payment_id}/transactions/{transaction_id}/split-marketplace")
  .header("X-Idempotency-Key", "<x-idempotency-key>")
  .header("public-api-key", "<api-key>")
  .header("private-secret-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"split_marketplace\": [\n    {\n      \"provider_recipient_id\": \"4c036fbdd2a44786815c331e9c011367\",\n      \"type\": \"MARKETPLACE\",\n      \"amount\": {\n        \"value\": 6,\n        \"currency\": \"BRL\"\n      }\n    }\n  ],\n  \"description\": \"Same-day split replacement\",\n  \"metadata\": [\n    {\n      \"key\": \"reason\",\n      \"value\": \"same-day redistribution\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-sandbox.y.uno/v1/payments/{payment_id}/transactions/{transaction_id}/split-marketplace")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["X-Idempotency-Key"] = '<x-idempotency-key>'
request["public-api-key"] = '<api-key>'
request["private-secret-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"split_marketplace\": [\n    {\n      \"provider_recipient_id\": \"4c036fbdd2a44786815c331e9c011367\",\n      \"type\": \"MARKETPLACE\",\n      \"amount\": {\n        \"value\": 6,\n        \"currency\": \"BRL\"\n      }\n    }\n  ],\n  \"description\": \"Same-day split replacement\",\n  \"metadata\": [\n    {\n      \"key\": \"reason\",\n      \"value\": \"same-day redistribution\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "id": "d49f0691-55de-4045-a668-c17f338cd1a3",
  "idempotency_key": "496E09AE-D453-491C-9179-9FC1EDEDAD02",
  "origin": "YUNO",
  "account_code": "4be68036-738e-4841-8eb5-7a5927591a1b",
  "account_id": "4be68036-738e-4841-8eb5-7a5927591a1b",
  "description": "pay-test purchase",
  "country": "BR",
  "status": "SUCCEEDED",
  "sub_status": "APPROVED",
  "merchant_order_id": "pt-1789681395403",
  "created_at": "2026-09-17T21:43:16.119879Z",
  "updated_at": "2026-09-17T21:43:18.860706Z",
  "amount": {
    "captured": 0,
    "currency": "BRL",
    "currency_conversion": null,
    "refunded": 0,
    "value": 10
  },
  "checkout": {
    "session": "",
    "sdk_action_required": false
  },
  "customer_payer": null,
  "additional_data": {
    "airline": null,
    "transportations": null,
    "lodgings": null,
    "order": null,
    "seller_details": null,
    "device": null,
    "payer_risk_data": null
  },
  "taxes": null,
  "transactions": [
    {
      "id": "77b11fef-5c38-4ecf-9607-015594ee0bc4",
      "type": "PURCHASE",
      "status": "SUCCEEDED",
      "category": "CARD",
      "amount": 10,
      "provider_id": "ZOOP",
      "payment_method": {
        "vaulted_token": "",
        "type": "CARD",
        "vault_on_success": false,
        "vault_on_decline": false,
        "token": "",
        "parent_payment_method_type": null,
        "otp": {
          "length": 0,
          "retries": {}
        },
        "detail": {
          "card": {
            "verify": false,
            "capture": true,
            "installments": 1,
            "installments_plan_id": null,
            "first_installment_deferral": 0,
            "installments_type": "",
            "installment_amount": null,
            "installments_total_amount": null,
            "soft_descriptor": "",
            "authorization_code": "133937",
            "retrieval_reference_number": "20180510122911535",
            "voucher": null,
            "card_data": {
              "holder_name": "YUNO TESTER",
              "iin": "42424242",
              "lfd": "4242",
              "number_length": 16,
              "security_code_length": 3,
              "brand": "VISA",
              "scheme": "VISA",
              "issuer_name": "STRIPE PAYMENTS UK",
              "issuer_code": null,
              "country_code": "GB",
              "category": "CLASSIC",
              "type": "CREDIT",
              "three_d_secure": {
                "version": null,
                "electronic_commerce_indicator": null,
                "cryptogram": null,
                "transaction_id": null,
                "directory_server_transaction_id": null,
                "pares_status": null,
                "acs_id": null
              },
              "fingerprint": "4a4c0ff4-6e9e-455d-a104-3e771579a536",
              "expiration_month": 3,
              "expiration_year": 30
            },
            "stored_credentials": null,
            "verification_services": {
              "address_line_1_check": "UNCHECKED",
              "zip_code_check": "UNCHECKED",
              "card_holder_name_check": "UNCHECKED",
              "card_security_code_check": "UNCHECKED"
            }
          }
        }
      },
      "response_code": "SUCCEEDED",
      "response_message": "Transaction successful",
      "reason": null,
      "description": "pay-test purchase",
      "merchant_reference": "pt-1789681395403",
      "provider_data": {
        "id": "ZOOP",
        "transaction_id": "af8fd4e75b614591a03b2125b53907a4",
        "account_id": "",
        "status": "succeeded",
        "sub_status": "",
        "status_detail": "",
        "response_message": null,
        "response_code": "00",
        "raw_request": "\"{\\\"payment_type\\\":\\\"credit\\\",\\\"source\\\":{\\\"card\\\":{\\\"card_number\\\":\\\"a198286a-f433-4603-842b-e7dfc2ec0801\\\",\\\"security_code\\\":\\\"e2056811-39fc-444a-a355-41aa514c277f\\\",\\\"holder_name\\\":\\\"YUNO TESTER\\\",\\\"expiration_month\\\":\\\"3\\\",\\\"expiration_year\\\":\\\"2030\\\"},\\\"usage\\\":\\\"single_use\\\",\\\"amount\\\":1000,\\\"currency\\\":\\\"BRL\\\",\\\"type\\\":\\\"card\\\"},\\\"on_behalf_of\\\":\\\"4a8418ddc83f4b4fbd6f442902a4e3b3\\\",\\\"capture\\\":true,\\\"description\\\":\\\"pay-test purchase\\\",\\\"reference_id\\\":\\\"77b11fef-5c38-4ecf-9607-015594ee0bc4\\\",\\\"split_rules\\\":[{\\\"recipient\\\":\\\"3258673725454c5cafaec0210674eb8d\\\",\\\"liable\\\":false,\\\"charge_processing_fee\\\":false,\\\"amount\\\":600}]}\"",
        "raw_request_details": {
          "headers": {
            "Authorization": [
              "[REDACTED]"
            ],
            "X-Account-Integration-Code": [
              "[REDACTED]"
            ],
            "X-Dynamic-Mtls": [
              "[REDACTED]"
            ],
            "x-api-key": [
              "[REDACTED]"
            ]
          },
          "method": "POST",
          "url": "/v1/marketplaces/7fcca632f35f4efa8143238d28a89cd9/transactions"
        },
        "raw_response_details": {
          "http_status_code": 201
        },
        "third_party_transaction_id": "",
        "third_party_account_id": "",
        "iso8583_response_code": null,
        "iso8583_response_message": null,
        "retrieval_reference_number": null,
        "merchant_advice_code": null,
        "merchant_advice_code_message": null,
        "reason_code": null,
        "reason_description": null
      },
      "connection_data": {
        "id": "99d88722-2c77-4281-ad92-f74df11bc8b9",
        "name": "zoop"
      },
      "created_at": "2026-09-17T21:43:16.232391Z",
      "updated_at": "2026-09-17T21:43:18.778608Z",
      "split_marketplace": [
        {
          "recipient_id": null,
          "recipient_type": null,
          "provider_recipient_id": "4c036fbdd2a44786815c331e9c011367",
          "type": "MARKETPLACE",
          "merchant_reference": null,
          "amount": {
            "value": 6,
            "currency": "BRL"
          },
          "liability": null,
          "description": null
        }
      ],
      "merchant_advice_code": null,
      "merchant_advice_code_message": null
    }
  ],
  "split_marketplace": [],
  "workflow": "DIRECT",
  "fraud_screening": null,
  "metadata": [],
  "shipping": null,
  "payment_link_code": "",
  "routing_rules": {
    "smart_routing": false,
    "monitors": false,
    "condition": {
      "id": 279053,
      "name": null,
      "description": null
    }
  }
}

​When an update is accepted

​Idempotency

​Where to read the split

​When the provider does not confirm

​Refunds while an update is open

​Response codes

Authorizations

Headers

Path Parameters

Body

Response

When an update is accepted

Idempotency

Where to read the split

When the provider does not confirm

Refunds while an update is open

Response codes