Перейти до вмісту

payment.refunded

payment.refunded надсилається після кожного повернення грошей за успішним платежем — повного чи часткового. Повертає продавець зі сторінки платежу в панелі; крім того, Neocarts повертає гроші автоматично, коли оплата з віджета пройшла, але провайдер не зберіг токен картки (підписку без картки не продовжити), і після кожної заміни картки самим покупцем — це платіж на 1 ₴ (100 копійок) без замовлення, тому в ньому order_id: null. Повернути можна лише платіж зі status: "success" і не більше, ніж залишилося невідшкодованим.

Подія несе два числа: refund_amount — скільки повернуто цим разом, і refunded_amount у знімку — скільки повернуто загалом. Коли накопичена сума досягає amount, статус платежу стає refunded; після часткового повернення він лишається success.

Поле Тип Опис
refund_amount integer, копійки Сума саме цього повернення.

Решта data — знімок платежу.

Часткове повернення 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.

  • Проведіть повернення у своєму обліку на refund_amount; за order_id знайдіть замовлення, створене з order.paid.
  • order_id: null — це повернення 1 ₴ після заміни картки; продажу за ним не було (order.paid не приходив), тож у обліку його можна пропустити. Нову картку несе subscription.updated з changed: ["card"].
  • Не підсумовуйте refund_amount самі — звіряйте залишок із refunded_amount у знімку: повтор доставки з тим самим id не має подвоїти суму.
  • status: "refunded" означає, що повернуто все; підписку й замовлення це саме по собі не змінює — їх статуси приходять окремими подіями.
  • order.paid — платіж, за яким відбувається повернення
  • order.cancelled — неоплачене замовлення закрито — без повернення

Заголовки запиту, підпис і повтори — в огляді; порядок подій — у послідовності подій.