myfatoorah php

PHP -Bibliothek für die Myfatoorah -API

Installation

Die bevorzugte Art, diese Bibliothek zu installieren, besteht darin, über Komponist zu fahren.

Entweder rennen

$ composer require bawes/myfatoorah-php

oder hinzufügen

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

In den Fordern -Abschnitt der composer.json -Datei Ihrer Anwendung.

Verwendung

Zuerst müssen wir entscheiden, welche Umgebung wir verwenden möchten

Schritt 1: Initialisieren Sie basierend auf der Umgebung

Testumgebung

 <?php
use bawes/myfatoorah/ MyFatoorah ;

$ my = MyFatoorah:: test ();

Lebende Umgebung

 <?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 );

Schritt 2: Fordern Sie einen Zahlungslink an und leiten Sie dazu um

 <?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 ();

Schritt 3: Anforderungsbestellstatus für die Bestätigung des Zahlungsstatus

Verwenden Sie MyFatoorah::getOrderStatus($referenceId) um einen Update zum Status der Zahlung zu erhalten. Dies wird am besten genannt, nachdem er einen Rückruf von Myfatoorahs Rückkehr oder Errorreturnurl erhalten hat. Sie können diese Funktion auch nach einem Intervall manuell aufrufen, wenn Sie die Referenz -ID lokal speichern.

Beispielauftragsstatusanforderung

 <?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 );

Bestellstatusantwort (Erfolg)

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

Bestellstatusantwort (Fehler)

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

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

Zahlungsgateways

Konfigurieren Sie das Gateway, das Sie verwenden möchten, indem Sie Gateway -Konstanten in der MyFatoorah -Klasse an MyFatoorah::setPaymentMode übergeben.

• MyFatoorah::GATEWAY_ALL - Generierter Link sendet an MyFatoorah -Seite mit allen Zahlungsmethoden
• MyFatoorah::GATEWAY_KNET - Generated Link sendet den Benutzer direkt an das Knet -Portal
• MyFatoorah::GATEWAY_VISA_MASTERCARD - Der generierte Link sendet Benutzer direkt an Visa/Master -Portal
• MyFatoorah::GATEWAY_SAUDI_SADAD - Generierter Link sendet den Benutzer direkt an das Sadad Saudi -Portal
• MyFatoorah::GATEWAY_BAHRAIN_BENEFIT - Generierter Link sendet den Benutzer direkt zum Nutzen des Bahrain -Portals
• MyFatoorah::GATEWAY_QATAR_QPAY - Generated Link sendet den Benutzer direkt an QPay Qatar Portal
• MyFatoorah::GATEWAY_UAECC - Generated Link sendet Benutzer direkt an die VAE -Debitkarten -Portal

Verwendungsbeispiel:

 <?php
use bawes/myfatoorah/ MyFatoorah ;

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

Testkarten

Diese Karten funktionieren nur, wenn Sie mithilfe von MyFatoorah::test() -umgebung initialisieren.

Ritter

Kartennummer	Pin/Ablauf	Ergebnis
888888800000001	irgendetwas	Gefangen genommen
888888800000002	irgendetwas	Nicht gefangen genommen

Vorteile

Kartennummer	Verfallsdatum	Stift	Ergebnis
2222220123456789	12/27	1234	Gefangen genommen
7777770123456789	12/27	1234	Nicht gefangen genommen
1111110123456789	12/27	1234	Nicht gefangen genommen

Visum

Kartennummer	Verfallsdatum	CVV
4005550000000001	05/18	123
4557012345678902	05/18	123

MasterCard

Kartennummer	Verfallsdatum	CVV
5123456789012346	05/18	123
5313581000123430	05/18	123

Amex

Kartennummer	Verfallsdatum	Stift
345678901234564	05/17	1234

Sadad

Zahlungsmethode	Kartennummer	Verfallsdatum	CVV
MasterCard	5271045423029111	irgendetwas	irgendetwas
Visum	4012001037141112	01/2022	684

Zahlungsmethode	Konto -ID	Passwort
Sadad -Account	ARUN123	AA123456