README

[](https://packagist.org.cn/packages/mydevcodes/ ipaymer-php) [](https://packagist.org.cn/packages/mydevcodes/ ipaymer-php)

完成您的 iPaymer 账户后，您需要将其连接到您的应用程序。当您将 iPaymer 集成到 PHP 应用程序时，此包是您最好的伙伴。如果您所在的平台未被 iPaymer 白名单允许，您将无法使用此库。

安装

您可以通过 composer 安装此包

composer require mydevcodes/ipaymer-php

使用方法

调用 iPaymer PHP 的最简单方法

use Mydevcodes\IpaymerPhp\IpaymerPhp;
IpaymerPhp::init('Your_Secret_Key', 'production|development');

方法

创建客户

创建客户还需要订阅和附加一张信用卡。

$customerData = [
    'name' => 'Jimm',
    'email' => 'jimmy@jimmy.com'
];

$ipaymer_customer_id = IpaymerPhp::init('Your_Secret_Key')->create($customerData);

重定向链接

这些辅助方法将为不同的方法构建指向 iPaymer 的重定向链接。

新订阅/升级到套餐

IpaymerPhp::init('Your_Secret_Key')->checkoutLink('CUSTOMER_IPAYMER_ID', 'PLAN_CODE', 'RETURN_URL');

新卡

IpaymerPhp::init('Your_Secret_Key')->newCardLink('CUSTOMER_IPAYMER_ID');

分配计划

为客户分配一个特定计划。这不会替换任何之前的活动计划。

IpaymerPhp::init('Your_Secret_Key')->assign('CUSTOMER_IPAYMER_ID', 'PLAN_ID', 'QUANTITY');

切换计划

用另一个计划替换特定计划。通常在升级/降级时使用。

IpaymerPhp::init('Your_Secret_Key')->change('CUSTOMER_IPAYMER_ID', 'FROM_PLAN_ID', 'TO_PLAN_ID');

支付计划 [已弃用]

您的所有支付计划应已在 iPaymer 中注册。如果客户仅定义了同一支付网关附加的计划，则将返回这些计划。

IpaymerPhp::init('Your_Secret_Key')->plans($customerId);

状态

分别返回每个计划的客户状态。如果客户有两个计划，将返回有关这些计划的状态和额外信息。

IpaymerPhp::init('Your_Secret_Key')->status('CUSTOMER_IPAYMER_ID');

发票

按降序返回所有客户发票

IpaymerPhp::init('Your_Secret_Key')->invoices('CUSTOMER_IPAYMER_ID');

生成自定义发票

use Mydevcodes\IpaymerPhp\IpaymerPhp;
IpaymerPhp::init('Your_Secret_Key')->generateInvoice('CUSTOMER_IPAYMER_ID', 'PLAN_CODE', 'PRICE', 'QUANTITY', 'DESCRIPTION');

取消计划

取消客户账单周期中的计划

IpaymerPhp::init('Your_Secret_Key')->cancel('CUSTOMER_IPAYMER_ID', 'PACKAGE_CODE');

移除卡

从客户中移除一张卡

IpaymerPhp::init('Your_Secret_Key')->remove('CUSTOMER_IPAYMER_ID', 'IPAYMER_CARD_ID');

变更日志

请参阅 CHANGELOG 了解最近更改的详细信息。

贡献

请参阅 CONTRIBUTING 了解详细信息。

安全

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

鸣谢

• Mustafe Hyseni
• Mydev.com
• 所有贡献者

许可

MIT 许可证 (MIT)。请参阅 许可文件 了解更多信息。