Build on Mrfqy
OAuth apps, typed SDK, signed webhooks, and a marketplace pipeline — one developer portal for integrations that understand Arab commerce: COD, VAT lines, bilingual catalog, and country packs.
Ship an integration in three steps
Register your app
Create OAuth credentials, redirect URIs, and scopes in the developer portal.
Integrate & test
Use the SDK or REST API against a free sandbox store — mirror country packs before go-live.
Submit to marketplace
Pass HQ review, publish your listing, and monetize with install fees and revenue share.
Start with code
List orders with the SDK or curl — same REST surface behind the merchant dashboard.
The SDK is available to approved partners via the developer portal. Public npm publish is coming soon — no false npm install until then.
import { MrfqyClient } from "@mrfqy/sdk";
const client = new MrfqyClient({
apiKey: process.env.MRFQY_ACCESS_TOKEN!,
baseUrl: "https://api.mrfqy.com/api/v1",
});
const page = await client.listOrders(1, 20);
for (const order of page.data) {
console.log(order.orderNumber, order.currency, order.total);
}Platform capabilities
Everything you need to build ERP bridges, fulfillment tools, and vertical SaaS on Arab commerce data.
OAuth 2.0 registration
Create apps, define scopes, and distribute install links. Merchants approve access on a consent screen.
Typed SDK
Catalog, orders, customers, and inventory with currency fields and bilingual title/slug types.
Signed webhooks
Verify payloads with HMAC signatures, inspect retry logs, and process order and dropship events reliably.
Marketplace pipeline
Submit for review, publish listings, charge install fees, and share revenue with the platform.
What developers build
ERP & accounting bridges
Sync orders with VAT lines and local currency totals into accounting packages merchants already use.
Custom fulfillment tools
Subscribe to shipment webhooks with carrier codes recognized across Arab markets — push status back through the API.
Vertical SaaS apps
List niche tools on the marketplace — reach merchants with OAuth install and scoped permissions.
Free sandbox store
Spin up a developer sandbox without billing. Test OAuth flows, webhook endpoints, and SDK calls against realistic country-pack data.
- Mirror Egypt, KSA, UAE, and other country packs with fake transactions
- UTF-8 throughout — Arabic product copy round-trips correctly
- Fair rate limits with documented scaling guidance
Monetize on the marketplace
Paid installs settle through marketplace billing. Configure one-time install fees, monthly subscriptions, and platform revenue share.
API preview
Static example — authenticate in the portal for live keys.
/api/v1/sdk/ordersGET /api/v1/sdk/orders?page=1&pageSize=5 HTTP/1.1 Host: api.mrfqy.com Authorization: Bearer oat_demo_token Accept: application/json
HTTP/1.1 200 OK
Content-Type: application/json
{
"data": [
{
"id": "ord_01k2…",
"orderNumber": "1042",
"status": "paid",
"currency": "EGP",
"total": "890.00",
"lines": [
{
"title": { "en": "Linen abaya", "ar": "عباية كتان" },
"quantity": 1,
"price": "890.00"
}
]
}
],
"total": 42,
"page": 1,
"pageSize": 5
}Built for Arab commerce APIs
Integrations built for generic US carts miss COD states, VAT lines, and governorate shipping. Mrfqy exposes currency amounts and country-pack metadata in webhooks and SDK types.
- Order objects include tax lines and payment states merchants expect locally
- Bilingual catalog fields — title and slug as locale maps, not plain strings
- Same login as merchants — your app installs into their existing workspace
Developer FAQ
Ready to build?
Open the developer portal to register your first OAuth app and sandbox store.
Explore the platform
Deep dives into the capabilities that help Arab merchants launch, sell, and grow.