myfatoorah php

Библиотека PHP для API Myfatoorah

Установка

Предпочтительным способом установки этой библиотеки является композитор.

Либо беги

$ 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) , чтобы получить обновление статуса платежа. Это лучше всего называется после получения обратного вызова от Myfatoorah ReturnUrl или Errorturnurlurl. Вы также можете вручную вызовут эту функцию после интервала, если храните ссылочный идентификатор локально.

Запрос на статус заказа

 <?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 ' => ''
]

Платежные шлюзы

Настройте шлюз, который вы хотите использовать, пропустив константы Gateway, доступные на классе MyFatoorah в MyFatoorah::setPaymentMode .

• MyFatoorah::GATEWAY_ALL - сгенерированная ссылка отправляет на страницу Myfatoorah со всеми способами оплаты
• MyFatoorah::GATEWAY_KNET - сгенерированная ссылка отправляет пользователя непосредственно на Knet Portal
• MyFatoorah::GATEWAY_VISA_MASTERCARD - Сгенерированная ссылка отправляет пользователя непосредственно на визу/мастер -портал
• MyFatoorah::GATEWAY_SAUDI_SADAD - сгенерированная ссылка отправляет пользователя непосредственно на портал Садад Саудовской Аравии
• MyFatoorah::GATEWAY_BAHRAIN_BENEFIT - Сгенерированная ссылка отправляет пользователя непосредственно в пользу портала Bahrain
• MyFatoorah::GATEWAY_QATAR_QPAY - Сгенерированная ссылка отправляет пользователя непосредственно на Qpay Qatar Portal
• MyFatoorah::GATEWAY_UAECC - Сгенерированная ссылка отправляет пользователя непосредственно на портал дебетовых карт ОАЭ

Пример использования:

 <?php
use bawes/myfatoorah/ MyFatoorah ;

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

Тестовые карты

Эти карты будут работать только в том случае, если вы инициализируете с помощью среды MyFatoorah::test() .

Сетка

Номер карты	PIN/истечение	Результат
8888880000000001	что-либо	Захвачен
8888880000000002	что-либо	Не захвачен

Преимущества

Номер карты	Дата истечения срока действия	Приколоть	Результат
2222220123456789	12/27	1234	Захвачен
7777770123456789	12/27	1234	Не захвачен
1111110123456789	12/27	1234	Не захвачен

Виза

Номер карты	Дата истечения срока действия	CVV
4005550000000001	05/18	123
4557012345678902	05/18	123

Mastercard

Номер карты	Дата истечения срока действия	CVV
5123456789012346	05/18	123
5313581000123430	05/18	123

Амекс

Номер карты	Дата истечения срока действия	Приколоть
345678901234564	05/17	1234

Садад

Способ оплаты	Номер карты	Дата истечения срока действия	CVV
Mastercard	5271045423029111	что-либо	что-либо
Виза	4012001037141112	01/2022	684

Способ оплаты	Идентификатор учетной записи	Пароль
SADAD Account	Arun123	AA123456