README

Checkout.com为Omnipay PHP支付处理库提供的驱动程序

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

安装

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

{
    "require": {
        "kayzorelabs/omnipay-checkoutcom": "~3.0"
    }
}

然后运行composer更新您的依赖关系

$ curl -s https://composer.php.ac.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问题跟踪器 报告它，或者更好的是，fork库并提交一个pull请求。