«QIWI Казахстан»

Обзор

«QIWI Казахстан» — платёжный метод для проведения платежей через физический терминал и с использованием электронного кошелька. Для работы с этим методом доступно проведение оплат через Payment Page и Gate, выплат — через Gate.

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

Тип платёжного метода
  • физический терминал
  • электронный кошелёк
Регионы использования KZ
Валюты платежей KZT
Конвертация валют –
Оплаты +
Выплаты +
Оплаты по сохранённым данным –
Полные возвраты –
Частичные возвраты –
Опротестования –
Особенности –
Организация и стоимость подключения По согласованию с курирующим менеджером ECommPay

Схема работы

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



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

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

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

** Базовое и предельное время определяются следующим образом:

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

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

Проведение оплат с использованием метода «QIWI Казахстан» выполняется с перенаправлением пользователей к сервису «QIWI Казахстан» для оплаты через электронный кошелёк или с обращениям пользователя к физическому терминалу «QIWI Казахстан», проведение выплат — с уведомлением пользователей через веб-сервис мерчанта.

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



Рис.: Оплата через Gate с использованием электронного кошелька



Рис.: Оплата через Gate с использованием физического терминала



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

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

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

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

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



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

  1. Пользователь на стороне веб-сервиса инициирует оплату.
  2. От веб-сервиса на заданный URL ECommPay передаётся запрос на проведение оплаты через Payment Page.
  3. Запрос на проведение оплаты поступает в платёжную платформу.
  4. Выполняется начальная обработка запроса, в рамках которой обеспечивается проверка наличия обязательных параметров и корректной подписи.
  5. Осуществляется генерация Payment Page согласно настройкам проекта и параметрам вызова.
  6. Пользователю отображается сгенерированная платёжная форма.
  7. Пользователь выбирает метод «QIWI Казахстан» и подтверждает готовность использовать этот метод (если метод был задан предварительно выбранным, то только подтверждает готовность).
  8. Пользователю отображается форма ввода номера мобильного телефона.
  9. Пользователь вводит номер телефона, к которому привязан электронный кошелёк «QIWI Казахстан».
  10. Запрос на проведение оплаты в сервисе «QIWI Казахстан» поступает в платёжную платформу.
  11. Выполняются дальнейшая обработка запроса и отправка запроса на выставление счёта в сервис «QIWI Казахстан».
  12. На стороне «QIWI Казахстан» выполняется обработка запроса на выставление счёта.
  13. От сервиса «QIWI Казахстан» к платёжной платформе передаются данные о счёте.
  14. Данные для перенаправления пользователя к форме оплаты «QIWI Казахстан» передаются к Payment Page.
  15. Пользователь перенаправляется к форме оплаты «QIWI Казахстан».
  16. Пользователь оплачивает выставленный счёт.
  17. Запрос о существовании аккаунта пользователя поступает в платёжную платформу.
  18. От платёжной платформы к сервису «QIWI Казахстан» поступают данные о существовании аккаунта.
  19. На стороне «QIWI Казахстан» выполняется обработка платежа.
  20. От сервиса «QIWI Казахстан» к платёжной платформе направляется уведомление о результате оплаты.
  21. От платёжной платформы к веб-сервису направляется оповещение о результате оплаты.
  22. От платёжной платформы к Payment Page направляется результат проведения оплаты.
  23. Результат оплаты отображается пользователю на Payment Page.

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

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

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

  1. Должен использоваться базовый минимум параметров — параметры, обязательные для любого платёжного метода:
    • project_id — идентификатор проекта, полученный от ECommPay при интеграции;
    • payment_id — идентификатор платежа, уникальный в рамках проекта;
    • payment_amount — сумма платежа в минорных единицах валюты;
    • payment_currency — валюта платежа в формате ISO-4217 alpha-3;
    • customer_id — идентификатор пользователя уникальный в рамках проекта.
  2. Валютой платежа может быть только KZT.
  3. Для предварительного выбора метода «QIWI Казахстан» необходимо указывать код qiwi-kz в параметре force_payment_method.
  4. Дополнительно могут использоваться любые другие параметры из числа доступных для работы с Payment Page.
  5. После указания целевых параметров необходимо составлять подпись (подробнее — в разделе Использование подписи к данным).

