الانتقال إلى المحتوى الرئيسي
إنشاء حساباتصلوا بنالديكم حساب؟ سجّلوا الدخول
توثيق الواجهة البرمجية

نقطة نهاية واحدة

واجهة البطاقة

الدفع ببطاقة مرمّزة: يُخصم المبلغ من البطاقة انطلاقًا من معرّفها، ويعيد حامل البطاقة إدخال رمز CVV في كل دفعة.

عناوين النقاط وأوصافها تأتي من عقد OpenAPI، بالإنجليزية — فلا يمكن أن تحيد عن الواجهة.

ابدؤوا في وضع الاختبار

تُنشئون مفتاح الاختبار من البوابة بمجرد تفعيل حسابكم.

بكلمات بسيطة

يدفع عميلك مجددًا بالبطاقة التي استعملها لديك من قبل، مع إعادة إدخال رمز الأمان فقط.

متى تستعملونها

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

كيف تدمجونها

  1. 1احتفظ بقيمة tokenizedCardId التي أعادها الدفع الذي رمّز البطاقة — ولا تحتفظ أبدًا برقم البطاقة أو برمز CVV.
  2. 2في الدفعة التالية، اطلب من حامل البطاقة رمز CVV، ثم استدعِ المسار مع cardId ورمز CVV.
  3. 3إذا كانت redirect مساوية لـ true، وجّه حامل البطاقة إلى redirectionUrl لإتمام ‎3-D Secure.
  4. 4اقرأ data.status لمعرفة النتيجة، واحتفظ بـ operationId للتحصيل أو الإلغاء أو الاسترداد.
POST200

الدفع ببطاقة مرمّزة (مع إعادة إدخال CVV)

يخصم المبلغ من بطاقة تم ترميزها خلال دفع سابق بالبطاقة، دون إعادة إرسال رقم البطاقة أو تاريخ انتهاء صلاحيتها. رمز CVV ليس جزءًا من الرمز المميز: يعيد حامل البطاقة إدخاله في كل دفعة على هذا المسار، وتُرفض الطلبات بدونه. cardId هو قيمة tokenizedCardId التي أعادها الدفع الذي رمّز البطاقة. تكون ‎3-D Secure مفعّلة والتحصيل تلقائيًا افتراضيًا؛ اضبط autoCapture على false للاكتفاء بالتفويض. عندما تكون redirect مساوية لـ true، وجّه حامل البطاقة إلى redirectionUrl لإتمام ‎3-D Secure. يجب تفعيل واجهة البطاقة لحسابك، وإلا يُعاد الخطأ 403 CARD_API_NOT_ENABLED. تتبع الردود الغلاف {status, message, data}.

المخطط · TokenizedCardPaymentRequest

الحقلالنوعالموضعمطلوبالوصف
cardIdinteger (int32)pathمطلوبمعرّف البطاقة المرمّزة: قيمة tokenizedCardId التي أعادها الدفع الذي رمّزها.
phoneNumberstringqueryاختيارياختياري. في بيئة الاختبار، تحصّل المحفظة التجريبية المشتركة دائمًا. في الإنتاج، تحصّل محفظتك التجارية، ويُرفض أي رقم آخر (403 PHONE_NUMBER_NOT_OWNED).
cvvstringbodyمطلوبرمز أمان البطاقة، من 3 أو 4 أرقام، يعيد حامل البطاقة إدخاله لهذه الدفعة. لا تحتفظ به أبدًا.
amountnumberbodyمطلوبالمبلغ المراد خصمه بالدرهم، ويجب أن يكون موجبًا.
threeDSecurebooleanbodyاختياريمصادقة ‎3-D Secure. القيمة الافتراضية true.
autoCapturebooleanbodyاختياريالتحصيل التلقائي. القيمة الافتراضية true؛ وقيمة false تكتفي بتفويض المبلغ.
acceptUrlstringbodyاختياريالعنوان الذي يعود إليه حامل البطاقة بعد نجاح خطوة ‎3-D Secure.
declineUrlstringbodyاختياريالعنوان الذي يعود إليه حامل البطاقة بعد فشل خطوة ‎3-D Secure.
notificationUrlstringbodyاختياريعنوان خادمك، يُحفظ مع العملية.
externalReferencestringbodyاختياريمرجعك الخاص، مثل رقم الطلب.

تحدّثوا إلى مختص دمج

أجروا أول نداء في وضع الاختبار

أنشئوا حسابكم، وأنشئوا مفتاح الاختبار من البوابة، وأرسلوا أول طلب اليوم — أو تحدّثوا إلى مختص دمج.

ابدؤوا في وضع الاختباراتصلوا بنا
  • مجاني ودون التزام
  • وضع الاختبار منذ التسجيل
  • لا موافقة تنتظرونها