الصفحة الرئيسية>PHP كود المصدر>فئات أخرى
تنزيل

مكتبة PHP لـ Myfatoorah API

تثبيت

الطريقة المفضلة لتثبيت هذه المكتبة هي من خلال الملحن.

إما تشغيل 

$ composer require bawes/myfatoorah-php

أو إضافة 

 "bawes/myfatoorah-php" : " ^1.0 "

إلى قسم المتطلبات من ملف composer.json الخاص بالتطبيق.

الاستخدام

أولاً ، نحتاج إلى تحديد البيئة التي نريد استخدامها

الخطوة 1: التهيئة بناءً على البيئة

بيئة اختبار 

 <?php
use bawes/myfatoorah/ MyFatoorah ;

$ my = MyFatoorah:: test ();

بيئة حية 

 <?php
use bawes/myfatoorah/ MyFatoorah ;

$ merchantCode = " [Your merchant code here] " ;
$ username = " [Your merchant username here] " ;
$ password = " [Your merchant password here] " ;
$ my = MyFatoorah:: live ( $ merchantCode , $ username , $ password );

الخطوة 2: اطلب رابط الدفع وإعادة التوجيه إليه 

 <?php
use bawes/myfatoorah/ MyFatoorah ;

$ merchantCode = " [Your merchant code here] " ;
$ username = " [Your merchant username here] " ;
$ password = " [Your merchant password here] " ;
$ my = MyFatoorah:: live ( $ merchantCode , $ username , $ password );

$ my -> setPaymentMode (MyFatoorah:: GATEWAY_ALL )
-> setReturnUrl ( " https://google.com " )
-> setErrorReturnUrl ( " https://google.com " )
-> setCustomer ( " Khalid " , " [email protected] " , " 97738271 " )
-> setReferenceId () //Pass unique order number or leave empty to use time()
-> addProduct ( " iPhone " , 5.350 , 3 )
-> addProduct ( " Samsung " , 12.000 , 1 )
-> getPaymentLinkAndReference ();

$ paymentUrl = $ my [ ' paymentUrl ' ];
$ myfatoorahRefId = $ my [ ' paymentRef ' ]; //good idea to store this for later status checks

// Redirect to payment url
header ( " Location: $ paymentUrl " );
die ();

الخطوة 3: طلب حالة الطلب لتأكيد حالة الدفع

استخدم MyFatoorah::getOrderStatus($referenceId) للحصول على تحديث عن حالة الدفع. يُطلق على هذا أفضل ما يسمى بعد تلقي رد اتصال من Returnurl's أو Errorreturnurl. يمكنك أيضًا استدعاء هذه الوظيفة يدويًا بعد فترة فاصل إذا قمت بتخزين معرف المرجع محليًا.

عينة طلب حالة الطلب 

 <?php
use bawes/myfatoorah/ MyFatoorah ;

// Example Ref ID
$ myfatoorahRefId = $ _GET [ ' id ' ];

// Order status on Test environment
$ orderStatus = MyFatoorah:: test ()
    -> getOrderStatus ( $ myfatoorahRefId );

// Order status on Live environment
$ merchantCode = " [Your merchant code here] " ;
$ username = " [Your merchant username here] " ;
$ password = " [Your merchant password here] " ;
$ orderStatus = MyFatoorah:: live ( $ merchantCode , $ username , $ password )
    -> getOrderStatus ( $ myfatoorahRefId );

استجابة حالة الطلب (النجاح) 

 <?php
$ orderStatus = [
    ' responseCode ' => ' 0 ' , //MyFatoorah::REQUEST_SUCCESSFUL
    ' responseMessage ' => ' SUCCESS ' ,
    ' result ' => ' CAPTURED ' ,

    // Successful payment fields
    ' payMode ' => ' KNET ' ,
    ' orderId ' => ' 1085183 ' ,
    ' payTransactionId ' => ' 673386261283050 ' ,
    ' grossAmountPaid ' => ' 32.500 ' ,
    ' netAmountToBeDeposited ' => ' 32.300 ' ,

    // User defined fields
    ' udf1 ' => '' ,
    ' udf2 ' => '' ,
    ' udf3 ' => '' ,
    ' udf4 ' => '' ,
    ' udf5 ' => ''
]

