README

MaxiCash集成平台允许商家通过其移动应用程序或网站集成MaxiCash平台，以接收支付。API使用JSON与.NET客户端或PHP等开源平台进行交互。更多信息请参阅Maxicash文档

安装

您可以通过安装Composer包并将其添加到应用程序的依赖项来使用PHP客户端。

composer require devscast/maxicash

使用方法

MaxiCash网关使商家能够通过多种支付渠道（如信用卡、MaxiCash、Paypal、移动货币和移动银行）收集其MaxiCash账户的支付。

身份验证

• 步骤1. 下载MaxiCash移动应用程序并注册...
• 步骤2. 联系我们升级您的账户为商家账户 info@maxicashapp.com 您将收到一份商家表格以完成，以便提供您的业务详情和首选的现金提款钱包或银行详情。
• 步骤3. 一旦完成文件工作，您将获得实时和沙盒账户（商家ID和商家密码）

use Devscast\Maxicash\Client as Maxicash;
use Devscast\Maxicash\Credential;
use Devscast\Maxicash\PaymentEntry;
use Devscast\Maxicash\Environment;

$maxicash = new Maxicash(
    credential: new Credential('marchand_id', 'marchand_password'),
    environment: Environment::SANDBOX // use `Environment::LIVE` for live
);

创建支付条目

$entry = new PaymentEntry(
    credential: $maxicash->credential,
    amount: intval(47.50 * 100), // amount in cents
    reference: "this text will be shown on maxicash payment page",
    acceptUrl: "your_website_accept_url",
    declineUrl: "your_website_decline_url",
);

注意：我们强烈建议您的接受和拒绝URL对每个交易都是唯一的，这样用户就不能重新使用它们来验证其他交易，在您的端保存带有唯一生成令牌（即交易参考）的交易，并将其用作接受和拒绝URL的参数，不要将其用于PaymentEntry->reference；一旦用户被重定向到您的接受URL，验证令牌并授予对已支付资源的访问权限（使用您自己的业务逻辑）。

重定向到Maxicash网关

将您的用户重定向到Maxicash网关以继续支付流程

注意：如果您在Symfony应用程序中使用Turbo Drive，请在您的twig模板中的支付链接上禁用它

$url = $maxicash->queryStringURLPayment($entry);

注意：我们强烈建议执行服务器端重定向，此URL可以被修改，并且在以任何方式显示给用户时可能会泄露您的Maxicash凭据（例如：链接、按钮或表单）！您可以在vanilla PHP中使用header("Location: $url")函数，或在使用Symfony或Laravel框架的控制器中使用RedirectResponse($url)返回。

为非政府组织提供捐赠按钮

一旦您注册为非政府组织商家

$donationUrl = $maxicash->donationUrl()

支持的功能

• 查询字符串URL支付
• 为非政府组织提供捐赠按钮
• 表单提交支付
• 支付条目Web