README

用于将 "MikBill" 计费系统与 "中心收银台" 支付系统集成的 API

链接

• 开发
• 项目介绍 (MikBill)
• 项目介绍 (中心收银台)
• MikBill 文档
• API 中心收银台 文档

功能

• 检查未来付款的参数
• 执行付款
• 检查付款状态

要求

• PHP >= 7.2
• libxml
• MBString
• PDO
• SimpleXML
• vlucas/phpdotenv ^5.3

安装

composer require itpanda-llc/mikbill-ckassa-bisys-api

配置

• 将文件 ".env.example" 复制到 ".env"

copy .env.example .env

• 在文件 ".env" 中指定参数
• 在文件 "index.php" 中指定接口路径，该文件已预先放置在 Web 服务器目录中

接口响应示例

<?xml version="1.0" encoding="utf-8"?>
<response>
    <params>
        <err_code>0</err_code>
        <err_text>Клиент найден</err_text>
        <client_name>П****** М***** М*********</client_name>
        <balance>0.00</balance>
    </params>
    <sign>234F1D19DB3529D3264B65AF71C4713A</sign>
</response>

<?xml version="1.0" encoding="utf-8"?>
<response>
    <params>
        <err_code>0</err_code>
        <err_text>Платеж принят</err_text>
        <reg_id>1911229</reg_id>
        <reg_date>2019-11-30T13:41:31</reg_date>
    </params>
    <sign>97A05DF49214366B6092E9C20BD50CDF</sign>
</response>

<?xml version="1.0" encoding="utf-8"?>
<response>
    <params>
        <err_code>1</err_code>
        <err_text>Платеж уже был проведен</err_text>
        <reg_id>1911229</reg_id>
        <reg_date>2019-11-30T13:41:31</reg_date>
    </params>
    <sign>7C575CF89A465A1B3A4C1E6F383E81E7</sign>
</response>

<?xml version="1.0" encoding="utf-8"?>
<response>
    <params>
        <err_code>2</err_code>
        <err_text>Платеж ожидает обработки у оператора</err_text>
        <reg_id>1911229</reg_id>
        <reg_date>2019-11-30T13:41:31</reg_date>
    </params>
    <sign>FAEE70E199E6A0D601D3BC46C55C723D</sign>
</response>

<?xml version="1.0" encoding="utf-8"?>
<response>
    <params>
        <err_code>0</err_code>
        <err_text>Платеж обработан</err_text>
        <reg_id>1911229</reg_id>
        <reg_date>2019-11-30T13:41:31</reg_date>
    </params>
    <sign>1F7C240928CF65276C5D1A3D3FC389EB</sign>
</response>

<?xml version="1.0" encoding="utf-8"?>
<response>
    <params>
        <err_code>11</err_code>
        <err_text>Указаны не все необходимые параметры</err_text>
    </params>
</response>

<?xml version="1.0" encoding="utf-8"?>
<response>
    <params>
        <err_code>13</err_code>
        <err_text>Неверная цифровая подпись</err_text>
    </params>
</response>

<?xml version="1.0" encoding="utf-8"?>
<response>
    <params>
        <err_code>20</err_code>
        <err_text>Указанный номер счета отсутствует</err_text>
    </params>
    <sign>641BAA1236527308625A4AB1ED4665ED</sign>
</response>