Ordafy
Website Integration
11 min read
0 views

Enterprise API: Orders, Bookings & Webhooks

Use Ordafy Enterprise API keys to create provider orders and bookings, receive webhooks, and run headless commerce alongside widgets.

Who this is for

Enterprise organizations with apiAccess can create API keys in Settings → Website integration → API Keys.

Authentication

Send Authorization: Bearer ordafy_live_… or ordafy_test_… on every request. Use Idempotency-Key on POST creates for safe retries.

OpenAPI reference: apps/api/docs/public-v1.openapi.yaml (merchant namespace).

Provider orders

  • POST /api/public/v1/merchant/orders — line items with productVariantId, customer email or id, pickup/delivery
  • GET /api/public/v1/merchant/orders — paginated list
  • PATCH /api/public/v1/merchant/orders/{orderId} — status transitions (confirm, cancel, processing, delivered)

Customers receive the same confirmation email as dashboard-created orders when an email is provided.

Provider bookings

  • POST /api/public/v1/merchant/bookings — scheduledDate, optional scheduledTime (validated against availability)
  • PATCH /api/public/v1/merchant/bookings/{bookingId} — confirm, cancel, complete, or reschedule

Webhooks

Register endpoints under Website integration → Webhooks. Events include order.created, order.updated, booking.created, booking.updated, and payment.completed. Verify Ordafy-Signature (HMAC-SHA256).

Headless loop

  1. Create catalog via POST /merchant/products or /merchant/services
  2. Customers book via widget or hosted links
  3. Or create orders/bookings entirely via API for phone/walk-in sales
  4. Receive webhooks in your ERP or CRM