Skip to content

order.paid

order.paid is sent when an order becomes paid. Usually that means the provider settled the payment — a first order from the widget or a renewal; then payment carries the snapshot of that payment and confirmed_manually is false. The other path is the merchant confirming the payment by hand in the panel (money that arrived outside Neocarts, say): then payment is null and confirmed_manually is true.

When the payment went through the provider, the event fires after the order’s subscriptions were started or renewed, so subscription_ids in the snapshot is already filled. A manual confirmation starts or renews no subscription: without the provider’s answer there is no card token, and a subscription without a card cannot be charged. Confirming an already paid order again sends nothing. This is the «create the order in my system» moment.

Field Type Description
payment object, nullable The payment that settled the order, in the payment snapshot shape. null when the payment was confirmed by hand.
confirmed_manually boolean true — the merchant confirmed the payment in the panel; false — the payment went through the provider.

The rest of data is the order snapshot.

The same order as in order.created, a minute and a half later: the payment settled and the subscription started.

{
"id": "019a0b7c-1f3e-7c1a-9c6e-0b9b1c2d3e50",
"event": "order.paid",
"created_at": "2026-10-04T09:14:05+00:00",
"shop_id": "7f3c2b1a-0d9e-4f8a-b7c6-d5e4f3a2b1c0",
"data": {
"id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
"number": "261004-48213",
"status": "paid",
"source": "widget",
"locale": "uk",
"items": [
{
"external_id": "SKU-1",
"title": "Brit Care Adult Large Breed",
"variant": "12 кг",
"image_url": "https://shop.example.com/i/brit.jpg",
"product_url": "https://shop.example.com/p/brit",
"price": 249000,
"quantity": 1,
"mode": "subscription",
"interval_value": 4,
"interval_unit": "week",
"discounted_price": 231570,
"subtotal": 249000,
"total": 231570
}
],
"discount_percent": 7,
"contact": {
"first_name": "Олена",
"last_name": "Коваль",
"email": "[email protected]",
"phone": "+380671234567"
},
"delivery": {
"provider": "nova-poshta",
"type": "branch",
"data": {
"city": { "id": "…", "external_id": "8d5a980d-391c-11dd-90d9-001a92567626", "name": "Київ" },
"branch": { "id": "…", "external_id": "1ec09d88-e1c2-11e3-8c4a-0050568002cf", "name": "Відділення №1: вул. Пирогівський шлях, 135" }
},
"recipient": { "first_name": "Олена", "last_name": "Коваль", "phone": "+380671234567" }
},
"totals": { "items_total": 249000, "discount_total": 17430, "total": 231570 },
"subscription_ids": ["0199a1b3-5e6f-7a8b-9c0d-1e2f3a4b5c6d"],
"created_at": "2026-10-04T09:12:30+00:00",
"payment": {
"id": "0199a1b4-0a1b-7c2d-8e3f-4a5b6c7d8e9f",
"order_id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
"provider": "plata-by-mono",
"status": "success",
"amount": 231570,
"refunded_amount": 0,
"card_mask": "**** 4242",
"card_brand": "visa",
"created_at": "2026-10-04T09:12:41+00:00"
},
"confirmed_manually": false
}
}

With a manual confirmation the object is replaced by "payment": null, "confirmed_manually": true.

  • Create the order in your system and start fulfilment: data.totals.total is what the shopper paid, data.delivery is where it goes.
  • For source: "subscription" this is the next delivery of a subscription: take the lines and the address from the snapshot, not from the first order — the price or the address may have changed.
  • Link the order to its subscriptions through subscription_ids; their snapshots arrive separately in subscription.created or subscription.renewed — the order between them and this event is not guaranteed.
  • If confirmed_manually: true, there is no card behind the order: no subscription starts from it, and a renewal will not be charged automatically.

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