Kassa24

Обзор

Kassa24 — платежный метод для проведения платежей с оплатой наличными в терминалах Kassa24. Оплата осуществляется через Payment Page.

Загрузить логотип этого платежного метода в векторном формате можно здесь.

Тип платежного метода	Платежи в терминалах оплаты
Регионы использования	Казахстан
Валюты платежей	KZT
Конвертация валют
Оплата
Выплата
Оплата по сохраненным данным
Полный возврат
Частичный возврат
Опротестование
Особенности	Оплата осуществляется наличными в терминалах оплаты Kassa24
Организация и стоимость подключения	По согласованию с курирующим менеджером Rocketpay

Схема работы

В проведении отдельного платежа с использованием метода Kassa24 задействуются веб-сервис мерчанта, один из интерфейсов и платежная платформа Rocketpay, а также технические средства Kassa24.

Основные операции

	Интерфейсы				Суммы, KZT		Время
	Payment Page	CMS Plug-ins	Gate	Dashboard	минимум	максимум	базовое	предельное
Оплата					5,00		*	*

* Информацию необходимо уточнять у курирующего менеджера Rocketpay.

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

Сценарии использования

При проведении оплат с использованием метода Kassa24 пользователю отображается платежная инструкция, в соответствии с которой он должен совершить оплату наличными в терминале.

Рис.: Оплата через Payment Page

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

Оплата через Payment Page

Общая информация

Для оплаты через Payment Page с использованием метода Kassa24 со стороны веб-сервиса необходимо отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL Rocketpay и принять оповещение о результате оплаты. При этом существует возможность открыть Payment Page так, чтобы на ней уже был выбран метод Kassa24. (Подробнее о предварительном выборе метода см. Предварительный выбор платежного метода.)

Полная схема проведения оплаты выглядит следующим образом.

Рис.: Проведение оплаты через Payment Page. Описание шагов

Пользователь на стороне веб-сервиса инициирует оплату.
От веб-сервиса на заданный URL-адрес Rocketpay передается запрос на проведение оплаты через Payment Page.
Запрос на проведение оплаты поступает в платежную платформу.
Выполняется начальная обработка запроса, в рамках которой обеспечивается проверка наличия обязательных параметров и корректной подписи.
Осуществляется формирование Payment Page согласно параметрам проекта и вызова.
Пользователю отображается сформированная платежная форма.
Пользователь выбирает для оплаты метод Kassa24.
Пользователю отображается форма для ввода номера мобильного телефона.
Пользователь вводит номер мобильного телефона.
На Payment Page пользователю отображаются данные для оплаты и платежная инструкция. В инструкции отображается время, за которое оплата должна быть совершена пользователем.
Пользователь выполняет необходимые действия для оплаты согласно инструкции.
На стороне сервиса Kassa24 выполняется обработка платежа.
Результат оплаты отображается пользователю в сервисе Kassa24.
От сервиса Kassa24 к платежной платформе направляется уведомление о результате оплаты.
Платежная платформа направляет в веб-сервис оповещение о результате оплаты.

Информация о формате запросов и параметрах вызова Payment Page при работе с методом Kassa24, а также о формате оповещений о результатах оплаты приведена далее. Общую информацию о работе с Payment Page API можно найти в разделе Описание Payment Page API.

Формат запросов

При формировании запросов на открытие платежной формы с использованием метода Kassa24 необходимо учитывать следующее:

Должен использоваться базовый минимум параметров, которые обязательны для любого платежного метода:
- project_id — идентификатор проекта, полученный от Rocketpay при интеграции;
- payment_id — идентификатор платежа, уникальный в рамках проекта;
- customer_id — идентификатор пользователя, уникальный в рамках проекта;
- customer_first_name — имя пользователя;
- customer_last_name — фамилия пользователя;
- customer_email — адрес электронной почты пользователя;
- payment_currency — код валюты платежа в формате ISO-4217 alpha-3;
- payment_amount — сумма платежа в дробных единицах валюты без десятичной точки и пробелов за исключением случаев, когда у валюты нет дробной части. Если у валюты нет дробных единиц (то есть количество разрядов дробных единиц равно нулю), то в этом параметре нужно указывать сумму в основных единицах валюты. Подробнее о разрядах дробных единиц у валют см. Коды валют.
Валютой платежа может быть только KZT.
Для предварительного выбора метода Kassa24 в запросе надо указать код kassa24 в параметре force_payment_method.
Дополнительно могут использоваться любые другие параметры из числа доступных для работы с Payment Page. Информация об этих параметрах приведена в разделе Параметры открытия платежной страницы Payment Page.
После определения всех параметров необходимо составить подпись. Подробная информация — в разделе Подписывание и проверка подписи.

Вот пример данных из запроса на открытие платежной формы с использованием метода Kassa24:

EPayWidget.run(
    {
        project_id: 1234,
        payment_id: 'payment_47',
        customer_id: 'customer_123',
        customer_first_name: 'John',
        customer_last_name: 'Doe',
        customer_email: 'johndoe@example.com',
        payment_currency: 'KZT',
        payment_amount: 1000,    
        signature: "kUi2x9dKHAVNU0FYldJrxh4yo+52Kt8KU+Y19vySO\/RLUkDJrOcZzUCwX6R\/ekpZhkIQg=="
    }
)

Формат оповещений

Для оповещений о результатах оплат с использованием метода Kassa24 используется типовой формат, описание которого представлено в разделе Оповещения (callbacks) в Payment Page.