استجابة حالة الطلب (الفشل) 

 <?php
$ orderStatus = [
    ' responseCode ' => ' 2009 ' ,
    ' responseMessage ' => ' Transaction Failed Messages ' ,
    ' result ' => ' Payment Server detected an error ' ,

    // User defined fields
    ' udf1 ' => '' ,
    ' udf2 ' => '' ,
    ' udf3 ' => '' ,
    ' udf4 ' => '' ,
    ' udf5 ' => ''
]

بوابات الدفع

قم بتكوين البوابة التي ترغب في استخدامها عن طريق تمرير ثوابت البوابة المتاحة على فئة MyFatoorah إلى MyFatoorah::setPaymentMode .

  • MyFatoorah::GATEWAY_ALL - يرسل الرابط الذي تم إنشاؤه إلى صفحة MyFatoorah مع جميع طرق الدفع
  • MyFatoorah::GATEWAY_KNET - يرسل الرابط الذي تم إنشاؤه المستخدم مباشرة إلى بوابة الركبة
  • MyFatoorah::GATEWAY_VISA_MASTERCARD - يرسل الرابط الذي تم إنشاؤه المستخدم مباشرة إلى بوابة Visa/Master
  • MyFatoorah::GATEWAY_SAUDI_SADAD - يرسل الرابط الذي تم إنشاؤه المستخدم مباشرة إلى بوابة Sadad Saudi
  • MyFatoorah::GATEWAY_BAHRAIN_BENEFIT - رابط تم إنشاؤه يرسل المستخدم مباشرة لاستفادة بوابة البحرين
  • MyFatoorah::GATEWAY_QATAR_QPAY - يرسل الرابط الذي تم إنشاؤه المستخدم مباشرة إلى بوابة QPay Qatar
  • MyFatoorah::GATEWAY_UAECC - رابط تم إنشاؤه يرسل المستخدم مباشرة إلى بوابة بطاقات الخصم الإماراتية

مثال الاستخدام: 

 <?php
use bawes/myfatoorah/ MyFatoorah ;

$ my = MyFatoorah:: live ( $ merchantCode , $ username , $ password );
$ my -> setPaymentMode (MyFatoorah:: GATEWAY_ALL )

بطاقات الاختبار

ستعمل هذه البطاقات فقط إذا قمت بالتهيئة باستخدام بيئة MyFatoorah::test() .

الركبة

رقم البطاقة دبوس/انتهاء نتيجة
8888880000000001 أي شئ تم القبض عليه
8888888000000000 أي شئ لم يتم القبض عليها

فوائد

رقم البطاقة تاريخ انتهاء الصلاحية دبوس نتيجة
2222220123456789 12/27 1234 تم القبض عليه
7777770123456789 12/27 1234 لم يتم القبض عليها
1111110123456789 12/27 1234 لم يتم القبض عليها

فيزا

رقم البطاقة تاريخ انتهاء الصلاحية CVV
4005550000000001 05/18 123
4557012345678902 05/18 123

ماستر كارد

رقم البطاقة تاريخ انتهاء الصلاحية CVV
5123456789012346 05/18 123
5313581000123430 05/18 123

أميكس

رقم البطاقة تاريخ انتهاء الصلاحية دبوس
345678901234564 05/17 1234

ساداد

طريقة الدفع رقم البطاقة تاريخ انتهاء الصلاحية CVV
ماستر كارد 5271045423029111 أي شئ أي شئ
فيزا 4012001037141112 01/2022 684
طريقة الدفع معرف الحساب كلمة المرور
حساب ساداد ARUN123 AA123456
يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل