Skip to main content

​
Webhooks Overview

Webhooks allow your application to receive real-time notifications about important events occurring in Manastore. Instead of polling the API, webhooks push event data directly to your application’s endpoint.

​
Webhook Events

​
Order Events

  • order.fulfilled: An order has been fulfilled and completed

​
Registering a Webhook

To register a webhook:
  1. Log in to your Manastore account and navigate to Account Settings → Webhook
  2. Enter your public HTTPS URL endpoint in the webhook URL field
  3. Save your settings — Manastore will immediately begin sending events to your endpoint

​
Webhook Payload Format

All webhook events follow this standard format: 
{
  "event": "order.completed",
  "timestamp": "2023-01-01T12:00:00+00:00",
  "data": {
    // Event-specific data
  }
}

​
Example Payloads

​
Order Fulfilled Event

{
  "id": "evt_1234567890",
  "event": "order.fulfilled",
  "timestamp": "2023-01-01T12:00:00+00:00",
  "data": {
    "id": 12345,
    "ulid": "01J9Z3NDEKTSV4RRFFQ69G5FAV",
    "order_number": "#ORD-12345",
    "fulfillment_status": "completed",
    "payment_status": "completed",
    "total": {
      "amount": 102.49,
      "formatted": "€102.49"
    }
  }
}

​
Best Practices

  • Return Quickly: Process the webhook and return a 2xx response immediately
  • Retry Logic: Manastore retries failed webhooks up to 3 times with exponential backoff
  • HTTPS Only: Webhooks are only sent to HTTPS endpoints
  • Timeout: Your endpoint must respond within 10 seconds