myfatoorah phpダウンロードmyfatoorah phpソースコードのダウンロード

myfatoorah php

その他のカテゴリー

1.0.0

ダウンロード

Myfatoorah APIのPHPライブラリ

インストール

このライブラリをインストールするための好ましい方法は、作曲家によるものです。

どちらか走ってください

$ 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またはErrorreturnurlからコールバックを受け取った後に最もよく呼ばれます。参照IDをローカルに保存する場合、間隔後にこの関数を手動で呼び出すこともできます。

サンプル注文ステータスリクエスト

 <?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生成されたリンクはユーザーを直接knetポータルに送信します
MyFatoorah::GATEWAY_VISA_MASTERCARD生成リンクはユーザーをビザ/マスターポータルに直接送信します
MyFatoorah::GATEWAY_SAUDI_SADAD生成リンクはユーザーをサダッドサウジアラビアポータルに直接送信します
MyFatoorah::GATEWAY_BAHRAIN_BENEFIT生成されたリンクは、Bahrainポータルに利益をもたらすためにユーザーを直接送信します
MyFatoorah::GATEWAY_QATAR_QPAY生成リンクはユーザーをqpay qatarポータルに直接送信します
MyFatoorah::GATEWAY_UAECC生成されたリンクはユーザーをUAEデビットカードポータルに直接送信します

使用例：

 <?php
use bawes/myfatoorah/ MyFatoorah ;

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

テストカード

これらのカードはMyFatoorah::test()環境を使用して初期化する場合にのみ機能します。

knet

カード番号	ピン/有効期限	結果
88888880000000001	何でも	捕獲された
88888880000000002	何でも	キャプチャされていません

利点

カード番号	有効期限	ピン	結果
2222220123456789	12/27	1234	捕獲された
777770123456789	12/27	1234	キャプチャされていません
1111110123456789	12/27	1234	キャプチャされていません