itpanda-llc/mikbill-ckassa-bisys-api

API for integration of the MikBill billing system with the CKassa payment system

dev-main 2021-08-18 21:28 UTC

Requires

• php: >=7.2
• ext-libxml: *
• ext-mbstring: *
• ext-pdo: *
• ext-simplexml: *
• vlucas/phpdotenv: ^5.3

MIT

• itpanda-llc

README

API для интеграции биллинговой системы "MikBill" с платежной системой "Центральная касса"

Ссылки

• Разработка
• О проекте (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", предварительно размещенного в каталоге веб-сервера

Примеры ответов интерфейса

<?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>