jemo/paygreen-api-client

Paygreen API客户端

dev-master 2020-05-25 11:30 UTC

This package is auto-updated.

Last update: 2024-09-25 21:17:20 UTC


README

允许集成Paygreen API的PHP客户端

API文档

安装

composer require jemo/paygreen-api-client:dev-master

使用

1) 实例化ApiClient

use PaygreenApiClient\ApiClient;

$pk = "clé privée";
$url = "https://paygreen.fr";
$id = "identifiant paygreen";

$client = new ApiClient($id, $pk, $url);

2) 获取调用API所需的子客户端,然后使用该类的相关方法

$info = $client->getTransactionClient()->getTransactionInfos("id de la transaction");

有多个客户端可供选择

  • CardprintClient,用于处理卡片信息
  • DonationClient,用于处理捐款
  • PaymentTypeClient,用于获取支付类型
  • TransactionClient,用于处理所有交易
  • TransferClient,用于处理转账

某些方法可能需要实例化PaygreenApiClient\Entity命名空间中的类。

use PaygreenApiClient\ApiClient;
use PaygreenApiClient\Entity\Buyer;
use PaygreenApiClient\Entity\Card;
use PaygreenApiClient\Entity\Transaction;

$pk = "clé privée";
$url = "https://paygreen.fr";
$id = "identifiant paygreen";

$client = new ApiClient($id, $pk, $url);

$buyer = new Buyer('id du buyer', 'nom', 'prénom', 'email@exemple.fr', 'pays', 'nom entreprise');
$card = new Card('token');

$transaction = new Transaction(10000, "id commande", "EUR");
$transaction->setBuyerAndCard($buyer, $card);

$info =  $client->getTransactionClient()->cashPayment($transaction);

3) 方法返回值

方法有两个可能的返回值:如果API调用成功,则返回一个数组;如果失败,则返回null。此时可以获取HTTP错误代码

$client->getTransactionClient()->getLastHttpErrorCode();

所有错误都按照以下格式记录,并存储在您的PHP配置中

"类名" - "方法名" : "错误信息"

待办事项

  • OAuth连接
  • 单元测试
  • 集成其他API,目前只完成了支付部分