iyzipay php

iyzipay-php

يمكنك التسجيل للحصول على حساب iyzico على https://iyzico.com

متطلبات

PHP 7.4 والإصدارات الأحدث.

ملحوظة

سيتم دعم الحد الأدنى من TLS v1.2 بعد مارس 2018. يرجى ترقية إصدار openssl الخاص بك إلى الحد الأدنى 1.0.1. إذا كانت لديك أي أسئلة، يرجى فتح مشكلة على Github أو الاتصال بنا على [email protected].

تثبيت

الملحن

يمكنك تثبيت الارتباطات عبر الملحن. قم بتشغيل الأمر التالي:

composer require iyzico/iyzipay-php

لاستخدام الروابط، استخدم التحميل التلقائي للملحن:

 require_once ( ' vendor/autoload.php ' );

التثبيت اليدوي

إذا كنت لا ترغب في استخدام Composer، فيمكنك تنزيل الإصدار الأحدث. وبعد ذلك، لاستخدام الارتباطات، قم بتضمين ملف IyzipayBootstrap.php .

 require_once ( ' /path/to/iyzipay-php/IyzipayBootstrap.php ' );

الاستخدام

 $ options = new  Iyzipay  Options ();
$ options -> setApiKey ( " your api key " );
$ options -> setSecretKey ( " your secret key " );
$ options -> setBaseUrl ( " https://sandbox-api.iyzipay.com " );
        
$ request = new  Iyzipay  Request  CreatePaymentRequest ();
$ request -> setLocale ( Iyzipay  Model Locale:: TR );
$ request -> setConversationId ( " 123456789 " );
$ request -> setPrice ( " 1 " );
$ request -> setPaidPrice ( " 1.2 " );
$ request -> setCurrency ( Iyzipay  Model Currency:: TL );
$ request -> setInstallment ( 1 );
$ request -> setBasketId ( " B67832 " );
$ request -> setPaymentChannel ( Iyzipay  Model PaymentChannel:: WEB );
$ request -> setPaymentGroup ( Iyzipay  Model PaymentGroup:: PRODUCT );

$ paymentCard = new  Iyzipay  Model  PaymentCard ();
$ paymentCard -> setCardHolderName ( " John Doe " );
$ paymentCard -> setCardNumber ( " 5528790000000008 " );
$ paymentCard -> setExpireMonth ( " 12 " );
$ paymentCard -> setExpireYear ( " 2030 " );
$ paymentCard -> setCvc ( " 123 " );
$ paymentCard -> setRegisterCard ( 0 );
$ request -> setPaymentCard ( $ paymentCard );

$ buyer = new  Iyzipay  Model  Buyer ();
$ buyer -> setId ( " BY789 " );
$ buyer -> setName ( " John " );
$ buyer -> setSurname ( " Doe " );
$ buyer -> setGsmNumber ( " [phone] " );
$ buyer -> setEmail ( " [email protected] " );
$ buyer -> setIdentityNumber ( " 74300864791 " );
$ buyer -> setLastLoginDate ( " 2015-10-05 12:43:35 " );
$ buyer -> setRegistrationDate ( " 2013-04-21 15:12:09 " );
$ buyer -> setRegistrationAddress ( " Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1 " );
$ buyer -> setIp ( " 85.34.78.112 " );
$ buyer -> setCity ( " Istanbul " );
$ buyer -> setCountry ( " Turkey " );
$ buyer -> setZipCode ( " 34732 " );
$ request -> setBuyer ( $ buyer );

$ shippingAddress = new  Iyzipay  Model  Address ();
$ shippingAddress -> setContactName ( " Jane Doe " );
$ shippingAddress -> setCity ( " Istanbul " );
$ shippingAddress -> setCountry ( " Turkey " );
$ shippingAddress -> setAddress ( " Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1 " );
$ shippingAddress -> setZipCode ( " 34742 " );
$ request -> setShippingAddress ( $ shippingAddress );

$ billingAddress = new  Iyzipay  Model  Address ();
$ billingAddress -> setContactName ( " Jane Doe " );
$ billingAddress -> setCity ( " Istanbul " );
$ billingAddress -> setCountry ( " Turkey " );
$ billingAddress -> setAddress ( " Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1 " );
$ billingAddress -> setZipCode ( " 34742 " );
$ request -> setBillingAddress ( $ billingAddress );

$ basketItems = array ();
$ firstBasketItem = new  Iyzipay  Model  BasketItem ();
$ firstBasketItem -> setId ( " BI101 " );
$ firstBasketItem -> setName ( " Binocular " );
$ firstBasketItem -> setCategory1 ( " Collectibles " );
$ firstBasketItem -> setCategory2 ( " Accessories " );
$ firstBasketItem -> setItemType ( Iyzipay  Model BasketItemType:: PHYSICAL );
$ firstBasketItem -> setPrice ( " 0.3 " );
$ basketItems [ 0 ] = $ firstBasketItem ;

