Инструмент: get_payment_status
Инструмент get_payment_status проверяет фактический статус конкретной оплаты по её invoiceId - через тот же путь, что использует виджет CloudPayments в магазине (GET /api/payments/order/{invoiceId}/status).
Зачем нужен именно этот инструмент#
Агент не имеет права сообщать «оплата прошла» на основании своих рассуждений или прошлых реплик в диалоге - только по ответу get_payment_status. Это защита от ложного подтверждения платежа: деньги реальные, ошибиться здесь дороже, чем в обычном диалоге поддержки.
Возможные статусы#
| Статус | Что означает |
|---|---|
completed |
Оплата прошла, пробирки или искры зачислены на баланс |
pending |
Платёж создан, но подтверждение от CloudPayments ещё не пришло |
failed |
Оплата не прошла |
cancelled |
Оплата отменена |
Как вызвать#
Обычно вызывается после того, как вы сообщили агенту, что оплатили:
- «Я оплатил, проверь»
- «Прошла ли оплата?»
- «Проверь мой платёж»
Агенту нужен invoiceId - он выдаётся при создании заказа в магазине (виджет CloudPayments), не выдумывайте его вручную.
Требования#
- Авторизация: требуется.
- Платёж должен принадлежать вашему аккаунту - иначе
[not_found].
