myfatoorah php

Bibliothèque PHP pour l'API Myfatoorah

Installation

La façon préférée d'installer cette bibliothèque est via le compositeur.

Soit courir

$ composer require bawes/myfatoorah-php

ou ajouter

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

à la section requise du fichier composer.json de votre application.

Usage

Nous devons d'abord décider de l'environnement que nous voulons utiliser

Étape 1: Initialiser en fonction de l'environnement

Environnement d'essai

 <?php
use bawes/myfatoorah/ MyFatoorah ;

$ my = MyFatoorah:: test ();

Environnement vivant

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

Étape 2: Demandez un lien de paiement et redirigez-le

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

Étape 3: Demande l'état de la commande pour la confirmation de l'état de paiement

Utilisez MyFatoorah::getOrderStatus($referenceId) pour obtenir une mise à jour sur l'état du paiement. Cela s'appelle mieux après avoir reçu un rappel de retoururl de Myfatoorah ou d'errorreturnurl. Vous pouvez également appeler manuellement cette fonction après un intervalle si vous stockez l'ID de référence localement.

Exemple de demande d'état de commande

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

Réponse du statut de commande (succès)

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

Réponse du statut de commande (échec)

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

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

Passerelles de paiement

Configurez la passerelle que vous souhaitez utiliser en passant des constantes de passerelle disponibles sur la classe MyFatoorah à MyFatoorah::setPaymentMode .

• MyFatoorah::GATEWAY_ALL - Le lien généré envoie à la page MyFatoorah avec toutes les méthodes de paiement
• MyFatoorah::GATEWAY_KNET - Le lien généré envoie l'utilisateur directement au portail KNET
• MyFatoorah::GATEWAY_VISA_MASTERCARD - le lien généré envoie l'utilisateur directement au portail Visa / Master
• MyFatoorah::GATEWAY_SAUDI_SADAD - le lien généré envoie l'utilisateur directement au portail saoudien de Sadad
• MyFatoorah::GATEWAY_BAHRAIN_BENEFIT - le lien généré envoie un utilisateur directement au portail de Bahrain
• MyFatoorah::GATEWAY_QATAR_QPAY - le lien généré envoie l'utilisateur directement au portail Qpay Qatar
• MyFatoorah::GATEWAY_UAECC - Le lien généré envoie l'utilisateur directement au portail des cartes de débit des EAU

Exemple d'utilisation:

 <?php
use bawes/myfatoorah/ MyFatoorah ;

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

Cartes de test

Ces cartes ne fonctionneront que si vous initialisez à l'aide de MyFatoorah::test() Environnement.

À genoux

Numéro de carte	Épingle / expiration	Résultat
8888880000000001	rien	Capturé
8888880000000002	rien	Non capturé

Avantages

Numéro de carte	Date d'expiration	Épingle	Résultat
2222220123456789	12/27	1234	Capturé
777770123456789	12/27	1234	Non capturé
1111110123456789	12/27	1234	Non capturé

Visa

Numéro de carte	Date d'expiration	CVC
4005550000000001	05/18	123
4557012345678902	05/18	123

MasterCard

Numéro de carte	Date d'expiration	CVC
5123456789012346	05/18	123
5313581000123430	05/18	123

Amex

Numéro de carte	Date d'expiration	Épingle
345678901234564	05/17	1234

Sadad

Mode de paiement	Numéro de carte	Date d'expiration	CVC
MasterCard	5271045423029111	rien	rien
Visa	4012001037141112	01/2022	684

Mode de paiement	ID de compte	Mot de passe
Compte Sadad	arun123	AA123456