refund-payment

/refund-payment — Возврат и отмена

Алгоритм

1. get_payment_state (payment_id) — текущий статус платежа. Без этого шага не действовать: от статуса зависит, какой инструмент нужен.
2. Выбери операцию по статусу:
   • деньги уже списаны (платёж завершён) → refund_payment (payment_id, amount);
   • средства только захолдированы двухстадийным платежом, списания не было → cancel_payment (payment_id, amount);
   • нужно, наоборот, дозавершить холд → confirm_payment (payment_id, amount).
3. Сумма не указана — возврат полный. Указана меньшая — частичный возврат; сумма всегда в рублях.
4. Покажи пользователю, что именно вернётся и с какого платежа, и дождись подтверждения. Возврат необратим.
5. Выполни операцию и перечитай get_payment_state — покажи новый статус.
6. Если по платежу пробивался чек, отправь закрывающий: send_closing_receipt (payment_id, email, phone, taxation, items — позиции с Name, Price, Quantity, Amount, Tax).

Важно

• refund_payment и cancel_payment — разные операции, а не синонимы: возврат идёт после списания, отмена — до него. Ошибка выбора даёт отказ банка, а не молчаливый успех.
• Частичный возврат можно повторять до исчерпания суммы платежа; складывай уже возвращённое, прежде чем назвать доступный остаток.
• Ставка НДС в позициях чека (Tax) обязана совпадать с исходным чеком продажи, иначе ФНС отклонит.

Формат ответа

## Возврат T-Kassa

**Платёж**: 3812934821 (заказ ORD-1042)
**Статус до**: CONFIRMED · сумма 12 000 ₽
**Операция**: refund_payment, частичный возврат 4 500 ₽
**Статус после**: PARTIAL_REVERSED
**Доступно к возврату**: 7 500 ₽

Закрывающий чек отправлен на [email protected].

Примеры

/refund-payment 3812934821
/refund-payment 3812934821 4500
/refund-payment проверь статус 3812934821