README

出于隐私原因，未经书面许可，Flexpay原始文档不能共享。有关凭证和实现细节的更多信息，请联系flexpay.cd。

安装

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

composer require devscast/flexpay

使用方法

认证

步骤 1. 联系Flexpay获取商户账户。您将收到一份商户表格，以便提供您的业务详情和首选提现钱包或银行详情。
步骤 2. 一旦完成文件，您将获得实时和沙盒账户（商户代码和授权令牌）。

然后使用这些凭证来认证您的客户端

use Devscast\Flexpay\Client as Flexpay;
use Devscast\Flexpay\Credential;
use Devscast\Flexpay\Environment;

$flexpay = new Flexpay(
    new Credential('token', 'merchant_code'),
    Environment::SANDBOX // use Environment::LIVE for production
);

创建支付（意向）

use Devscast\Flexpay\PaymentEntry;
use Devscast\Flexpay\Data\Currency;

$entry = new PaymentEntry(
    amount: 10, // 10 USD
    currency: Currency::USD,
    phone: "243999999999", // mandatory for mobile money
    reference: "your_unique_transaction_reference",
    description: "your_transaction_description",
    callbackUrl: "your_website_webhook_url",
);

注意：我们强烈建议您为每次交易设置唯一的callbacks URL。

处理支付（移动货币）

一旦调用，Flexpay将向用户的移动货币账户发送支付请求，用户需要在手机上确认支付。之后，将处理支付并调用回调URL以提供交易详情。

$payment = $flexpay->pay($entry);

处理回调（callbackUrl，approveUrl，cancelUrl，declineUrl）

Flexpay将向定义的回调URL发送POST请求，响应将包含交易详情。您可以使用以下代码通过提供传入数据作为数组来处理回调。

$state = $flexpay->handleCallback($_POST);
$state->isSuccessful(); // true or false

检查交易状态

您不相信webhook？您始终可以通过提供订单号来检查交易状态。

$state = $flexpay->check($payment->orderNumber);
$state->isSuccessful(); // true or false

支持的功能

移动支付服务
检查交易
卡支付（不稳定）

devscast / flexpay

维护者

详细信息