myfatoorah php

Biblioteca PHP para a API do Myfatoorah

Instalação

A maneira preferida de instalar esta biblioteca é através do compositor.

Correr

$ composer require bawes/myfatoorah-php

ou adicione

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

para a seção requisito do arquivo composer.json do seu aplicativo.

Uso

Primeiro, precisamos decidir qual ambiente queremos usar

Etapa 1: Inicialize com base no ambiente

Ambiente de teste

 <?php
use bawes/myfatoorah/ MyFatoorah ;

$ my = MyFatoorah:: test ();

Ambiente ao 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 );

Etapa 2: Solicite um link de pagamento e redirecre

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

Etapa 3: Solicitar o status da ordem para confirmação do status do pagamento

Use MyFatoorah::getOrderStatus($referenceId) para obter uma atualização sobre o status do pagamento. Isso é melhor chamado depois de receber um retorno de chamada do ReturnUrl de Myfatoorah ou ErrorreTurnUrl. Você também pode chamar manualmente essa função após um intervalo se você armazenar o ID de referência localmente.

Solicitação de status do pedido de amostra

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

Resposta do status do pedido (sucesso)

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

Resposta do status do pedido (falha)

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

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

Gateways de pagamento

Configure o gateway que você deseja usar, passando as constantes de gateway disponíveis na classe MyFatoorah para MyFatoorah::setPaymentMode .

• MyFatoorah::GATEWAY_ALL - link gerado envia para a página de myfatoorah com todos os métodos de pagamento
• MyFatoorah::GATEWAY_KNET - link gerado envia o usuário diretamente para o portal Knet
• MyFatoorah::GATEWAY_VISA_MASTERCARD - link gerado envia o usuário diretamente para o portal de visto/mestre
• MyFatoorah::GATEWAY_SAUDI_SADAD - link gerado envia o usuário diretamente para o portal saudita do Sadad
• MyFatoorah::GATEWAY_BAHRAIN_BENEFIT - link gerado envia o usuário diretamente para beneficiar o portal bahrain
• MyFatoorah::GATEWAY_QATAR_QPAY - link gerado envia o usuário diretamente para o portal qpay qatar
• MyFatoorah::GATEWAY_UAECC - link gerado envia usuário diretamente para o portal dos cartões de débito dos Emirados Árabes Unidos

Exemplo de uso:

 <?php
use bawes/myfatoorah/ MyFatoorah ;

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

Cartões de teste

Esses cartões só funcionarão se você inicializar usando o ambiente MyFatoorah::test() .

Knet

Número do cartão	Pino/expiração	Resultado
88888880000000001	qualquer coisa	Capturado
88888880000000002	qualquer coisa	Não capturado

Benefícios

Número do cartão	Data de validade	Alfinete	Resultado
22222220123456789	27/12	1234	Capturado
7777770123456789	27/12	1234	Não capturado
1111110123456789	27/12	1234	Não capturado

Visa

Número do cartão	Data de validade	Cvv
4005550000000001	05/18	123
4557012345678902	05/18	123

MasterCard

Número do cartão	Data de validade	Cvv
5123456789012346	05/18	123
5313581000123430	05/18	123

Amex

Número do cartão	Data de validade	Alfinete
345678901234564	05/17	1234

Sadad

Método de pagamento	Número do cartão	Data de validade	Cvv
MasterCard	5271045423029111	qualquer coisa	qualquer coisa
Visa	4012001037141112	01/2022	684

Método de pagamento	ID da conta	Senha
Conta do Sadad	ARUN123	AA123456