Webhooks

​

Webhooks Overview

​

Webhook Events

​

Order Events

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

​

Registering 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

{
  "event": "order.fulfilled",
  "timestamp": "2023-01-01T12:00:00+00:00",
  "data": {
    // Event-specific data
  }
}

​

Example Payloads

​

Order Fulfilled Event

{
  "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"
    }
  }
}

​

Security

​

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