myfatoorah php

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 Portal로 직접 보냅니다.
• MyFatoorah::GATEWAY_VISA_MASTERCARD 생성 된 링크는 사용자를 비자/마스터 포털로 직접 보냅니다.
• MyFatoorah::GATEWAY_SAUDI_SADAD 생성 된 링크
• MyFatoorah::GATEWAY_BAHRAIN_BENEFIT 생성 된 링크는 바레인 포털에 혜택을주기 위해 사용자에게 직접 보냅니다.
• 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() 환경을 사용하여 초기화하는 경우에만 작동합니다.

칼

카드 번호	핀/만료	결과
8888880000000001	아무것	포착
8888880000000002	아무것	포착되지 않았습니다

이익

카드 번호	만료 날짜	핀	결과
2222220123456789	12/27	1234	포착
7777770123456789	12/27	1234	포착되지 않았습니다
1111110123456789	12/27	1234	포착되지 않았습니다

비자

카드 번호	만료 날짜	CVV
4005550000000001	05/18	123
4557012345678902	05/18	123

마스터 카드

카드 번호	만료 날짜	CVV
5123456789012346	05/18	123
5313581000123430	05/18	123

Amex

카드 번호	만료 날짜	핀
345678901234564	05/17	1234

사드

지불 방법	카드 번호	만료 날짜	CVV
마스터 카드	5271045423029111	아무것	아무것
비자	4012001037141112	01/2022	684

지불 방법	계정 ID	비밀번호
사드 계정	ARUN123	AA123456