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.
Event fields
Section titled “Event fields”| 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.
Example
Section titled “Example”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": "Коваль", "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.
What to do
Section titled “What to do”- Create the order in your system and start fulfilment:
data.totals.totalis what the shopper paid,data.deliveryis 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 insubscription.createdorsubscription.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.
Related events
Section titled “Related events”order.created— the order was placed, payment still aheadsubscription.created— a subscription started from a paid widget ordersubscription.renewed— a paid renewal pushed next_charge_at out
Request headers, signature and retries are in the overview; the order of events is in the event flow.