README

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

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

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

系统要求

cmi-php 正确工作需要以下组件

PHP>=8
cUrl 扩展
mbstring 扩展

Composer 安装

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

composer require myteam-solution/cmi-payment-laravel

要使用绑定，请使用 Composer 的 autoload

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 MyTeamSolution\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' => 'dadda.abdelghafour2000@gmail.com', // YOUR EMAIL APPEAR IN CMI PLATEFORM
    'BillToName' => 'dadda abdelfgadour', // 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 MyTeamSolution\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

myteam-solution / cmi-payment-laravel

维护者

详细信息