4 نقاط نهاية
المحفظة
رصيد حساب الأداء الخاص بكم، وRIB باسم التاجر، والشهادة القابلة للتنزيل، وتغذية الحساب.
عناوين النقاط وأوصافها تأتي من عقد OpenAPI، بالإنجليزية — فلا يمكن أن تحيد عن الواجهة.
بكلمات بسيطة
حساب الأداء الخاص بكم في ChariPay: الاطلاع على الرصيد، والحصول على RIB، وتغذية الحساب.
متى تستعملونها
لعرض رصيد في مكتبكم الخلفي، أو لتزويد دافع برقم الحساب، أو لتغذية الحساب قبل عملية صادرة.
كيف تدمجونها
- 1اقرؤوا الرصيد المتاح قبل أي عملية تُخرج أموالًا.
- 2احصلوا على RIB، أو شهادته PDF، متى احتاج طرف ثالث تحويل أموال إليكم.
- 3غذّوا المحفظة متى كان الرصيد لا يغطي ما تريدون الالتزام به.
- POST
/v1/wallet/cash-insتمويل حساب الأداء الخاص بالتاجر - GET
/v1/wallet/account/rib-documentتنزيل RIB حساب الأداء (PDF) - GET
/v1/wallet/accountاسترجاع حساب الأداء (RIB) - GET
/v1/walletاسترجاع رصيد حساب الأداء
تمويل حساب الأداء الخاص بالتاجر
يُنشئ رابط دفع بالبطاقة مستضافًا محليًا. يموّل إرسال بيانات البطاقة eSIM المشتركة الخاصة بالسندبوكس أو eSIM الإنتاج الحقيقية الخاصة بالتاجر عبر مسار الدفع القياسي. في وضع الدفتر فقط، تُنشئ السندبوكس عملية تحصيل (cash-in) قياسية وتُنهيها عبر صندوق الصادر الدائم (outbox).
المخطط · WalletCashinRequest
| الحقل | النوع | الموضع | مطلوب | الوصف |
|---|---|---|---|---|
Idempotency-Key | string | header | مطلوب | مفتاح Idempotency إلزامي يجعل إعادة المحاولات آمنة. |
amount | number | body | مطلوب | المبلغ المراد تمويله بالدرهم. |
تنزيل RIB حساب الأداء (PDF)
يُرجع البيانات البنكية لحساب الأداء على شكل مستند PDF قابل للتنزيل.
لا وسائط.
استرجاع حساب الأداء (RIB)
تُرجع البيانات البنكية القابلة للنسخ (RIB/IBAN/BIC، صاحب الحساب، البنك) والأرصدة الحالية.
لا وسائط.
استرجاع رصيد حساب الأداء
يُعيد الرصيد الحالي لحساب الأداء بالدرهم لبيئة المفتاح.
لا وسائط.
سؤال حول الدمج؟
يجيب فريقنا التقني فرق الإدماج، من أول استدعاء في السندبوكس حتى الانتقال إلى الإنتاج.