README

Mojopay 网关用于 Omnipay PHP 支付处理库

Omnipay 是一个不依赖于框架、多网关的 PHP 5.3+ 支付处理库。此包实现了 Omnipay 的 Mojopay 支持。

安装

通过 Composer

$ composer require knightar/omnipay-mojopay

使用方法

此包提供以下网关

• Mojopay

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

此驱动程序支持以下交易类型

• authorize($options) - 在客户的卡上授权一定金额
• capture($options) - 捕获先前已授权的金额
• purchase($options) - 授权并立即在客户的卡上捕获一定金额
• refund($options) - 退款已处理的交易
• void($options) - 通常只能在提交交易后 24 小时内调用

网关实例化

    $gateway = Omnipay::create('Mojopay');
    $gateway->setProcessorId('abcdefg1234567');
    $gateway->setToken('6ef44f261a4a1595cd377d3ca7b57b92');
    $gateway->setTestMode(true);

驱动程序还支持使用 cardReference 而不是 card 通过客户保险库中的储值卡支付，使用 cardReference 参数使用保险库函数。

此驱动程序还支持将客户数据存储在 Mojopay 的客户保险库中

• createCard($options) - 在客户保险库中创建条目
• updateCard($options) - 更新客户保险库中的条目
• deleteCard($options) - 删除客户保险库中的条目

    $formData = array('number' => '4242424242424242', 'expiryMonth' => '8', 'expiryYear' => '2017', 'cvv' => '123');
    
    $response = $gateway->createCard([
        'card'          => $formData
    ])->send();
    
    $cardReference = $response->getCardReference();

• listCards - 根据标准列出客户保险库记录

    # Each criteria are optional, no criteria will return no records
    $response = $gateway->listCards([
        'cardReference' => '', # The hash to identify the customer in the vault
        'firstName'     => '', # Portion of cardholder's first name.
        'lastName'      => '', # Portion of cardholder's last name.
        'email'         => '', # Portion of billing email address.
        'last4cc'       => ''  # Last 4 digits of credit card number.
    ]);
    $response_rows = $response->getResponse();

cardReference 可用于授权、购买和退款请求

    $gateway->purchase([
        'amount'        => '10.00',
        'cardReference' => '1234567890'
    ]);

此驱动程序还支持订阅管理，可以通过以下方式访问

• subscription_add($options) - 添加订阅
• subscription_delete($options) - 删除订阅

    # As an example we will add a subscription the starts on 01/04/2017
    $gateway->subscription_add([
        'cardReference'          => '1234567890',
        'planId'                 => '1234567890',
        'subscriptionStartDay'   => '01',
        'subscriptionStartMonth' => '04',
        'subscriptionStartYear'  => '2017'
    ]);

API 调用待办事项列表，最终将实现

• 添加、更新、删除、列出定期计划
• 按客户列出订阅
• 在启动销售/授权/信用/验证交易时添加客户到保险库

我们目前没有计划实现以下调用（希望添加它们的拉取请求被接受）

• 添加自定义订阅 - 不返回取消所需的订阅 ID
• 添加客户和订阅 - 不返回取消所需的订阅 ID

注意：已实现信用 API 调用，但默认情况下在商家账户中未启用，如需此功能，请联系 Mojopay。请注意，此代码未经测试。

支持

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

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

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

变更日志

请参阅变更日志获取更多关于最近更改的信息。

测试

$ composer test

贡献

请参阅贡献指南以获取详细信息。

安全

如果您发现任何与安全相关的问题，请通过电子邮件jablonski.kce@gmail.com联系，而不是使用问题跟踪器。

致谢

• 约翰·贾布隆斯基
• 所有贡献者

许可证

MIT许可证（MIT）。请参阅许可证文件以获取更多信息。