Интеграция с системой Онлайн-платежи

Для технической интеграции с системой Онлайн-платежи необходимо разработать программный модуль или загрузить готовое расширение, если оно есть под вашу платформу (CMS).

Порядок подключения к системе Онлайн-платежи

1. Регистрация пользователя в кабинете Kassa24 Business.
2. Регистрация нового сайта в разделе «Онлайн-платежи».
3. Загрузка в кабинет необходимых документов (параллельно с п. 4).
4. Техническая интеграция и тестирование (параллельно с п. 3).
5. После одобрения compliance переход в production-режим.

Функционал модуля

1. Генерация платежной информации для отправки в систему Онлайн-платежи.
2. Прием данных о результатах оплаты при помощи Callback’а.

Сценарии оплаты с помощью системы Онлайн-платежи

Платеж — операция в системе Онлайн-платежи, при которой денежные средства получает мерчант.

Платеж

1. Пользователь своими действиями запускает процесс оплаты (например, нажимает кнопку Оплатить).
2. Сервер должен сгенерировать платежную информацию и отправить ее в систему Онлайн-платежи (пример запроса ниже).
3. Если переданные данные корректны, в ответ вернется URL, куда следует перенаправить пользователя для оплаты и номер платежа в системе Онлайн-платежи.
4. После того как пользователь совершит оплату, на указанный endpoint для коллбэков (пример запроса ниже) будет выслано сообщение с информацией о платеже (сообщение высылается для успешных, неуспешных и просроченных платежей). Также доступна отправка подтверждений на e-mail (только успешные платежи) в произвольном формате.

Двухэтапный платеж (платеж с предавторизацией)

Двухэтапный платеж — платеж с предварительной заморозкой денежных средств. По итогу первого шага деньги замораживаются на счете плательщика, по итогу второго шага — списываются со счета.

1. Пользователь своими действиями запускает процесс оплаты (например, нажимает кнопку оплатить).
2. Сервер должен сгенерировать платежную информацию и отправить ее в Kassa24 Business (пример запроса ниже).
3. Если переданные данные корректны, в ответ вернется URL, куда следует перенаправить пользователя для оплаты, и номер платежа в системе Онлайн-платежи.
4. После того как пользователь совершит оплату, на указанный endpoint для коллбэков будет выслано сообщение с информацией об успешном холде либо ошибке.
5. Мерчант должен отправить запрос подтверждения платежа (пример запроса ниже).
6. Будет отправлен коллбэк об успешном/ошибочном статусе транзакции.

Выплата

Техническая документация программы по выплатам Business Kassa24

Выплата — это платеж в обратную сторону, т.е. по завершению операции деньги получает клиент, а не мерчант.

Для Выплат необходимо к стандартному запросу на создание транзакции добавить в JSON элемент type со значением 1 ("type":1)

1. Пользователь своими действиями запускает процесс оплаты или выплаты (например, нажимает кнопку Оплатить).
2. Сервер должен сгенерировать платежную информацию и отправить еe в систему Онлайн-платежи (пример запроса ниже).
3. Если данные переданы корректно, в ответ вернется URL, куда следует перенаправить пользователя для ввода карты и номер выплаты/платежа в системе Онлайн-платежи.
4. После того как пользователь подтвердит введенную информацию, на указанный endpoint для коллбэков будет выслано сообщение с информацией о выплате/платеже (сообщение высылается для успешных, неуспешных и просроченных выплат).

Двухэтапная выплата (Cashout с предавторизацией)

Двухэтапная выплата — выплата в системе Онлайн-платежи, при которой денежные средства получает мерчант.

1. Пользователь своими действиями запускает процесс оплаты или выплаты (например, нажимает кнопку Оплатить).
2. Сервер должен сгенерировать платежную информацию и отправить еe в систему Онлайн-платежи (пример запроса ниже).
3. Если данные переданы корректно, в ответ вернется URL, куда следует перенаправить пользователя для ввода карты и номер выплаты/платежа в системе Онлайн-платежи.
4. После того как пользователь подтвердит введенную информацию, на указанный endpoint для коллбэков (пример запроса ниже) будет выслано сообщение с информацией о выплате (успешном холде или ошибка).
5. Cервер мерчанта должен отправить запрос на финализацию (пример запроса ниже).
6. В случае успешной финализации будет отправлен второй callback для с информацией о выплате (успех/ошибка).

Примеры запросов в системе Онлайн-платежи

Используется строковой тип данных.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
    "orderId":"1234567890",
    "merchantId":"1",
    "amount":10000,
    "returnUrl":"https://yoursite.kz/payment/complete",
    "callbackUrl":"https://yoursite.kz/callback?order=1234567890",
    "description":"Test payment for [email protected]",
    "customerData":{
        "email":"[email protected]",
        "phone":"7773724757"
    },
    “metadata”:{
        “session”:” 3135c7fe-272f-46d0-a5f8-1ab2a59ac17c”
    }
}

В ответ на создание платежа будет возвращен номер выплаты/платежа в системе Онлайн-платежи и URL для перенаправления:

1
2
3
4
{
    "url":"ecommerce.pult24.kz/payment/view?id=9876543210",
    "id":"9876543210"
}

После этого приходит ответ (Callback).

Пример присылаемого на callbackUrl запроса:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
    "orderId":"123",
    "id":"123",
    "amount":10000,
    "commission":100,
    "commissionIncluded":true,
    "attempt":1,
    "returnUrl":"https://my.site.kz/",
    "callbackUrl":"https://my.site.kz/",
    "date":"2006-01-02T15:04:05",
    "dateOut":"2006-01-02T15:04:05",
    "status":1,
    "errCode":0,
    "errMessage":"Ошибок нет",
    "metadata":{
        "session":"3135c7fe-272f-46d0-a5f8-1ab2a59ac17c"
    }
}

Алгоритм работы Kassa24 Business

Запрос статуса транзакции

Ознакомиться с информацией о статусах транзакции можно по ссылке: Kassa24 Business запрос статуса транзакции.