payment.refunded
payment.refunded надсилається після кожного повернення грошей за успішним платежем — повного чи часткового. Повертає продавець зі сторінки платежу в панелі; крім того, Neocarts повертає гроші автоматично, коли оплата з віджета пройшла, але провайдер не зберіг токен картки (підписку без картки не продовжити), і після кожної заміни картки самим покупцем — це платіж на 1 ₴ (100 копійок) без замовлення, тому в ньому order_id: null. Повернути можна лише платіж зі status: "success" і не більше, ніж залишилося невідшкодованим.
Подія несе два числа: refund_amount — скільки повернуто цим разом, і refunded_amount у знімку — скільки повернуто загалом. Коли накопичена сума досягає amount, статус платежу стає refunded; після часткового повернення він лишається success.
Поля події
Section titled “Поля події”| Поле | Тип | Опис |
|---|---|---|
refund_amount |
integer, копійки | Сума саме цього повернення. |
Решта data — знімок платежу.
Приклад
Section titled “Приклад”Часткове повернення 500,00 ₴ за платежем із order.paid: платіж лишається success.
{ "id": "019a0b7c-1f3e-7c1a-9c6e-0b9b1c2d3e53", "event": "payment.refunded", "created_at": "2026-10-06T14:30:00+00:00", "shop_id": "7f3c2b1a-0d9e-4f8a-b7c6-d5e4f3a2b1c0", "data": { "id": "0199a1b4-0a1b-7c2d-8e3f-4a5b6c7d8e9f", "order_id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b", "provider": "plata-by-mono", "status": "success", "amount": 231570, "refunded_amount": 50000, "card_mask": "**** 4242", "card_brand": "visa", "created_at": "2026-10-04T09:12:41+00:00", "refund_amount": 50000 }}Повне повернення тієї ж суми мало б "status": "refunded", "refunded_amount": 231570, "refund_amount": 231570.
Що робити
Section titled “Що робити”- Проведіть повернення у своєму обліку на
refund_amount; заorder_idзнайдіть замовлення, створене зorder.paid. order_id: null— це повернення 1 ₴ після заміни картки; продажу за ним не було (order.paidне приходив), тож у обліку його можна пропустити. Нову картку несеsubscription.updatedзchanged: ["card"].- Не підсумовуйте
refund_amountсамі — звіряйте залишок ізrefunded_amountу знімку: повтор доставки з тим самимidне має подвоїти суму. status: "refunded"означає, що повернуто все; підписку й замовлення це саме по собі не змінює — їх статуси приходять окремими подіями.
Повʼязані події
Section titled “Повʼязані події”order.paid— платіж, за яким відбувається поверненняorder.cancelled— неоплачене замовлення закрито — без повернення
Заголовки запиту, підпис і повтори — в огляді; порядок подій — у послідовності подій.