lucas-simas/php-sdk-v3

Unlimit API v3 的 PHP SDK

dev-master 2023-09-25 18:57 UTC

This package is auto-updated.

Last update: 2024-09-10 15:27:17 UTC


README

Unlimit API 使用 HTTP 动词和 RESTful 端点结构。请求和响应负载以 JSON 格式进行格式化。

  • API 版本:3.0
  • PHP SDK 版本:3.56.0

更多信息,请访问 https://integration.cardpay.com

需求

  • PHP 5.6 或更高版本
  • curl、json、openssl 扩展

安装和用法

Composer

要通过 Composer 安装绑定,请将以下内容添加到 composer.json

{
  "repositories": [
    {
      "type": "git",
      "url": "https://github.com/cardpay/php-sdk-v3.git"
    }
  ],
  "require": {
    "cardpay/php-sdk-v3": "*@dev"
  }
}

然后运行 composer install

手动安装

下载文件,运行 composer install 并包含 autoload.php

require_once('./vendor/autoload.php');

代理使用

如果设置了 HTTPS_PROXYHTTP_PROXY 环境变量,SDK 将自动使用代理。

入门指南

重要:请注意,当前实现使用临时文件存储(请参阅 FileTokensStorageApi),以保存、读取和删除(如果需要)API令牌。您可以通过实现 TokensStorageApi 接口来实现其他令牌存储(会话、数据库、Memcached、Redis 等)。

要获取API令牌,请使用 AuthApiClient。它需要API终端代码和密码,由Unlimit提供。

请按照 安装过程 进行操作,然后运行以下命令

<?php

use Cardpay\api\AuthApiClient;
use Cardpay\api\FileTokensStorageApi;

$fileTokensStorageApi = new FileTokensStorageApi($host, $terminalCode);
$authApiClient = new AuthApiClient($host, $terminalCode, $password, $fileTokensStorageApi);

/** @var ApiTokens $apiTokens */
$apiTokens = $authApiClient->obtainApiTokens();

$accessToken = $apiTokens->getAccessToken();
$refreshToken = $apiTokens->getRefreshToken();
$tokenType = $apiTokens->getTokenType();

测试

打开 ./test/Config.php 并设置终端代码、密码和终端货币。

运行单元测试

composer install
./vendor/bin/phpunit --configuration ./phpunit.xml

模型文档

作者

support@unlimit.com