Таким образом, корректный запрос на открытие платёжной формы с применением метода «QIWI Казахстан» должен содержать идентификаторы проекта, пользователя и платежа, а также валюту и сумму платежа с использованием казахстанского тенге:

EPayWidget.run(
    { payment_id: 'X03936', 
      payment_amount: 10000, 
      payment_currency: 'KZT', 
      project_id: 10, 
      customer_id: 'customer1',
      signature: "U52k9dKHAVNU0FYldJrxh4yo+52Kt8KU+Y1...=="
    }
)

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

Для оповещений о результатах оплат с применением метода «QIWI Казахстан» используется стандартный формат, описание которого представлено в разделе Оповещения.

В данном случае оповещение свидетельствует о том, что в рамках проекта 238 была успешно проведена оплата в размере 10,00 KZT.

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

 {
        "project_id": 238,
        "payment": {
            "id": "test1234567890",
            "type": "purchase",
            "status": "success",
            "date": "2019-04-17T10:04:47+0000",
            "method": "Qiwi Kz Wallet",
            "sum": {
                "amount": 1000,
                "currency": "KZT"
            },
            "description": "some_string"
        },
        "account": {
            "number": "123458788"
        },
        "customer": {
            "id": "12346"
        },
        "operation": {
            "id": 32832000001400,
            "type": "sale",
            "status": "success",
            "date": "2019-04-17T10:04:47+0000",
            "created_date": "2019-04-17T10:00:04+0000",
            "request_id": "1e4d438777e6b50c502c81473db33e3aef20d2cc-2d1e186a74b95410c320258ac79d17e7c9b3a159",
            "sum_initial": {
                "amount": 1000,
                "currency": "KZT"
            },
            "sum_converted": {
                "amount": 1000,
                "currency": "KZT"
            },
            "provider": {
                "id": 1196,
                "payment_id": "999990000001a11",
                "date": "2019-04-16T19:15:00+0000",
                "auth_code": ""
            },
            "code": "0",
            "message": "Success"
        },
        "signature": "SF5Kyqz4geKQdUvdWxkDu7KhOqW7a3swdACgWNdjVCL3xwqKTl
                                 0JE45Rpk1g7UIWTL5fiYoa/P7qNRSciwIbcg=="
    }
}

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

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

Оплаты через Gate с использованием электронного кошелька

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

Для оплаты через Gate с использованием метода «QIWI Казахстан» со стороны веб-сервиса необходимо:

  1. Отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL ECommPay.
  2. Осуществить перенаправление пользователя к форме оплаты «QIWI Казахстан».
  3. Принять оповещение о результате оплаты.


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

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

Информация о формате запросов и параметрах инициирования оплат через Gate при работе с методом «QIWI Казахстан», а также о форматах данных для перенаправления пользователей и о формате оповещений о результатах оплат приведена далее. Общая информация о работе с API — в разделе Работа с API.

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

При формировании запросов на оплату с применением метода «QIWI Казахстан» необходимо учитывать следующее:

  1. Должен использоваться запрос /v2/payment/wallet/qiwi-kz/sale, отправляемый методом POST. Этот запрос относится к группе запросов для платежей через электронные кошельки /v2/payment/wallet/{payment_method}/sale.
  2. В запросе должны использоваться следующие объекты и параметры:
    • general — объект, содержащий основные идентификационные сведения запроса:
      • project_id — идентификатор проекта, полученный от ECommPay при интеграции;
      • payment_id — идентификатор платежа, уникальный в рамках проекта;
      • signature — подпись запроса, составленная после указания целевых параметров (подробнее — в разделе Использование подписи к данным);
    • customer — объект, содержащий сведения о пользователе:
      • id — идентификатор, уникальный в рамках проекта,
      • ip_address — IP-адрес,
      • iframe — признак режима отображения страницы, встроенной в веб-страницу (iframe);
    • account — объект, содержащий сведения о счёте пользователя:
      • number — номер QIWI Кошелька;
    • payment — объект, содержащий сведения о платеже:
      • amount — сумма платежа в минорных единицах валюты,
      • currency — валюта платежа в формате ISO-4217 alpha-3;
    • return_url — объект, содержащий сведения для перенаправления пользователя в зависимости от результата проведения оплаты:
      • success — URL для перенаправления в случае проведения оплаты,
      • decline — URL для перенаправления в случае отказа в проведении оплаты.
  3. Валютой платежа может быть только KZT.
  4. Дополнительно могут использоваться все параметры, указанные в спецификации.

