README

CMI PHP PAYMENT 是一个开源的 PHP 支付处理 库。它提供了一种更简单的方式与摩洛哥的 CMI PAYMENT PLATEFORM cmi.co.ma 进行通信。

该类采用面向对象编程 (OOP) 编写，以便更容易进行通信和理解 CMI 的工作原理。

注意：这个小库遵循 FIG 标准 PSR-4。

系统要求

cmi-php 需要以下组件才能正确运行

PHP >= 8.1
cUrl 扩展
mbstring 扩展

Composer 安装

您可以通过 composer 安装绑定。运行以下命令

composer require mehdirochdi/cmi-payment-php

要使用绑定，请使用 Composer 的自动加载

require_once('vendor/autoload.php');

手动安装

如果您出于某种原因不想使用 Composer，您可以使用绑定，包含 init.php 文件。

require_once('/path/to/cmi-php/init.php');

入门

示例金额文本字段 example/formRequest.php

...
    <h1>Payment form CMI</h1>
    <form method="post" action="/example/process.php">
    <label for="amount">Amount</label>
        <input type="text" name="amount" class="input-control" placeholder="put amount here 10.65" value="10.60"> DHS<br/>
        <button type="submit">Buy</button>
    </form>
...

请注意，storekey 和 clientid 由 CMI 提供，您应与他们联系 cmi.co.ma

<?php
// REQUIRED PARAMS
$client = new Mehdirochdi\CMI\CmiClient([
    'storekey' => '', // STOREKEY
    'clientid' => '', // CLIENTID
    'oid' => '135ABC', // COMMAND ID IT MUST BE UNIQUE
    'shopurl' => 'YOUR_DOMAIN_HERE', // SHOP URL FOR REDIRECTION
    'okUrl' => 'YOUR_DOMAIN_HERE/okFail.php', // REDIRECTION AFTER SUCCEFFUL PAYMENT
    'failUrl' => 'YOUR_DOMAIN_HERE/okFail.php', // REDIRECTION AFTER FAILED PAYMENT
    'email' => 'mehdi.rochdi@gmail.com', // YOUR EMAIL APPEAR IN CMI PLATEFORM
    'BillToName' => 'mehdi rochdi', // YOUR NAME APPEAR IN CMI PLATEFORM
    'BillToCompany' => 'company name', // YOUR COMPANY NAME APPEAR IN CMI PLATEFORM
    'amount' => $_POST['amount'], // RETRIEVE AMOUNT WITH METHOD POST
    'CallbackURL' => 'YOUR_DOMAIN_HERE/callback.php', // CALLBACK
]);

$client->redirect_post(); // CREATE INPUTS HIDDEN, GENERATE A VALID HASH AND MAKE REDIRECT POST TO CMI
?>

基本测试卡号

在测试模式下不能使用信用卡信息。相反，您可以使用以下任一测试卡号、未来的有效到期日期以及任意的随机 CVC 号码来创建成功的支付。

分支： visa，PAN： 4000000000000010，到期日期： 随意填写日期 CVC： 000

分支： MasterCard，PAN： 5453010000066100，到期日期： 随意填写日期 CVC： 000

3D Secure 测试卡号

以下卡信息用于测试本地支付，例如强客户身份验证 SCA

分支： MasterCard，PAN： 5191630100004896，认证码： 123 到期日期： 随意填写日期 CVC： 000

可选参数示例

<?php
// REQUIRED PARAMS
$client = new Mehdirochdi\CMI\CmiClient([
    ...
    'AutoRedirect' => 'true',
]);
OR
$client->AutoRedirect = 'true'; // REDIRECT THE CUSTOMER AUTOMATICALY BACK TO THE MERCHANT's WEB SITE WHEN TRANSACION IS ACCEPTED
$client->redirect_post(); // CREATE INPUTS HIDDEN, GENERATE A VALID HASH AND MAKE REDIRECT POST TO CMI

mehdirochdi / cmi-payment-php

维护者

详细信息