В следующем примере в оповещении содержится информация о том, что в рамках проекта 1234 проведена оплата в размере 500,00 KZT.

Рис.: Пример данных из оповещения о проведении оплаты

{
    "project_id": 1234,
    "payment": {
        "date": "2019-10-12T15:27:17+0000",
        "id": "11",
        "method": "kassa24",
        "status": "success",
        "sum": {
            "amount": 50000,
            "currency": "KZT"
        },
        "type": "purchase",
        "description": ""
    },
    "customer": {
        "id": "customer_123"
    },
        "operation_fee": {
            "amount": 0,
            "currency": "KZT"
        },
        
        "phone": "123456789",
        "operation": {
            "id": 8416000007811,
            "type": "sale",
            "status": "success",
            "date": "2019-10-12T15:27:17+0000",
            "created_date": "2019-10-12T15:23:15+0000",
            "request_id": "4f375660191b0d4ef7933284b373041286489-00008417",
            "sum_initial": {
                "amount": 50000,
                "currency": "KZT"
            },
            "sum_converted": {
                "amount": 50000,
                "currency": "KZT"
            },
            "code": "0",
            "message": "Success",
            "provider": {
                "id": 1114,
                "payment_id": "86315380",
                "auth_code": "",
                "date": "2019-10-12T21:26:01+0000"
            }
        },
        "signature": "BJs+ZQ2nCWxumoyEFAISS6jL5rQ0qmnWmCBPAc8BpUDbiWA7Z8+kN9NcpvTgtTA=="
}

В следующем примере содержится информация об отклонении оплаты из-за истечения времени ожидания.

Рис.: Пример оповещения об отклонении оплаты

 { 
        "customer": {
            "id": "eDTptbsRdas"
        },
        "operation_fee": {
            "amount": 0,
            "currency": "KZT"
        },
        "payment": {
            "date": "2019-10-12T15:27:17+0000",
            "id": "12",
            "method": "kassa24",
            "status": "decline",
            "sum": {
                "amount": 87900,
                "currency": "KZT"
            },
            "type": "purchase",
            "description": ""
        },
        "project_id": 138,
        "phone": "123456789",
        "operation": {
            "id": 8416000007811,
            "type": "sale",
            "status": "decline",
            "date": "2019-10-12T15:27:17+0000",
            "created_date": "2019-10-12T15:23:15+0000",
            "request_id": "4f375660191b0d4ef7933284b373041286489-00008418",
            "sum_initial": {
                "amount": 87900,
                "currency": "KZT"
            },
            "sum_converted": {
                "amount": 87900,
                "currency": "KZT"
            },
            "code": "20602",
            "message": "Time-out",
            "provider": {
                "id": 1114,
                "payment_id": "86315380",
                "auth_code": "",
                "date": "2019-10-12T21:26:01+0000"
            }
        },
        "signature": "BJs+ZQ2nCWxumoyEFAISS6jL5rQ0qmnWmCdsadqwDbiWA7Z8+kN9NcpvTgtTA=="
}

Дополнительные материалы

Для организации работы с оплатами через Payment Page также могут быть полезны следующие материалы:

Тестирование

Общая информация

Для метода Kassa24 доступно тестирование оплат через Payment Page.

Тестирование может выполняться в рамках тестового проекта, и для подключения и отключения этой функциональности необходимо обращаться к специалистам технической поддержки Rocketpay support@rocketpay.kz.

При проведении тестовых платежей следует учитывать, что в запросах должен указываться идентификатор тестового проекта, а интерфейсы эмулятора платежных форм Payment Page и Kassa24 могут отличаться от рабочих.

Статусы тестовых платежей

При тестировании оплат их итоговые статусы определяются исходя из сумм, указанных в запросах:

decline — при указании суммы 40000 или 40400,
success — при указании любой другой суммы.

Оплата через Payment Page

Для проведения тестовой оплаты через Payment Page необходимо:

Отправить в платежную платформу корректный тестовый запрос на открытие Payment Page.
Если в запросе не был указан метод kassa24 — выбрать метод Kassa24 на странице эмулятора.
Указать в поле ввода произвольный номер телефона.
Убедиться в отображении инструкции.
Принять оповещение с информацией о результате оплаты (это оповещение отправляется по истечении 10 секунд после формирования страницы с инструкцией, отображаемой на шаге 4).

Подробная информация о проведении оплат с использованием метода Kassa24 через Payment Page представлена в пункте Оплата через Payment Page.

Анализ результатов проведения платежей

Как и при работе с другими платежными методами, которые предоставляет Rocketpay, при использовании этого метода доступны разные способы анализа информации о платежах и операциях.

Всю необходимую информацию можно получать и анализировать средствами Dashboard (dashboard.rocketpay.kz), в том числе с помощью аналитических панелей в разделе Аналитика.

Также можно выгружать необходимую информацию для последующего анализа с помощью специализированных аналитических средств сторонних разработчиков:

Dashboard позволяет выгружать данные в формате CSV с помощью инструментов в разделе Отчеты. При этом можно выполнять разовые и периодические выгрузки информации на локальный компьютер.
Data API позволяет получать информацию в формате JSON и отправлять ее на заданный URL — для этого применяются запросы к конечной точке /operations/get.

С любыми вопросами о возможностях анализа можно обращаться в службу технической поддержки Rocketpay.