payment.refunded
payment.refunded is sent after every refund on a successful payment — full or partial. The merchant refunds from the payment’s page in the panel; Neocarts also refunds automatically when a widget payment went through but the provider saved no card token (a subscription without a card cannot be renewed), and after every card replacement by the shopper themselves — that is a 1 ₴ (100 kopecks) payment with no order, so it carries order_id: null. Only a payment with status: "success" can be refunded, and never more than what is still unrefunded.
The event carries two numbers: refund_amount — how much went back this time, and refunded_amount in the snapshot — how much has gone back in total. When the total reaches amount the payment status becomes refunded; after a partial refund it stays success.
Event fields
Section titled “Event fields”| Field | Type | Description |
|---|---|---|
refund_amount |
integer, kopecks | The amount of this particular refund. |
The rest of data is the payment snapshot.
Example
Section titled “Example”A partial refund of 500,00 ₴ on the payment from order.paid: the payment stays 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 }}A full refund of the same payment would read "status": "refunded", "refunded_amount": 231570, "refund_amount": 231570.
What to do
Section titled “What to do”- Book the refund in your accounting for
refund_amount; find the order you created onorder.paidthroughorder_id. order_id: nullis the 1 ₴ refund after a card replacement; there was no sale behind it (noorder.paidcame), so your accounting can skip it. The new card comes insubscription.updatedwithchanged: ["card"].- Do not add up
refund_amountyourself — reconcile againstrefunded_amountin the snapshot: a redelivery with the sameidmust not double the sum. status: "refunded"means everything went back; by itself it changes neither the subscription nor the order — their statuses arrive as separate events.
Related events
Section titled “Related events”order.paid— the payment the refund is made onorder.cancelled— an unpaid order was closed — no refund involved
Request headers, signature and retries are in the overview; the order of events is in the event flow.