README

介绍

PHP Lipad SDK简化了将Lipad的支付和结账功能集成到您的PHP应用程序中。本全面指南将帮助您设置和使用Lipad SDK。

先决条件

在开始之前，请确保您有以下内容

• 您的服务器或开发环境中已安装PHP。
• Lipad API凭证，包括IV密钥、消费者密钥、消费者密钥。

安装

1. 下载Lipad SDK：下载Lipad SDK并将其包含到您的项目中。

   # Example using Composer
   composer require lipad/lipad-sdk
   

2. 在您的PHP文件中包含Composer自动加载器

   require_once 'vendor/autoload.php';
   

3. 使用您的凭证实例化Lipad类

   use Lipad\LipadSdk\Lipad;
   
   // Replace these values with your actual credentials
   $IVKey = 'your_iv_key';
   $consumerSecret = 'your_consumer_secret';
   $environment = 'sandbox';
   

结账使用

1. 要初始化Lipad类，提供$IVKey、$consumerKey、$consumerSecret和$environment参数。$environment可以是以下之一：'production'或'sandbox'。

   $lipad = new Lipad($IVKey, $consumerKey, $consumerSecret, $environment);
   

2. 验证负载

   try {
   $lipad->validateCheckoutPayload($payload);
   } catch (Exception $error) {
   echo 'Error: ' . $error->getMessage() . "\n";
   }
   

3. 加密负载

   $encryptedPayload = $lipad->encrypt($payload);
   

4. 获取结账状态

   try {
   $lipad->getCheckoutStatus($payload["merchant_transaction_id"]);
   } catch (Exception $error) {
   echo 'Error: ' . $error->getMessage() . "\n";
   }
   

5. 构建结账URL

   try {
       $checkoutUrl =
       'https://checkout2.dev.lipad.io/?access_key=' .
       urlencode($accessKey) .
       '&payload=' .
       urlencode($encryptedPayload);
        echo 'Checkout URL: ' . $checkoutUrl . "\n";
      } catch (Exception $error) {
        echo 'Error: ' . $error->getMessage() . "\n";
      }
   

直接API使用

1. 要初始化Lipad类，提供$IVKey、$consumerSecret和$environment参数。$environment可以是以下之一：'production'或'sandbox'。

   $lipad = new Lipad($IVKey, $consumerSecret, $environment);
   

2. 直接收费

   try {
   $lipad->DirectCharge($payload);
   } catch (Exception $error) {
    echo 'Error: ' . $error->getMessage() . "\n";
   }
   

3. 获取收费请求状态

   try {
   $lipad->getChargeRequestStatus($chargeRequestId);
   } catch (Exception $error) {
   echo 'Error: ' . $error->getMessage() . PHP_EOL;
   }
   

许可协议

此SDK是开源的，可在MIT许可证下使用。