README

Feexpay SDK PHP项目 - 用户指南

本指南解释了如何使用Feexpay PHP SDK轻松将移动和卡支付方法集成到您的PHP或Laravel应用程序中。按照以下步骤开始：

安装

1. 安装本地服务器，如Xampp或Wamp等。

2. 如果尚未安装，请安装Composer。

3. 通过运行以下命令检查Composer是否已安装：

   composer --version
   

在简单的PHP环境中的使用

1. 创建您的PHP项目。

2. 在终端中打开并运行以下命令下载Git仓库：

   git clone https://github.com/La-Vedette-Media/feexpay-php-sdk.git
   

3. 创建一个PHP文件，例如index.php。

4. 在您的PHP文件中使用SDK方法

   <?php
   include 'src/FeexpayClass.php'; 
   
   $skeleton = new Feexpay\FeexpayPhp\FeexpayClass("shop's id", "token key API", "callback_url", "mode (LIVE, SANDBOX)");
   
   // Using the mobile network payment method (MTN, MOOV)
   $response = $skeleton->paiementLocal("amount", "phone_number", "network (MTN, MOOV)", "Jon Doe", "jondoe@gmail.com");
   $status = $skeleton->getPaiementStatus($response);
   var_dump($status);
   
   // Using the card payment method (VISA, MASTERCARD)
   $responseCard = $skeleton->paiementCard("amount", "phoneNumber(66000000)", "typeCard (VISA, MASTERCARD)", "Jon", "Doe", "jondoe@gmail.com", "country(Benin)", "address(Cotonou)", "district(Littoral)", "currency(XOF, USD, EUR)");
   $redirectUrl = $responseCard["url"];
   header("Location: $redirectUrl");
   exit();
   ?>

5. 您还可以在PHP页面中集成一个支付按钮

   <?php
   include 'src/FeexpayClass.php'; 
   $price = 50;
   $id = "shop's id";
   $token = "token key API";
   $callback_url = 'https://www.google.com';
   $mode = 'LIVE';
   $feexpayclass = new Feexpay\FeexpayPhp\FeexpayClass($id, $token, $callback_url, $mode);
   $result = $feexpayclass->init($price, "button_payee");
   ?>
   <div id='button_payee'></div>

与Laravel一起使用

1. 在Laravel项目中，运行以下命令安装Feexpay包：

   composer require feexpay/feexpay-php
   

2. 在您的web.php文件中创建一个路由

   Route::controller(YourController::class)->group(function () {
       Route::get('feexpay', 'feexpay')->name('feexpay');
   });

3. 创建一个控制器，例如YourController.php，并在该控制器中使用Feexpay SDK来处理支付

   <?php
   
   namespace App\Http\Controllers;
   use Feexpay\FeexpayPhp\FeexpayClass;
   use Illuminate\Http\Request;
   
   class YourController extends Controller
   {
       public function feexpay()
       {
   
            // Using the card payment method (VISA, MASTERCARD)
   
           $skeleton = new FeexpayClass("shop's id", "token key API", "callback_url", "mode (LIVE, SANDBOX)");
           $responseCard = $skeleton->paiementCard("amount", "phoneNumber(66000000)", "typeCard (VISA, MASTERCARD)", "Jon", "Doe", "jondoe@gmail.com", "country(Benin)", "address(Cotonou)", "district(Littoral)", "currency(XOF, USD, EUR)");
           $redirectUrl = $responseCard["url"];
           return redirect()->away($redirectUrl);
   
   
           // Using the mobile network payment method (MTN, MOOV)
   
   
            $skeleton = new FeexpayClass("shop's id", "token key API", "callback_url", "mode (LIVE, SANDBOX)");
            $response = $skeleton->paiementCard("amount", "phone_number", "network (MTN, MOOV)", "Jon Doe","jondoe@gmail.com");
            $status = $skeleton->getPaiementStatus($response);
            var_dump($status);
       }
   }

或

<?php

namespace App\Http\Controllers;
use Feexpay\FeexpayPhp\FeexpayClass;
use Illuminate\Http\Request;

class YourController extends Controller
{
    public function feexpay()

    {

     // Using the card payment method (VISA, MASTERCARD)


        $skeleton = new FeexpayClass("shop's id", "token key API", "callback_url", "mode (LIVE, SANDBOX)");
         $responseCard = $skeleton->paiementCard("amount", "phoneNumber(66000000)", "typeCard (VISA, MASTERCARD)", "Jon", "Doe", "jondoe@gmail.com", "country(Benin)", "address(Cotonou)", "district(Littoral)", "currency(XOF, USD, EUR)");

         // Display response structure for debugging purposes
         var_dump($responseCard);

         // Check for the presence of the "url" key
         if (isset($responseCard["url"])) {
             $redirectUrl = $responseCard["url"];
             return redirect()->away($redirectUrl);
         } else {
             // Handle the case where "url" is not present in the response
             return response("Erreur de réponse de paiement")->setStatusCode(500);
         }
    }
}

1. 在视图中集成Feexpay按钮，例如welcome.blade.php

创建一个路由

Route::controller(YourController::class)->group(function () {
    Route::get('payment', 'payment')->name('payment') ;
}) ;

通过示例创建一个控制器YourController.php

namespace App\Http\Controllers;
use Feexpay\FeexpayPhp\FeexpayClass;
use Illuminate\Http\Request;

class YourController extends Controller
{
  public function payment()
 {
         $data['price']          =  $price = 50;
         $data['id']             =  $id= "shop's id";
         $data['token']          =  $token= "token key API";
         $data['callback_url']   =  $callback_url= 'https://www.google.com';
         $data['mode']           =  $mode='LIVE';
         $data['feexpayclass']   =  $feexpayclass = new FeexpayClass($id, $token, $callback_url, $mode);
         $data['result']         =  $result = $feexpayclass->init($price, "button_payee");

         return view('welcome', $data);
 }
}

确保您有视图文件，例如我们的示例是welcome.blade.php

<div id='button_payee'></div>

现在您可以访问路由中定义的URL，使用Feexpay进行支付。

请确保根据您的配置和需求调整“商店的ID”、“令牌密钥API”、地址、金额和其他详细信息。