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