للبنوك وشركات الوساطة وتطبيقات الفنتك

واجهة برمجة الشركاء من أمتار (Partner API)

قدّم لعملائك ملكية جزئية في عقارات تجارية مؤجرة في مصر، من داخل منتجك أنت. سجّل عملاءك، وبِع لهم الحصص، واعرض لهم دخل الإيجار، وتابع كل طلب وكل عمولة من خلال إشعارات موقّعة.

اطلب صلاحية الشريك اقرأ دليل الربط

REST + JSON · OpenAPI 3.1
إشعارات موقّعة (Webhooks)
بيئة تجريبية مع محاكيات
عمليات آمنة عند إعادة المحاولة
منصة مرخّصة من الرقابة المالية

ثلاث طرق للربط

ابدأ بطريقة واحدة وأضف غيرها لاحقًا. تُفعَّل كل طريقة لحساب الشريك حسب الاتفاق.

الإحالة

سجّل عميلك بطلب واحد، ووجّهه إلى تطبيق أمتار. يستثمر من التطبيق، وأنت تتابع طلباته وتحصل على عمولتك.

داخل تطبيقك، بتسوية من الشريك

عملاؤك يتصفحون الوحدات ويشترون من داخل تطبيقك. تخصم المبلغ من حسابهم وتحوّله لأمتار، ونحن نؤكد استلام المبلغ ونصدر الحصص.

داخل تطبيقك، بالدفع بالكارت

عملاؤك يشترون من داخل تطبيقك ويدفعون على صفحة دفع بالكارت من أمتار تفتحها داخل التطبيق.

ماذا تغطي الواجهة

الوحدات والأسعار

العقارات المنشورة والحصص المتبقية وسعر الحصة والرسوم والتوقعات، مع عرض سعر دقيق لأي عدد من الحصص.

العملاء والموافقة

فتح حساب في أمتار لعميل جديد، أو ربط مستثمر حالي بعد أن يؤكد الكود الذي نرسله له في رسالة.

الطلبات والتسوية

حجز الحصص بسعر اليوم، ثم تسوية المبلغ أو فتح صفحة الدفع بالكارت، ومتابعة الطلب حتى الإتمام.

المحفظة ودخل الإيجار

الحصص في كل عقار والمبلغ المستثمر ودفعات الإيجار الربع سنوية والعقود ورصيد المحفظة، بعد الحصول على الصلاحية.

العمولات

كل رسوم تسجيل وعمولة شراء ومكافأة ودفعة في دفتر الشريك، مع الإجماليات والرصيد.

الأحداث والإشعارات

إشعارات موقّعة لكل تغيير مع إعادة المحاولة تلقائيًا، وسجل أحداث لاستكمال ما فاتك بعد أي انقطاع.

المستندات

كل ما يحتاجه فريق المنتج والتطوير لديك. المستندات باللغة الإنجليزية.

صفحة ويب · بالإنجليزية

دليل الربط

طرق الربط، والخطوات، والتسوية، والإشعارات مع أمثلة برمجية، والأخطاء، والاختبار، وقائمة التشغيل.

اقرأ أونلاين →

PDF · 0.5 ميجابايت

دليل الربط (PDF)

نفس الدليل كملف PDF لمشاركته مع فريقك.

حمّل الـ PDF →

تفاعلي · 35 نقطة اتصال · 14 حدثًا

مرجع الواجهة

كل نقطة اتصال وحقل وكود خطأ وحدث، مع أمثلة للطلبات والردود.

افتح المرجع →

JSON · OpenAPI 3.1

عقد OpenAPI 3.1

العقد بصيغة يقرأها الكمبيوتر. استورده في Postman أو أنشئ منه مكتبة بلغة البرمجة التي تستخدمها.

حمّل openapi.json →

شكل الطلب

تسجيل عميل. مفتاح عدم التكرار (Idempotency-Key) يجعل إعادة الطلب ترجع نفس العميل بدل إنشاء عميل ثانٍ.

curl -X POST https://api.amtaar.co/open/v1/customers \
  -H "Authorization: Bearer amtk_live_…" \
  -H "Idempotency-Key: 4f0c6a5e-2a3b-4f7e-9f1e-0c1d2e3f4a5b" \
  -H "Content-Type: application/json" \
  -d '{ "phone": "+201001234567", "externalId": "your-user-88213" }'

{
  "object": "customer",
  "id": "cus_6712c0ffee0123456789abcd",
  "status": "onboarding",
  "kyc": { "status": "pending", "missingSteps": ["identity_verification"] },
  "canInvest": false,
  "links": { "app": "https://api.amtaar.co/p/your_partner_code" }
}

