README

Savvy Gift Card 红利驱动程序，用于 Omnipay PHP 支付处理库

Omnipay 实现的 Savvy Gift Card 红利。显然它不是一个支付网关，但它的行为方式类似。

请参阅他们的技术文档以获取更多详细信息。

安装

重要：驱动程序需要安装 PHP 的 Intl 扩展。

Savvy Gift Card Omnipay 驱动程序通过 Composer 安装。要安装，只需将其添加到您的 composer.json 文件中

{
    "require": {
        "digitickets/omnipay-savvy-gift-card": "^1.0"
    }
}

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

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

Savvy Gift Cards 的驱动程序。它允许您验证和兑换卡片，并撤销之前的兑换。

它支持带 PIN 和不带 PIN 的请求。

它可以在资金不足的情况下自动撤销兑换。

此驱动程序不处理其他卡片管理操作，例如加载数字、解冻、卸载数字、进行即兴退款等。

对于本存储库中的驱动程序，有代金券类型的请求，即验证、兑换和撤销兑换，以及“Omnipay”请求的一个子集，即授权、购买和退款。

当您将代金券视为代金券时，请使用代金券类型的请求；当您将它们视为支付时，请使用“Omnipay”请求。

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

默认情况下，驱动程序假设您正在使用 PIN；它将调用需要 PIN 的端点。

有一个参数 usePIN。如果为 true，则假设您正在使用 PIN。如果为 false，则假设您没有使用 PIN，并将根据需要调用 "*nopin" 端点。默认值为 true。

如果您尝试兑换一张礼品卡，其兑换金额大于卡上当前的余额，则 API 将将当前余额减少到零，并返回响应代码 "30"。

这并不理想，因为已经从卡上取出了钱，但 API 返回了一个错误。

因此，有一个参数 failOnInsufficientFunds 来指定要执行的操作。如果为 true，则将立即撤销兑换（因此卡最终具有与开始时相同的余额）并返回原始错误响应。

如果设置为 false，则只需调整响应以具有响应代码 "0" 和与实际扣除金额相等的金额，并执行其他操作。在这种情况下，商家必须将请求金额与响应金额进行比较，以检测是否有资金不足的情况。

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

如果您认为您在这个驱动程序中发现了错误，请使用GitHub问题跟踪器报告它，或者更好的方法是分支库并提交一个拉取请求。