Create split payment
create_split_paymentCreate a split payment to distribute a single transaction among multiple marketplace partners, specifying amounts and platform fees for each recipient.
Instructions
Create a split payment for marketplaces (distributes funds among partner shops). Requires the YooKassa-for-platforms product. MOVES REAL MONEY — irreversible.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"amount": "<amount>",
"description": "<description>",
"transfers": "<transfers>"
},
"name": "create_split_payment"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount | Yes | Total payment amount | |
| currency | No | Currency (ISO-4217, default RUB) | RUB |
| transfers | Yes | Recipients (splits). The sum of transfers must equal amount. Requires the Split Payments product | |
| return_url | No | Return URL — REQUIRED when confirmation_type=redirect | |
| description | Yes | Payment description | |
| confirmation_type | No | Confirmation type: redirect (needs return_url), embedded, or qr | redirect |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ||
| paid | No | ||
| amount | No | ||
| status | No | ||
| confirmation_url | No |