من الاتفاق إلى التشغيل

1
الاتفاق
نتفق على طريقة الربط وشروط العمولة، وفي حالة التسوية من الشريك: حساب التسوية والاعتماد على اعرف عميلك (KYC) لديك.
2
مفاتيح البيئة التجريبية
يحصل فريقك على مفاتيح لبيئة تجريبية كاملة، بها محاكيات للطلبات والتحقق، ولا تتحرك فيها أموال حقيقية.
3
البناء والاختبار
اربط منتجك بالبيئة التجريبية باستخدام الدليل والمرجع، وسجّل رابط الإشعارات الخاص بك.
4
الاعتماد
نراجع مع فريقك قائمة متطلبات التشغيل.
5
التشغيل
نصدر مفاتيح التشغيل، ويمكن قصرها على عناوين خوادمك، ونفعّل الصلاحيات المتفق عليها.

مصممة لشركاء خاضعين للرقابة

أمتار كابيتال مرخّصة من الهيئة العامة للرقابة المالية، والواجهة مبنية على نفس المستوى.

مفاتيح لكل شريك بصلاحيات محددة، تظهر مرة واحدة وتُحفظ مشفّرة، مع إمكانية قصرها على عناوين IP محددة وإلغائها في أي وقت
كل صلاحية مغلقة حتى يتم الاتفاق عليها: فتح الحسابات، ربط المستثمرين، الاعتماد على KYC الشريك، الطلبات المسوّاة، الدفع بالكارت، المحفظة
بيانات المستثمر الحالي لا تُشارك إلا بعد تأكيده لكود يصله في رسالة، ولا ترى إلا العملاء المرتبطين بك
أمتار هي التي تسعّر الطلبات وتتحقق منها، ولا يعتمد الدفع إلا إدارة المالية في أمتار أو معالج الدفع بالكارت
إشعارات موقّعة بـ HMAC-SHA256 مع إعادة المحاولة لمدة يومين، ومفاتيح عدم التكرار تجعل إعادة أي طلب آمنة
حدود لعدد الطلبات لكل مفتاح، وحدود لقيمة الطلب الواحد واليوم، وسجل كامل للطلبات لدينا

أسئلة يطرحها الشركاء

من يمكنه استخدام واجهة برمجة الشركاء من أمتار؟+

البنوك وشركات الوساطة وتطبيقات الفنتك وغيرها من الشركات التي لديها اتفاقية شراكة مع أمتار. تُمنح الصلاحية لكل شريك على حدة؛ راسلنا للبدء.

هل يحتاج عملاؤنا إلى تطبيق أمتار؟+

في طريقة الإحالة نعم. في طريقتي الشراء من داخل تطبيقك يمكنهم الاستثمار بالكامل من تطبيقك بعد إتمام التحقق من الهوية، سواء تحقق أمتار في التطبيق أو تحققك أنت بموجب اتفاقية اعتماد. ويمكنهم دائمًا فتح تطبيق أمتار بنفس رقم الموبايل لمتابعة استثماراتهم وعقودهم.

كيف تتم إدارة الأموال؟+

إما أن يدفع العميل لأمتار مباشرة (من تطبيق أمتار أو صفحة الدفع بالكارت)، أو تحصّل أنت المبلغ وتحوّله لأمتار برقم مرجعي تؤكده إدارة المالية في أمتار. تُصدر الحصص عند اكتمال تمويل الوحدة.

كيف نختبر قبل التشغيل؟+

تحصل على مفاتيح لبيئة تجريبية كاملة. بها نقاط اتصال تحاكي التحقق من الهوية وتأكيد الدفع ورفضه وإصدار الحصص، فتختبر كل إشعار من البداية للنهاية دون تحريك أموال.

كيف يربح الشركاء؟+

حسب الاتفاق: مثلًا رسوم عن كل عميل يسجّل وعمولة على كل عملية شراء يقوم بها، من تطبيقك أو من تطبيق أمتار. ودفتر عمولاتك متاح من خلال الواجهة.

جاهز تقدّم الاستثمار العقاري لعملائك؟

احكِ لنا عن منتجك وعملائك، وسنرد عليك بالخطوات التالية وصلاحية البيئة التجريبية.

راسل فريق الشراكات

hi@amtaar.dev

أمتار كابيتال مرخّصة من الهيئة العامة للرقابة المالية. التوقعات ليست ضمانًا للعائد.