myfatoorah php

Biblioteca PHP para la API de Myfatoorah

Instalación

La forma preferida de instalar esta biblioteca es a través del compositor.

O CORRE

$ composer require bawes/myfatoorah-php

o agregar

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

a la sección Requerir el archivo composer.json de su aplicación.

Uso

Primero necesitamos decidir qué entorno queremos usar

Paso 1: Inicializar según el entorno

Entorno de prueba

 <?php
use bawes/myfatoorah/ MyFatoorah ;

$ my = MyFatoorah:: test ();

Ambiente en vivo

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

Paso 2: Solicite un enlace de pago y redirigirlo

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

Paso 3: Solicitar el estado de la orden para la confirmación del estado de pago

Use MyFatoorah::getOrderStatus($referenceId) para obtener una actualización sobre el estado del pago. Esto se llama mejor después de recibir una devolución de llamada de ReturnUrl o ErrorrErReturnurl de Myfatoorah. También puede llamar manualmente a esta función después de un intervalo si almacena la ID de referencia localmente.

Solicitud de estado de pedido de muestra

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

Respuesta del estado del pedido (éxito)

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

Respuesta del estado del pedido (falla)

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

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

Pasarelas de pago

Configure la puerta de enlace que desea usar pasando las constantes de puerta de enlace disponibles en la clase MyFatoorah a MyFatoorah::setPaymentMode .

• MyFatoorah::GATEWAY_ALL : el enlace generado envía a la página de myfatoorah con todos los métodos de pago
• MyFatoorah::GATEWAY_KNET - El enlace generado envía al usuario directamente al portal de Knet
• MyFatoorah::GATEWAY_VISA_MASTERCARD - El enlace generado envía al usuario directamente a Visa/Master Portal
• MyFatoorah::GATEWAY_SAUDI_SADAD - El enlace generado envía al usuario directamente al portal Sadad Saudi
• MyFatoorah::GATEWAY_BAHRAIN_BENEFIT - El enlace generado envía al usuario directamente a beneficiar al portal de Bahrein
• MyFatoorah::GATEWAY_QATAR_QPAY - El enlace generado envía al usuario directamente al portal Qpay Qatar
• MyFatoorah::GATEWAY_UAECC - El enlace generado envía al usuario directamente al portal de tarjetas de débito de los EAU

Ejemplo de uso:

 <?php
use bawes/myfatoorah/ MyFatoorah ;

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

Tarjetas de prueba

Estas tarjetas solo funcionarán si inicializas usando el entorno MyFatoorah::test() .

Girar

Número de tarjeta	Pin/cadena	Resultado
88888880000000001	cualquier cosa	Capturado
88888880000000002	cualquier cosa	No capturado

Beneficios

Número de tarjeta	Fecha de vencimiento	Alfiler	Resultado
2222220123456789	27/12	1234	Capturado
7777770123456789	27/12	1234	No capturado
1111110123456789	27/12	1234	No capturado

Visa

Número de tarjeta	Fecha de vencimiento	CVV
400555000000000001	18/05	123
4557012345678902	18/05	123

Tarjeta MasterCard

Número de tarjeta	Fecha de vencimiento	CVV
5123456789012346	18/05	123
5313581000123430	18/05	123

Amex

Número de tarjeta	Fecha de vencimiento	Alfiler
345678901234564	17/05	1234

Sadad

Método de pago	Número de tarjeta	Fecha de vencimiento	CVV
Tarjeta MasterCard	5271045423029111	cualquier cosa	cualquier cosa
Visa	4012001037141112	01/2022	684

Método de pago	ID de cuenta	Contraseña
Cuenta de Sadad	arun123	AA123456