README

目录

• 安装
• 入门
• 支持的方法
• 查询参数
• 响应参数
• 通知
• 幂等性

安装

可以使用 composer 安装此库

composer require flowwow/cloudpayments-php-client

入门

$publicId = /*...*/;
$pass = /*...*/;
$apiClient = new \Flowwow\Cloudpayments\Library($publicId, $pass);
$response = $apiClient->paymentsCardsCharge(new \Flowwow\Cloudpayments\Request\CardsPayment(
    100,
    'RUB',
    '123.123.123.123',
    '01492500008719030128SMfLeYdKp5dSQVIiO5l6ZCJiPdel4uDjdFTTz1UnXY'
));

echo $response->success;

支持的方法

库支持大量 API 方法（https://developers.cloudpayments.ru/#api）。对于查询和响应参数，支持对象封装。

$apiClient = new \Flowwow\Cloudpayments\Library(\*...*\);
$apiClient->paymentsCardsCharge(\*...*\);

查询参数

查询参数封装在 dto 对象中

...
$validationUrl = 'https://apple-pay-gateway.apple.com/paymentservices/startSession';
$request = new \Flowwow\Cloudpayments\Request\ApplepayStartSession($validationUrl);
$apiClient->startSession($request);

库在构建 request 对象时可能会抛出 BadTypeException 错误

try {
    ...
    $validationUrl = 'https://apple-pay-gateway.apple.com/paymentservices/startSession';
    $request = new \Flowwow\Cloudpayments\Request\ApplepayStartSession($validationUrl);
    ...
} catch (\Flowwow\Cloudpayments\Exceptions\BadTypeException $e) {
    var_dump($e->getMessage());
}

响应参数

响应参数也封装在 dto 对象中。 CloudResponse 有 3 个属性：success、message、model

model 属性中记录所需实体，具体取决于请求。

支持实体列表

• AppleSessionModel
• NotificationModel
• SubscriptionModel
• TokenModel
• TransactionModel
• TransactionWith3dsModel

通知

库包含用于 webhook 参数的 dto 对象

$hookData = new \Flowwow\Cloudpayments\Hook\HookPay($_POST);
echo $hookData->transactionId;

所有通知列表 - https://developers.cloudpayments.ru/#check

幂等性

库支持幂等查询

...
$apiClient = new \Flowwow\Cloudpayments\Library(\*...*\);
$apiClient->setIdempotency(true);
$apiClient->createPaymentByCard2Step(\*...*\);
...

许可证

MIT