Таким образом, корректный запрос на оплату с применением метода «QIWI Казахстан» должен содержать идентификаторы проекта и платежа, номер QIWI Кошелька и IP-адрес пользователя, признак iframe, валюту и сумму платежа с использованием казахстанского тенге, а также URL для перенаправления пользователя:

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

{
  "general": {
    "project_id": 238,
    "payment_id": "test1234567890",
    "signature": "wsPEeK7EczGLgnIDqQ3qbrU54uGKjqSIfd56KHsKGnHcCS
                     Zs0N5wSbxK+AD5XbckdDEytGpOkC95GLTNVkpCWQ=="
  },
  "customer": {
    "id": "12346",
    "ip_address": "1.2.3.4"
  },
  "account": {
    "number": "123458788"
  },
  "payment": {
    "amount": 1000,
    "currency": "KZT",
    "description": "some_string"
  },
  "return_url": {
    "success": "http:success.url",
    "decline": "http:decline.url"
  },
  "interface_type": {
    "id": 3,
    "user": "test@gmail.com"
  },
  "redirect_qrcode_sent": true
}

Форматы данных для перенаправления пользователей

Для перенаправления пользователя от веб-сервиса на сайт банка необходимо принять оповещение от платёжной платформы, содержащее ссылку для перенаправления в параметре redirect_data.url и данные для отправки в теле запроса redirect_data.body, и использовать эти параметры при открытии HTML-страницы сервиса «QIWI Казахстан» методом, указанным в redirect_data.method.

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

Для оповещений о результатах оплат с применением метода «QIWI Казахстан» используется стандартный формат, описание которого представлено в разделе Оповещения.

В данном случае оповещение свидетельствует о том, что в рамках проекта 238 была успешно проведена оплата в размере 10,00 KZT.

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

 {
        "project_id": 238,
        "payment": {
            "id": "test1234567890",
            "type": "purchase",
            "status": "success",
            "date": "2019-04-17T10:04:47+0000",
            "method": "Qiwi Kz Wallet",
            "sum": {
                "amount": 1000,
                "currency": "KZT"
            },
            "description": "some_string"
        },
        "account": {
            "number": "123458788"
        },
        "customer": {
            "id": "12346"
        },
        "operation": {
            "id": 32832000001400,
            "type": "sale",
            "status": "success",
            "date": "2019-04-17T10:04:47+0000",
            "created_date": "2019-04-17T10:00:04+0000",
            "request_id": "1e4d438777e6b50c502c81473db33e3aef20d2cc-2d1e186a74b95410c320258ac79d17e7c9b3a159",
            "sum_initial": {
                "amount": 1000,
                "currency": "KZT"
            },
            "sum_converted": {
                "amount": 1000,
                "currency": "KZT"
            },
            "provider": {
                "id": 1196,
                "payment_id": "999990000001a11",
                "date": "2019-04-16T19:15:00+0000",
                "auth_code": ""
            },
            "code": "0",
            "message": "Success"
        },
        "signature": "SF5Kyqz4geKQdUvdWxkDu7KhOqW7a3swdACgWNdjVCL3xwqKTl
                                 0JE45Rpk1g7UIWTL5fiYoa/P7qNRSciwIbcg=="
    }
}

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

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

Оплаты через Gate с использованием физического терминала

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

