Cash-in СНГ

Обзор

«Cash-in СНГ» — платёжный метод для проведения оплат с использованием физических терминалов на территории Содружества Независимых Государств (СНГ).

Характеристика

Тип платёжного метода Физический терминал
Регионы использования Зависят от терминала: KZ, UZ, GE, KG
Валюты платежей USD*
Конвертация валют На стороне провайдера
Оплаты +
Выплаты
Оплаты по сохранённым данным
Полные возвраты
Частичные возвраты
Опротестования
Особенности Оплата в терминале с помощью наличных
Организация и стоимость подключения По согласованию с курирующим менеджером ECommPay

* Пользователь может оплатить с использованием любой валюты, которая доступна в выбранном терминале. На стороне провайдера происходит конвертация валюты платежа в USD, и все платежи на стороне платёжной платформе и веб-сервиса проходят в валюте USD.

Поддерживаемые сети платёжных терминалов

Название Страна
Allpay KZ
BRIO Group UZ
Fenix KZ
Indigo24 KZ
Kassa24 KZ
Money Movers GE
Quickpay KG
Wallet One KZ

Схема работы

В проведении отдельного платежа с использованием «Cash-in СНГ» задействуются веб-сервис мерчанта, один из интерфейсов и платёжная платформа ECommPay, а также технические средства провайдера.

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

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

** Подробную информацию уточняйте у вашего курирующего менеджера ECommPay.

*** Базовое и предельное время определяются следующим образом:
  • Базовое время — среднее расчётное время проведения платежа от момента его инициирования на стороне платёжной платформы до момента отправки инициатору оповещения о результате. Это время, определяемое для условий штатной работы всех технических средств и каналов связи, а также типичных действий со стороны пользователя (там, где они необходимы). Базовое время рекомендуется использовать для реагирования на отсутствие оповещений о результате платежа и выполнения опроса состояния платежа.
  • Предельное время — максимально допустимое время проведения платежа от момента его инициирования на стороне платёжной платформы до момента отправки инициатору оповещения о результате. Если платёж не был проведён или отклонён за это время, он автоматически переводится в статус decline. Для индивидуальной настройки предельного времени следует обращаться к специалистам технической поддержки ECommPay.

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

Проведение оплат с использованием метода «Cash-in СНГ» выполняется с самостоятельным обращением пользователя к физическим терминалам сервиса «Cash-in СНГ».

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



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

Оплаты через Gate

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

Для оплаты с использованием метода «Cash-in СНГ» со стороны веб-сервиса необходимо:

  1. Обработать запрос на проверку существования лицевого счёта пользователя.
  2. Отправить ответ с информацией о существовании лицевого счёта пользователя.
  3. Обработать запрос на получение идентификатора платежа на стороне веб-сервиса.
  4. Отправить ответ с идентификатором платежа.
  5. Принять оповещение о результате оплаты.

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



Рис.: Проведение оплаты через Gate

  1. Пользователь выбирает веб-сервис, лицевой счёт в котором он хочет пополнить, и затем вводит свои учётные данные в системе мерчанта.
  2. От физического терминала на заданный URL ECommPay передаётся запрос на проверку существования лицевого счёта пользователя.
  3. Выполняется обработка запроса.
  4. От платёжной платформы к веб-сервису передаётся запрос на проверку существования лицевого счёта пользователя.
  5. На стороне веб-сервиса проводится обработка запроса.
  6. От веб-сервиса к платёжной платформе передаётся ответ на запрос.
  7. От платёжной платформы к сервису «Cash-in СНГ» передаются результаты проверки данных лицевого счёта пользователя.
  8. Пользователю отображается форма оплаты «Cash-in СНГ».
  9. Пользователь вносит наличные для пополнения лицевого счёта.
  10. На стороне сервиса «Cash-in СНГ» выполняется обработка платежа.
  11. От сервиса «Cash-in СНГ» к платёжной платформе направляется уведомление о результате оплаты.
  12. От платёжной платформы к веб-сервису передаётся запрос на получение идентификатора платежа на стороне веб-сервиса.
  13. На стороне веб-сервиса проводится обработка запроса.
  14. От веб-сервиса к платёжной платформе передаётся информация об идентификаторе платежа.
  15. На стороне платёжной платформы создаётся операция.
  16. От платёжной платформы к веб-сервису направляется оповещение о результате оплаты.
  17. Пользователь получает информацию о результате проведения оплаты на экране физического терминала.

Информация о формате запросов и параметрах инициирования оплат через Gate при работе с методом «Cash-in СНГ», а также о формате оповещений о результатах оплат приведена далее.

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

Запрос verify на проверку существования лицевого счёта пользователя

  1. Запрос verify для проверки существования лицевого счёта пользователя отправляется методом POST на заданный URL веб-сервиса.
  2. Запрос содержит следующие обязательные параметры:
    • type — тип операции на стороне веб-сервиса, значение параметра всегда verify;
    • customer_id — идентификатор пользователя в системе мерчанта;
    • project_id — идентификатор проекта, полученный от ECommPay при интеграции;
    • signature — подпись запроса.

    Рис.: Пример запроса на проверку существования лицевого счёта пользователя

    {
       "type":"verify",
       "project_id":111,
       "customer_id":"ovleg@gmail.com",
       "signature":"lY0LTSAz85R7zGce5qfYGacOuYlHGWqkMcQlqmjlsDDZI2gVcE1q
                                  VeWANnkIR7mdOqRXJnL1kO0lUmkQ0YYLWRg=="
    }

