Developer portal: webhooks, REST API, and integration patterns
Subscribe to order and inventory events, verify signatures, and build ERP connectors — the technical guide for Arab integrators.
Agencies and in-house teams connect Mrfqy to accounting, WMS, and custom mobile apps through the developer portal. Webhooks deliver near-real-time events; the REST API covers CRUD for catalog, orders, and customers with OAuth-scoped keys.
Developer portal overview
Register as a partner, create apps, and manage sandbox vs production credentials. Documentation covers auth flows, rate limits, and error codes.
Test stores let you replay webhook payloads without touching live merchant data.
Webhooks and signatures
Subscribe to order.created, order.paid, fulfillment.updated, and inventory.adjusted. Each payload includes store ID and event timestamp for idempotent handlers.
Verify HMAC signatures with your app secret before processing — reject replays older than five minutes.
REST API patterns
Use cursor pagination on list endpoints. Expand related objects sparingly — fetch order lines in a second call when batch size is large.
Idempotency-Key headers on POST requests prevent duplicate shipments when networks flap.
ERP and WMS integration recipes
Common pattern: webhook pushes order to queue, worker maps SKUs to ERP item codes, posts invoice, writes tracking back via API.
Inventory sync nightly from ERP to Mrfqy warehouse bins — event webhooks handle intraday adjustments.
Ship a production app
Complete security review, document uninstall cleanup, and publish to the marketplace directory when ready.