$ secondBasketItem = new  Iyzipay  Model  BasketItem ();
$ secondBasketItem -> setId ( " BI102 " );
$ secondBasketItem -> setName ( " Game code " );
$ secondBasketItem -> setCategory1 ( " Game " );
$ secondBasketItem -> setCategory2 ( " Online Game Items " );
$ secondBasketItem -> setItemType ( Iyzipay  Model BasketItemType:: VIRTUAL );
$ secondBasketItem -> setPrice ( " 0.5 " );
$ basketItems [ 1 ] = $ secondBasketItem ;

$ thirdBasketItem = new  Iyzipay  Model  BasketItem ();
$ thirdBasketItem -> setId ( " BI103 " );
$ thirdBasketItem -> setName ( " Usb " );
$ thirdBasketItem -> setCategory1 ( " Electronics " );
$ thirdBasketItem -> setCategory2 ( " Usb / Cable " );
$ thirdBasketItem -> setItemType ( Iyzipay  Model BasketItemType:: PHYSICAL );
$ thirdBasketItem -> setPrice ( " 0.2 " );
$ basketItems [ 2 ] = $ thirdBasketItem ;
$ request -> setBasketItems ( $ basketItems );

$ payment =  Iyzipay  Model Payment:: create ( $ request , $ options );

انظر عينات أخرى ضمن دليل العينات.

تطوير

تثبيت التبعيات:

composer install

بطاقات اختبار وهمية

بطاقات الاختبار التي يمكن استخدامها لمحاكاة عملية دفع ناجحة :

رقم البطاقة	بنك	نوع البطاقة
5890040000000016	أكبانك	بطاقة ماستر كارد (الخصم)
5526080000000006	أكبانك	ماستر كارد (الائتمان)
4766620000000001	دنيزبنك	تأشيرة (الخصم)
4603450000000000	دنيزبنك	تأشيرة (الائتمان)
4729150000000005	مكافأة دينيزبانك	تأشيرة (الائتمان)
4987490000000002	فينانس بنك	تأشيرة (الخصم)
5311570000000005	فينانس بنك	ماستر كارد (الائتمان)
9792020000000001	فينانس بنك	تروي (الخصم)
9792030000000000	فينانس بنك	تروي (الائتمان)
5170410000000004	بنك جارانتي	بطاقة ماستر كارد (الخصم)
5400360000000003	بنك جارانتي	ماستر كارد (الائتمان)
374427000000003	بنك جارانتي	أمريكان إكسبريس
4475050000000003	هالك بنك	تأشيرة (الخصم)
5528790000000008	هالك بنك	ماستر كارد (الائتمان)
4059030000000009	بنك إتش إس بي سي	تأشيرة (الخصم)
5504720000000003	بنك إتش إس بي سي	ماستر كارد (الائتمان)
5892830000000000	تركيا إيش بانكاسي	بطاقة ماستر كارد (الخصم)
4543590000000006	تركيا إيش بانكاسي	تأشيرة (الائتمان)
4910050000000006	وقف بنك	تأشيرة (الخصم)
4157920000000002	وقف بنك	تأشيرة (الائتمان)
5168880000000002	Yapı ve Kredi Bankası	بطاقة ماستر كارد (الخصم)
5451030000000000	Yapı ve Kredi Bankası	ماستر كارد (الائتمان)

بطاقات اختبار عبر الحدود :

رقم البطاقة	دولة
4054180000000007	غير التركية (مدين)
5400010000000004	غير التركية (الائتمان)

بطاقات الاختبار للحصول على رموز خطأ محددة:

رقم البطاقة	وصف
5406670000000009	تم النجاح ولكن لا يمكن إلغاؤه أو استرداد أمواله أو نشر المصادقة
411111111111129	لا توجد أموال كافية
412911111111111	لا تكرم
412811111111112	معاملة غير صالحة
412711111111113	البطاقة المفقودة
412611111111114	البطاقة المسروقة
412511111111115	البطاقة منتهية الصلاحية
412411111111116	رمز cvc2 غير صالح
412311111111117	غير مسموح لحامل البطاقة
412211111111118	غير مسموح به إلى المحطة
412111111111119	المشتبه به في الاحتيال
412011111111110	بطاقة الالتقاط
413011111111118	خطأ عام
413111111111117	تم النجاح ولكن mdStatus يساوي 0
414111111111115	النجاح ولكن mdStatus هو 4
415111111111112	فشلت تهيئة برنامج 3dsecure

حسابات APM وهمية

حسابات APM وهمية يمكن استخدامها لمحاكاة الدفع باستخدام طريقة دفع بديلة:

اسم صاحب الحساب	وصف
نجاح	تم الدفع بنجاح بعد التهيئة الناجحة
فشل بعد الحرف الأول	فشل الدفع بعد التهيئة الناجحة
خطأ	فشلت التهيئة

اختبار

قم بتثبيت التبعيات كما هو مذكور أعلاه (والتي ستحل مشكلة PHPUnit)، ثم يمكنك تشغيل مجموعة الاختبار:

./vendor/bin/phpunit

أو لتشغيل ملف اختبار فردي:

./vendor/bin/phpunit tests/Iyzipay/Tests/Model/PaymentTest.php

يتم الآن اختبار ملف الاختبار...