Для оплаты через Gate с использованием платёжного метода «QIWI Казахстан» со стороны веб-сервиса необходимо:

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


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

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

Информация о формате запросов и параметрах инициирования оплат через Gate при работе с методом «QIWI Казахстан» и о формате оповещений о результатах оплат приведена далее.

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

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

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

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

    {
   "type":"verify",
   "project_id":111,
   "customer_id":"ov_ole8@mail.ru",
   "signature":"lY0LT8AzpR7zGce5qfYGacOuYlHGWqkMcQlqmjlsDDZI2gVcE1qVeWANnkIR7mdOqRXJnL1kO0lUmkQ0YYLWRg=="
}
  3. Ответ на запрос verify должен быть отправлен синхронно и содержать следующие обязательные параметры:
    • code — код ответа на запрос;
    • currency — валюта платежа в формате ISO-4217 alpha-3.
    Табл. 1. Допустимые коды ответов
    Код Описание
    0 Операция успешна
    400 Ошибка подписи
    404 Лицевой счёт пользователя не существует
    500 Общая ошибка, причина должна быть описана в необязательном параметре message

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

    {
   "code":0,
   "currency":"KZT",
   "additional_customer_id": "HFVDW42345"
}
При работе с запросами на получение идентификатора платежа необходимо учитывать следующее:
  1. Запрос check_deposit для получения идентификатора платежа на стороне веб-сервиса отправляется методом POST на заданный URL веб-сервиса.
  2. Запрос содержит следующие обязательные параметры:
    • type — тип операции на стороне веб-сервиса, значение параметра всегда check_deposit;
    • customer_id — идентификатор пользователя в системе мерчанта;
    • project_id — идентификатор проекта, полученный от ECommPay при интеграции;
    • amount — сумма платежа в минорных единицах;
    • currency — валюта платежа в формате ISO-4217 alpha-3;
    • payment_method — название платёжного метода, значение параметра всегда qiwi-kz;
    • siganture — подпись запроса.

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

    {
   "type":"check_deposit",
   "project_id":111,
   "customer_id":"ov_ole8@mail.ru",
   "amount":10000,
   "currency":"KZT",
   "payment_method":"qiwi-kz",
   "signature":"lY0LTSAzpR7zGce5qfYGacOuYlHGWqkMcQlqmjlsDDZI2gVcE1qVeWANnkIR7mdOqRXJnL1kO0lUmkQ0YYLWRg=="
}
  3. Ответ на запрос check_deposit должен быть отправлен синхронно и содержать следующие обязательные параметры:
    • code — код ответа на запрос;
    • payment_id — уникальный идентификатор платежа на стороне веб-сервиса.
    Табл. 2. Допустимые коды ответов
    Код Описание
    0 Операция успешна
    400 Ошибка подписи
    404 Лицевой счёт пользователя не существует
    500 Общая ошибка, причина должна быть описана в необязательном параметре message

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

    {
   "code":0,
   "payment_id":"Asfdsaf3252345"
}

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

Для оповещений о результатах оплат с применением метода «QIWI Казахстан» используется стандартный формат, описание которого представлено в разделе Оповещения.

В данном случае оповещение свидетельствует о том, что в рамках проекта 238 проведена успешная оплата в размере 20,00 KZT.

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

{
        "project_id": 238,
        "payment": {
            "id": "1554967098",
            "type": "purchase",
            "status": "success",
            "date": "2019-04-11T07:18:20+0000",
            "method": "Qiwi Kz Terminal",
            "sum": {
                "amount": 2000,
                "currency": "KZT"
            },
            "description": ""
        },
        "account": {
            "number": "user9876"
        },
        "operation": {
            "id": 36425000001206,
            "type": "sale",
            "status": "success",
            "date": "2019-04-11T07:18:20+0000",
            "created_date": "2019-04-11T07:18:19+0000",
            "request_id": "25f3114242a16ab1e010ebab4fe816b9d105ff33b90281",
            "sum_initial": {
                "amount": 2000,
                "currency": "KZT"
            },
            "sum_converted": {
                "amount": 2000,
                "currency": "KZT"
            },
            "provider": {
                "id": 1197,
                "payment_id": "999990000001a1",
                "auth_code": ""
            },
            "code": "0",
            "message": "Success"
        },
        "signature": "HRcDJN84ghAJL2hPW9yUbVMm7SRPewQJuH+mz4gcipXc8sI
                         dToQunzSUEiy7w5vA3+MVIO8xHSNsQB5qCCm5kXA=="
    }
}

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

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

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

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

