«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
- Пользователь на стороне веб-сервиса инициирует оплату.
- От веб-сервиса на заданный URL ECommPay передаётся запрос на проведение оплаты через Payment Page.
- Запрос на проведение оплаты поступает в платёжную платформу.
- Выполняется начальная обработка запроса, в рамках которой обеспечивается проверка наличия обязательных параметров и корректной подписи.
- Осуществляется генерация Payment Page согласно настройкам проекта и параметрам вызова.
- Пользователю отображается сгенерированная платёжная форма.
- Пользователь выбирает метод «QIWI Казахстан» и подтверждает готовность использовать этот метод (если метод был задан предварительно выбранным, то только подтверждает готовность).
- Пользователю отображается форма ввода номера мобильного телефона.
- Пользователь вводит номер телефона, к которому привязан электронный кошелёк «QIWI Казахстан».
- Запрос на проведение оплаты в сервисе «QIWI Казахстан» поступает в платёжную платформу.
- Выполняются дальнейшая обработка запроса и отправка запроса на выставление счёта в сервис «QIWI Казахстан».
- На стороне «QIWI Казахстан» выполняется обработка запроса на выставление счёта.
- От сервиса «QIWI Казахстан» к платёжной платформе передаются данные о счёте.
- Данные для перенаправления пользователя к форме оплаты «QIWI Казахстан» передаются к Payment Page.
- Пользователь перенаправляется к форме оплаты «QIWI Казахстан».
- Пользователь оплачивает выставленный счёт.
- Запрос о существовании аккаунта пользователя поступает в платёжную платформу.
- От платёжной платформы к сервису «QIWI Казахстан» поступают данные о существовании аккаунта.
- На стороне «QIWI Казахстан» выполняется обработка платежа.
- От сервиса «QIWI Казахстан» к платёжной платформе направляется уведомление о результате оплаты.
- От платёжной платформы к веб-сервису направляется оповещение о результате оплаты.
- От платёжной платформы к Payment Page направляется результат проведения оплаты.
- Результат оплаты отображается пользователю на Payment Page.
Информация о формате запросов и параметрах вызова Payment Page при работе с методом «QIWI Казахстан», а также о формате оповещений о результатах оплат приведена далее. Общая информация о работе с API — в разделе Описание Payment Page API.
Формат запросов
При формировании запросов на открытие платёжной формы с применением метода «QIWI Казахстан» необходимо учитывать следующее:
- Должен использоваться базовый минимум параметров — параметры, обязательные для любого платёжного метода:
- project_id — идентификатор проекта, полученный от ECommPay при интеграции;
- payment_id — идентификатор платежа, уникальный в рамках проекта;
- payment_amount — сумма платежа в минорных единицах валюты;
- payment_currency — валюта платежа в формате ISO-4217 alpha-3;
- customer_id — идентификатор пользователя уникальный в рамках проекта.
- Валютой платежа может быть только KZT.
- Для предварительного выбора метода «QIWI Казахстан» необходимо указывать код qiwi-kz в параметре force_payment_method.
- Дополнительно могут использоваться любые другие параметры из числа доступных для работы с Payment Page.
- После указания целевых параметров необходимо составлять подпись (подробнее — в разделе Использование подписи к данным).
Таким образом, корректный запрос на открытие платёжной формы с применением метода «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 Казахстан» со стороны веб-сервиса необходимо:
- Отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL ECommPay.
- Осуществить перенаправление пользователя к форме оплаты «QIWI Казахстан».
- Принять оповещение о результате оплаты.
Рис.: Проведение оплаты через Gate
- Пользователь на стороне веб-сервиса инициирует оплату методом «QIWI Казахстан».
- От веб-сервиса на заданный URL ECommPay передаётся запрос на проведение оплаты через Gate.
- Запрос на проведение оплаты поступает в платёжную платформу.
- Выполняется начальная обработка запроса, в рамках которой обеспечивается проверка наличия обязательных параметров и корректной подписи.
- От платёжной платформы к веб-сервису направляется ответ с информацией о получении запроса и его корректности.
- В платёжной платформе выполняются дальнейшая обработка запроса и отправка запроса на выставление счёта в сервис «QIWI Казахстан».
- На стороне «QIWI Казахстан» выполняется обработка запроса на выставление счёта.
- От сервиса «QIWI Казахстан» к платёжной платформе передаются данные о счёте.
- От платёжной платформы к веб-сервису направляется оповещение с данными для перенаправления пользователя к форме оплаты «QIWI Казахстан».
- Пользователь перенаправляется к форме оплаты «QIWI Казахстан».
- Пользователь оплачивает выставленный счёт.
- Запрос о существовании аккаунта пользователя поступает в платёжную платформу.
- От платёжной платформы к сервису «QIWI Казахстан» поступают данные о существовании аккаунта.
- На стороне «QIWI Казахстан» выполняется обработка платежа.
- От сервиса «QIWI Казахстан» к платёжной платформе направляется уведомление о результате оплаты.
- От платёжной платформы к веб-сервису направляется оповещение о результате оплаты.
- От веб-сервиса пользователю направляется результат оплаты.
Информация о формате запросов и параметрах инициирования оплат через Gate при работе с методом «QIWI Казахстан», а также о форматах данных для перенаправления пользователей и о формате оповещений о результатах оплат приведена далее. Общая информация о работе с API — в разделе Работа с API.
Формат запросов
При формировании запросов на оплату с применением метода «QIWI Казахстан» необходимо учитывать следующее:
- Должен использоваться запрос
/v2/payment/wallet/qiwi-kz/sale
, отправляемый методом POST. Этот запрос относится к группе запросов для платежей через электронные кошельки /v2/payment/wallet/{payment_method}/sale. - В запросе должны использоваться следующие объекты и параметры:
- 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 для перенаправления в случае отказа в проведении оплаты.
- general — объект, содержащий основные идентификационные сведения запроса:
- Валютой платежа может быть только KZT.
- Дополнительно могут использоваться все параметры, указанные в спецификации.
Таким образом, корректный запрос на оплату с применением метода «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 Казахстан» со стороны веб-сервиса необходимо:
- Обработать запрос на проверку существования лицевого счёта пользователя.
- Отправить ответ с информацией о существовании лицевого счёта пользователя.
- Обработать запрос на получение идентификатора платежа на стороне веб-сервиса.
- Отправить ответ с идентификатором платежа.
- Принять оповещение о результате оплаты.
Рис.: Проведение оплаты через Gate
- Пользователь выбирает веб-сервис, лицевой счёт в котором он хочет пополнить, и затем вводит свои учётные данные в системе мерчанта.
- От физического терминала на заданный URL ECommPay передаётся запрос на проверку существования лицевого счёта пользователя.
- Выполняется начальная обработка запроса, в рамках которой обеспечивается проверка наличия обязательных параметров и корректной подписи.
- От платёжной платформы к веб-сервису передаётся запрос на проверку существования лицевого счёта пользователя.
- На стороне веб-сервиса проводится обработка запроса.
- От веб-сервиса к платёжной платформе передаётся ответ на запрос.
- От платёжной платформе к сервису «QIWI Казахстан» передаются данные о лицевом счёте пользователя.
- Пользователю отображается форма оплаты «QIWI Казахстан».
- Пользователь вносит наличные для пополнения лицевого счёта.
- На стороне сервиса «QIWI Казахстан» выполняется обработка платежа.
- От сервиса «QIWI Казахстан» к платёжной платформе направляется уведомление о результате оплаты.
- От платёжной платформе к веб-сервису передаётся запрос на получение идентификатора платежа на стороне веб-сервиса.
- На стороне веб-сервиса проводится обработка запроса.
- От веб-сервиса к платёжной платформе передаётся информация об идентификаторе платежа.
- На стороне платёжной платформы создаётся операция.
- От платёжной платформы к веб-сервису направляется оповещение о результате оплаты.
- Пользователь получает информацию о результате проведения оплаты на экране физического терминала.
Информация о формате запросов и параметрах инициирования оплат через Gate при работе с методом «QIWI Казахстан» и о формате оповещений о результатах оплат приведена далее.
Формат запросов
При работе с запросами на проверку существования лицевого счёта пользователя необходимо учитывать следующее:
- Запрос
verify
для проверки существования лицевого счёта пользователя отправляется методом POST на заданный URL веб-сервиса. - Запрос содержит следующие обязательные параметры:
- type — тип операции на стороне веб-сервиса, значение параметра всегда
verify
; - customer_id — идентификатор пользователя в системе мерчанта;
- project_id — идентификатор проекта, полученный от ECommPay при интеграции;
- siganture — подпись запроса.
Рис.: Пример запроса на проверку существования лицевого счёта пользователя
{ "type":"verify", "project_id":111, "customer_id":"ov_ole8@mail.ru", "signature":"lY0LT8AzpR7zGce5qfYGacOuYlHGWqkMcQlqmjlsDDZI2gVcE1qVeWANnkIR7mdOqRXJnL1kO0lUmkQ0YYLWRg==" }
- type — тип операции на стороне веб-сервиса, значение параметра всегда
- Ответ на запрос
verify
должен быть отправлен синхронно и содержать следующие обязательные параметры:- code — код ответа на запрос;
- currency — валюта платежа в формате ISO-4217 alpha-3.
Табл. 1. Допустимые коды ответов Код Описание 0
Операция успешна 400
Ошибка подписи 404
Лицевой счёт пользователя не существует 500
Общая ошибка, причина должна быть описана в необязательном параметре message Рис.: Пример ответа на запрос
{ "code":0, "currency":"KZT", "additional_customer_id": "HFVDW42345" }
- Запрос
check_deposit
для получения идентификатора платежа на стороне веб-сервиса отправляется методом POST на заданный URL веб-сервиса. - Запрос содержит следующие обязательные параметры:
- 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==" }
- type — тип операции на стороне веб-сервиса, значение параметра всегда
- Ответ на запрос
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
- Пользователь на стороне веб-сервиса инициирует выплату через сервис «QIWI Казахстан».
- От веб-сервиса на заданный URL ECommPay передаётся запрос на проведение выплаты через Gate.
- Запрос на проведение выплаты поступает в платёжную платформу.
- Выполняется начальная обработка запроса, в рамках которой обеспечивается проверка наличия обязательных параметров и корректной подписи.
- От платёжной платформы к веб-сервису направляется ответ с информацией о получении запроса и его корректности.
- В платёжной платформе выполняются дальнейшая обработка запроса и его отправка в сервис «QIWI Казахстан».
- На стороне «QIWI Казахстан» выполняется обработка платежа.
- От сервиса «QIWI Казахстан» к платёжной платформе направляется уведомление о результате выплаты.
- От платёжной платформы к веб-сервису направляется оповещение о результате выплаты.
- От веб-сервиса пользователю направляется результат выплаты.
Информация о формате запросов и параметрах инициирования выплат с применением метода «QIWI Казахстан» через Gate, а также о формате оповещений о результатах выплат приведена далее. Общая информация о работе с API — в разделе Работа с API.
Формат запросов
При формировании запросов на выплату с применением метода «QIWI Казахстан» необходимо учитывать следующее:
- Должен использоваться запрос
/v2/payment/wallet/qiwi-kz/payout
, отправляемый методом POST. Этот запрос относится к группе запросов для проведения платежей с использованием электронных кошельков /v2/payment/wallet/{payment_method}/payout. - В запросе должны использоваться следующие объекты и параметры:
- general — объект, содержащий основные идентификационные сведения запроса:
- project_id — идентификатор проекта, полученный от ECommPay при интеграции;
- payment_id — идентификатор платежа, уникальный в рамках проекта;
- signature — подпись запроса, составленная после указания целевых параметров (подробнее — в разделе Использование подписи к данным);
- customer — объект, содержащий сведения о пользователе:
- id — идентификатор,
- ip_address — IP-адрес;
- account — объект, содержащий сведения о счёте пользователя:
- number — номер QIWI Кошелька;
- payment — объект, содержащий сведения о платеже:
- amount — сумма платежа в минорных единицах валюты,
- currency — валюта платежа в формате ISO-4217 alpha-3.
- general — объект, содержащий основные идентификационные сведения запроса:
- Валютой платежа может быть только KZT.
- Дополнительно могут использоваться все параметры, указанные в спецификации.
Таким образом, корректный запрос на выплату с применением метода «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.