Skip to content

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.

Field Type Description
refund_amount integer, kopecks The amount of this particular refund.

The rest of data is the payment snapshot.

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.

  • Book the refund in your accounting for refund_amount; find the order you created on order.paid through order_id.
  • order_id: null is the 1 ₴ refund after a card replacement; there was no sale behind it (no order.paid came), so your accounting can skip it. The new card comes in subscription.updated with changed: ["card"].
  • Do not add up refund_amount yourself — reconcile against refunded_amount in the snapshot: a redelivery with the same id must 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.

Request headers, signature and retries are in the overview; the order of events is in the event flow.