Webhooks

Receive real-time notifications about events in your Nevuto store.

Webhooks let you receive real-time HTTP notifications when events happen in your Nevuto store.

Setting Up Webhooks

POST /v1/webhooks

{
  "url": "https://example.com/webhooks/nevuto",
  "events": ["order.created", "order.paid", "payment.refunded"]
}

Event Types

Event	Description
`order.created`	A new order was placed
`order.paid`	Payment was received for an order
`order.fulfilled`	Order was marked as fulfilled
`order.cancelled`	Order was cancelled
`payment.refunded`	A payment was refunded
`product.created`	A new product was added
`product.updated`	A product was modified

Webhook Payload

{
  "id": "evt_abc123",
  "type": "order.paid",
  "createdAt": "2026-04-02T14:30:00Z",
  "data": {
    "id": "order_xyz789",
    "storeId": "store_abc123",
    "total": 2999,
    "currency": "USD"
  }
}

Verifying Signatures

Every webhook includes a X-Nevuto-Signature header. Verify it to ensure the request is authentic:

import { Nevuto } from '@nevuto/sdk'

const isValid = Nevuto.webhooks.verify(
  payload,
  signature,
  webhookSecret
)

Retry Policy

If your endpoint returns a non-2xx status, Nevuto will retry up to 5 times with exponential backoff.