ابنِ على مِرفقي
تطبيقات OAuth، SDK مُ typed، webhooks موقّعة، ومسار سوق — بوابة مطورين واحدة لتكاملات تفهم التجارة العربية: COD، ضريبة القيمة المضافة، كatalog ثنائي اللغة، وحزم الدول.
أطلق تكاملاً في ثلاث خطوات
سجّل تطبيقك
أنشئ بيانات OAuth وروابط إعادة التوجيه والصلاحيات في بوابة المطورين.
كامل واختبر
استخدم SDK أو REST API على متجر sandbox مجاني — انعكس حزم الدول قبل الإطلاق.
قدّم للسوق
اجتز مراجعة HQ، انشر قائمتك، واربح برسوم التثبيت وحصة الإيراد.
ابدأ بالكود
اعرض الطلبات عبر SDK أو curl — نفس واجهة REST خلف لوحة التاجر.
SDK متاح للشركاء المعتمدين عبر بوابة المطورين. النشر العام على npm قريباً — لا npm install وهمي حتى ذلك الحين.
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);
}قدرات المنصة
كل ما تحتاجه لبناء جسور ERP، أدوات تنفيذ، وSaaS عمودي على بيانات التجارة العربية.
تسجيل OAuth 2.0
أنشئ التطبيقات، حدّد الصلاحيات، ووزّع روابط التثبيت. التجار يوافقون من شاشة موافقة.
SDK مُ typed
كتalog، طلبات، عملاء، ومخزون مع حقول العملة وأنواع title/slug ثنائية اللغة.
Webhooks موقّعة
تحقق من الحمولات بتوقيع HMAC، راجع سجلات إعادة المحاولة، وعالج أحداث الطلبات والdropship.
مسار السوق
قدّم للمراجعة، انشر القوائم، فرض رسوم التثبيت، وشارك الإيراد مع المنصة.
ما يبنيه المطورون
جسور ERP والمحاسبة
زامن الطلبات مع ضريبة القيمة المضافة وإجماليات العملة المحلية في حزم المحاسبة التي يستخدمها التجار.
أدوات تنفيذ مخصصة
اشترك في webhooks الشحن برموز ناقلين معروفة في الأسواق العربية — ادفع الحالة عبر API.
تطبيقات SaaS عمودية
اعرض أدوات متخصصة في السوق — reach merchants بتثبيت OAuth وصلاحيات محددة.
متجر sandbox مجاني
أنشئ sandbox للمطورين دون فوترة. اختبر OAuth وwebhooks وSDK على بيانات حزم دول واقعية.
- انعكس مصر والسعودية والإمارات وحزم دول أخرى بمعاملات وهمية
- UTF-8 في كل مكان — نص المنتج العربي يمرّ ذهاباً وإياباً
- حدود معدل عادلة مع إرشادات توسّع موثّقة
اربح في السوق
التثبيتات المدفوعة تُسوّى عبر فوترة السوق. اضبط رسوم التثبيت، الاشتراكات الشهرية، وحصة إيراد المنصة.
معاينة API
مثال ثابت — صادق في البوابة للمفاتيح الحية.
/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
}مصمم لـ APIs التجارة العربية
التكاملات المبنية لسلال US العامة تفوت COD وضريبة القيمة المضافة وشحن المحافظات. مِرفقي يعرض مبالغ العملة وبيانات حزم الدول في webhooks وأنواع SDK.
- كائنات الطلب تتضمن ضريبة القيمة المضافة وحالات الدفع المحلية
- حقول catalog ثنائية اللغة — title وslug كخرائط locale
- نفس تسجيل الدخول للتجار — تطبيقك يُثبّت في workspace موجود
أسئلة المطورين
مستعد للبناء؟
افتح بوابة المطورين لتسجيل أول تطبيق OAuth ومتجر sandbox.
استكشف المنصة
تعمّق في القدرات التي تساعد التجار العرب على الإطلاق والبيع والنمو.
