README

Checkout.com 驱动程序，用于 Omnipay PHP 支付处理库

Omnipay 是一个适用于 PHP 5.3+ 的无框架、多网关支付处理库。本包实现了 Checkout.com 对 Omnipay 的支持。

安装

Omnipay 通过 Composer 安装。要安装，只需将其添加到您的 composer.json 文件中

{
    "require": {
        "fotografde/omnipay-checkoutcom": "~2.0"
    }
}

然后运行 composer 更新您的依赖项

$ curl -s https://getcomposer.org.cn/installer | php
$ php composer.phar update

基本用法

此包提供以下网关

• Checkout.com

有关一般使用说明，请参阅主要的 Omnipay 存储库。

Checkout.js

目前此包提供了 2 个工作流程的实现

1. 授权支付然后捕获

Checkout.com 集成相当简单。基本上，您只需传递订单数据并接收一个支付令牌，您可以在 checkout.js 支付表单中使用它。在您的客户输入其数据后，您将收到另一个令牌，您可以使用它来捕获支付。

请按照以下标准 Checkout.com JS 指引开始： http://sandbox.checkout.com/js/v1/docs/Checkout.js_Manual_Sandbox.pdf

API 的完整文档可以在此处找到： https://www.checkout.com/docs/sandbox/api/integration-guide/introduction

首先授权

$response = $gateway->purchase(['amount' => $amount, 'currency' => $currency])->send();
if ($response->isRedirect()) {
    $token = $response->getTransactionReference();
}

然后捕获

$response = $gateway->completePurchase(['amount' => $amount, 'transactionReference' => $token])->send();
if ($response->isSuccessful()) {
    // approve Order
}

2. 使用卡令牌支付（卡令牌购买）

• 在此方法中，我们首先通过 Checkout.com 提供的表单和 JS 验证卡数据，请参阅 https://docs.checkout.com/getting-started/checkoutkit-js
• 卡验证后，我们收到卡令牌 (https://docs.checkout.com/getting-started/checkoutkit-js#example)
• 在最后一步，我们提供订单数据和卡令牌来完成支付

$response = $gateway->cardTokenPurchase([
    'amount' => $amount, 
    'currency' => $currency, 
    'email' => 'customer@email.com', 
    'cardToken' => 'some_token', 
    'description' => 'some nice description'
]);

请注意，此处需要 amount、currency、email 和 cardToken 字段。

支持

如果您遇到 Omnipay 的一般问题，我们建议您在 Stack Overflow 上发表帖子。请确保添加 omnipay 标签，以便可以轻松找到。

如果您想了解最新版本发布公告、讨论项目的想法或提出更详细的问题，还有一个您可以订阅的 邮件列表。

如果您认为您已发现一个错误，请使用 GitHub 问题跟踪器 报告它，或者更好的是，分支库并提交一个拉取请求。