link_refund
Mark an existing transaction as a refund of another transaction. Provide originalTxId (the transaction being refunded) and refundTxId (the refund transaction). The two transactions must have opposite types (income vs expense). Optionally target a specific split of the original. One refund can cover several purchases: call once per purchase, each with an amount; the amounts cannot exceed the refund, and in the same currency the amounts against one purchase or split cannot exceed it. Requires finance:write scope.
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": {
"originalTxId": "<originalTxId>",
"refundTxId": "<refundTxId>"
},
"name": "link_refund"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount | No | Share of the refund transaction (decimal, in the refund transaction's currency) that this link covers. Omit to link the whole refund. Required on every link when one refund covers several purchases. | |
| splitId | No | UUID of a specific split on the original transaction this refund targets | |
| refundTxId | Yes | ID of the transaction that represents the refund | |
| originalTxId | Yes | ID of the original transaction being refunded. Pass null for a standalone refund |