Для выплаты через Gate с использованием метода «QIWI Казахстан» со стороны веб-сервиса необходимо отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL ECommPay и принять оповещение о результате выплаты. Полная схема проведения выплаты представлена далее.



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

  1. Пользователь на стороне веб-сервиса инициирует выплату через сервис «QIWI Казахстан».
  2. От веб-сервиса на заданный URL ECommPay передаётся запрос на проведение выплаты через Gate.
  3. Запрос на проведение выплаты поступает в платёжную платформу.
  4. Выполняется начальная обработка запроса, в рамках которой обеспечивается проверка наличия обязательных параметров и корректной подписи.
  5. От платёжной платформы к веб-сервису направляется ответ с информацией о получении запроса и его корректности.
  6. В платёжной платформе выполняются дальнейшая обработка запроса и его отправка в сервис «QIWI Казахстан».
  7. На стороне «QIWI Казахстан» выполняется обработка платежа.
  8. От сервиса «QIWI Казахстан» к платёжной платформе направляется уведомление о результате выплаты.
  9. От платёжной платформы к веб-сервису направляется оповещение о результате выплаты.
  10. От веб-сервиса пользователю направляется результат выплаты.

Информация о формате запросов и параметрах инициирования выплат с применением метода «QIWI Казахстан» через Gate, а также о формате оповещений о результатах выплат приведена далее. Общая информация о работе с API — в разделе Работа с API.

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

При формировании запросов на выплату с применением метода «QIWI Казахстан» необходимо учитывать следующее:

  1. Должен использоваться запрос /v2/payment/wallet/qiwi-kz/payout, отправляемый методом POST. Этот запрос относится к группе запросов для проведения платежей с использованием электронных кошельков /v2/payment/wallet/{payment_method}/payout.
  2. В запросе должны использоваться следующие объекты и параметры:
    • general — объект, содержащий основные идентификационные сведения запроса:
      • project_id — идентификатор проекта, полученный от ECommPay при интеграции;
      • payment_id — идентификатор платежа, уникальный в рамках проекта;
      • signature — подпись запроса, составленная после указания целевых параметров (подробнее — в разделе Использование подписи к данным);
    • customer — объект, содержащий сведения о пользователе:
      • id — идентификатор,
      • ip_address — IP-адрес;
    • account — объект, содержащий сведения о счёте пользователя:
      • number — номер QIWI Кошелька;
    • payment — объект, содержащий сведения о платеже:
      • amount — сумма платежа в минорных единицах валюты,
      • currency — валюта платежа в формате ISO-4217 alpha-3.
  3. Валютой платежа может быть только KZT.
  4. Дополнительно могут использоваться все параметры, указанные в спецификации.

Таким образом, корректный запрос на выплату с применением метода «QIWI Казахстан» должен содержать идентификаторы проекта, пользователя и платежа, номер QIWI Кошелька (для зачисления средств) и IP-адрес пользователя, валюту и сумму платежа с использованием казахстанского тенге:

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

{
  "general": {
    "project_id": 35,
    "payment_id": "test_123",
    "signature": "kUi2x9dKHAVNU0FY"
  },
  "customer": {
    "ip_address": "185.123.193.224",
    "id":"12345"
  },
  "account": {
    "number": "9182221133"
  },
  "payment": {
    "amount": 100,
    "currency": "KZT",
  }
}

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

Для оповещений о результатах выплат с применением метода «QIWI Казахстан» используется стандартный формат, описание которого представлено в разделе Оповещения.

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

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

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

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

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

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

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

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