Запрос check_deposit на получение идентификатора платежа

  1. Запрос check_deposit для получения идентификатора платежа на стороне веб-сервиса отправляется методом POST на заданный URL веб-сервиса.
  2. Запрос содержит следующие обязательные параметры:
    • type — тип операции на стороне веб-сервиса, значение параметра всегда check_deposit;
    • customer_id — идентификатор пользователя в системе мерчанта;
    • project_id — идентификатор проекта, полученный от ECommPay при интеграции;
    • amount — сумма платежа в минорных единицах;
    • currency — валюта платежа в формате ISO-4217 alpha-3;
    • payment_method — код терминальной сети. Допустимые значения:
      • allpay-kz для Allpay,
      • briogroup-uz для BRIO Group,
      • fenix-kz для Fenix,
      • indigo24-kz для Indigo24,
      • moneymovers-ge для Money Movers,
      • quickpay-kg для Quickpay,
      • w1-kz для Wallet One.
    • signature — подпись запроса.

    Рис.: Пример запроса на получение идентификатора платежа на стороне веб-сервиса

    {
       "type":"check_deposit",
       "project_id":111,
       "customer_id":"ovle8@mail.ru",
       "amount":10000,
       "currency":"USD",
       "payment_method":"briogroup-uz",
       "signature":"lY0LTSAzpR7zGce5qfYGacOuYlHGWqkMcQlqmjlsDDZI2gV
                         cE1qVeWANnkIR7mdOqRXJnL1kO0lUmkQ0YYLWRg=="
    }

Формат ответов

Ответ на запрос verify

Ответ на запрос verify должен быть отправлен синхронно и содержать следующие обязательные параметры:

  • code — код ответа на запрос (допустимые значения указаны в таблице Допустимые коды ответов);
  • currency — валюта платежа в формате ISO-4217 alpha-3.

Рис.: Пример ответа на запрос

{
   "code":0,
   "currency":"USD",
   "additional_customer_id": "HFVDW42345"
}
Ответ на запрос check_deposit

Ответ на запрос check_deposit должен быть отправлен синхронно и содержать следующие обязательные параметры:

  • code — код ответа на запрос (допустимые значения указаны в таблице Допустимые коды ответов);
  • payment_id — уникальный идентификатор платежа на стороне веб-сервиса.
Табл. 1. Допустимые коды ответов
Код Описание
0 Операция успешна
400 Ошибка подписи
404 Лицевой счёт пользователя не существует
500 Общая ошибка, причина должна быть описана в необязательном параметре errors.message

Рис.: Пример ответа на запрос

{
   "code":0,
   "payment_id":"test2345",
   "description":"test payment via terminal"
}

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

Для оповещений о результатах оплат с применением метода «Cash-in СНГ» используется стандартный формат, описание которого представлено в разделе Оповещения.

В параметре method объекта payment передаётся название терминальной сети с использованием которой была проведена оплата.

В следующем примере оповещение свидетельствует о том, что в рамках проекта 238 была успешно проведена оплата в размере 100,01 USD с использованием терминальной сети Brio Group.

Рис.: Пример оповещения о проведённой оплате

{
        "project_id": 238,
        "payment": {
            "id": "1556624104",
            "type": "purchase",
            "status": "success",
            "date": "2019-04-30T11:35:06+0000",
            "method": "Brio Group Uz Terminal",
            "sum": {
                "amount": 10001,
                "currency": "USD"
            },
            "description": ""
        },
        "account": {
            "number": "6552"
        },
        "operation": {
            "id": 36011000001676,
            "type": "sale",
            "status": "success",
            "date": "2019-04-30T11:35:06+0000",
            "created_date": "2019-04-30T11:35:05+0000",
            "request_id": "cea199572b36a148f0c20d105b0ee0abf737e06e512e8",
            "sum_initial": {
                "amount": 10001,
                "currency": "USD"
            },
            "sum_converted": {
                "amount": 10001,
                "currency": "USD"
            },
            "provider": {
                "id": 1217,
                "payment_id": "2019290410",
                "auth_code": ""
            },
            "code": "0",
            "message": "Success"
        },
        "signature": "jvqLGHIaGdHeF68GtTxAtVFCGzkLxOCFU1crar0RmQpLyDJRoHe
                                   2eGOdPuZKXXKcRJnqEKpNmhLTAtk/VEY8Yw=="
    }

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

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

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

Как и при работе с другими платёжными методами, которые предоставляет ECommPay, при использовании метода «Cash-in СНГ» доступны разные способы анализа информации о платежах и операциях с применением этого метода — как в отдельности, так и в совокупности с другими методами.

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

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

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

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