Qiwi кошелек

Содержание
  1. Обзор
  2. Общая информация
  3. Схема взаимодействия
  4. Операции поддержка
  5. Сценарии обработки
  6. Покупки с помощью страницы оплаты
  7. Общая информация
  8. Формат запроса
  9. Формат обратного вызова
  10. Связанные темы
  11. Покупки с помощью Gate
  12. Общая информация
  13. Формат запроса
  14. Форматы данных перенаправления клиентов
  15. Формат обратного вызова
  16. Связанные темы
  17. Возврат средств с помощью шлюза
  18. Общая информация
  19. Формат запроса
  20. Формат обратного вызова
  21. Выплаты с использованием гейта
  22. Общая информация
  23. Формат запроса
  24. Формат обратного вызова
  25. Связанные темы
  26. Тестирование
  27. Общая информация
  28. Тестовые статусы платежей
  29. Покупки с помощью страницы оплаты
  30. Покупки с помощью Gate
  31. Возврат с использованием Gate
  32. Выплаты с помощью Gate
  33. Анализ результаты платежей
  34. QIWI Push
  35. Обзор
  36. Общая информация
  37. Схема взаимодействия
  38. Операционная поддержка
  39. Сценарии обработки
  40. Пополнение счета
  41. Общая информация
  42. Формат запроса
  43. Формат обратного вызова
  44. Анализ результатов платежей

Обзор

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

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

Тип метода оплаты Платежи с использованием электронные кошельки
Страны и регионы Все страны
Валюта платежа EUR, RUB, USD
Конвертация валюты
Покупки +
Выплаты +
Платежи с сохраненными учетными данными
Полный возврат +
Частичный возврат
Возвратные платежи
Примечания Если на странице оплаты выбран предварительно выбранный способ оплаты и в запросе отправляется параметр customer_phone, клиент перенаправляется на свой QIWI Страница учетной записи кошелька немедленно
Плата за подключение и доступ Обратитесь к менеджеру своего основного аккаунта ECommPay

Схема взаимодействия

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


Операции поддержка

Интерфейсы Суммы Times **
Страница оплаты Мобильные SDK Плагины CMS Gate Dashboard (старая Dashboard) минимум максимальный базовый порог
Покупки + + + * * * *
Выплаты + * * * *
Полный возврат + * * * *

* Обратитесь к менеджеру своего ключевого аккаунта ECommPay.

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

Сценарии обработки

При использовании метода QIWI Wallet для покупок, возвратов и выплат используются разные процедуры обработки. Чтобы выполнить операцию покупки, вам необходимо перенаправить клиента в службу QIWI Wallet, а для инициирования выплаты или возврата вам необходимо уведомить клиента через веб-службу продавца.

Рисунок: Покупка с использованием платежа Схема процедуры страницы

Рисунок: Покупка с использованием процедуры Gate диаграмма

Рисунок: Возврат с использованием схемы процедуры шлюза

Рисунок: Выплата с использованием схемы процедуры гейта

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

Покупки с помощью страницы оплаты

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

В методах QIWI Wallet при обработке покупки Используя страницу оплаты, веб-сервис продавца должен отправить запрос со всеми необходимыми параметрами и подписью на URL-адрес ECommPay и получить обратный вызов с результатом платежа от платежной платформы. При открытии страницы оплаты вы можете открыть страницу оплаты с помощью одного из выбранных методов QIWI Wallet. Дополнительные сведения о предварительном выборе способов оплаты см. В разделе «Предварительный выбор метода оплаты». Полная последовательность и особенности процесса покупки представлены ниже.

Рисунок. Последовательность покупок в методе страницы оплаты:

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

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

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

Есть несколько вещей при использовании метода QIWI Wallet необходимо учитывать:

  1. Вы должны указать значения для базового минимума параметров. Ниже перечислены параметры, которые являются обязательными для любого способа оплаты:
    • project_id — идентификатор проекта, полученный из ECommPay.
    • payment_id — идентификатор платежа, уникальный в рамках проекта
    • payment_currency — валюта платежа в формате ISO-4217 alpha-3.
    • payment_amount — сумма платежа в второстепенных единицах.
    • customer_id — идентификатор клиента, уникальный в пределах проект
  2. Валюта платежа может быть одной из следующих: EUR, RUB, USD.
  3. Если вам нужно иметь форма оплаты отображается с выбранным методом QIWI Wallet, установите для параметра force_payment_method значение qiwi . Для прямого перенаправления в учетную запись клиента также передайте параметр customer_phone в запросе на открытие страницы оплаты.
  4. При необходимости вы также можете добавить любые другие дополнительные параметры, поддерживаемые страницей оплаты.
  5. После того, как вы укажете все необходимые параметры, вы должны создать подпись для запроса. Инструкции по подписанию платежного запроса см. В разделе «Создание и проверка подписи».

Таким образом, правильный платежный запрос в методе QIWI Wallet должен включать идентификаторы проекта, клиента и платежа, валюта и сумма платежа в соответствующей валюте, как показано в следующем примере:

 EPayWidget.run ({project_id: 0, payment_id: 'X03936', customer_id: 'user123',  сумма_платы: 100, валюта_платежа: 'USD', подпись: "kUi2x9dKHAVNU0FYldJrxh4yo + 52Kt8KU + Y1Y4HASCQ9vySO /RLCvhtT4DqtVUkDJrOcZzUCwX6R /ekpZh, доступные параметры > QWX6R /ekpZh>  см. Параметры вызова платежной страницы.  

Формат обратного вызова

Метод QIWI Wallet использует стандартный формат обратных вызовов для доставки результатов покупки. Для получения дополнительной информации см. Обратные вызовы.

Ниже приведен пример обратного вызова с информацией об успешной 50.00 EUR покупке на счете 79503239672 из проекта 481 .

Рисунок: Пример успешного обратного вызова покупки

 {"project_id": 481, "payment": {"id": "1207007", "type":  "покупка", "статус": "успех", "дата": "2019-09-10T09: 54: 45 + 0000", "метод": "qiwi", "сумма": {"сумма": 5000, "  currency ":" EUR "}," description ":" "}," account ": {" number ":" 79503239672 "}," operation ": {" id ": 44932000002349," type ":" sale ","  status ":" успех "," дата ":" 2019-09-10T09: 54: 45 + 0000 "," created_date ":" 2019-09-10T09: 54: 14 + 0000 "," request_id ":" 66e7615d7658a741a09858e2c82868eac3e571dc78fcf164a50 "  , "sum_initial": {"amount": 5000, "currency": "EUR"}, "sum_converted": {"amount": 361650, "currency": "RUB"}, "provider": {"id":  416, «payment_id»: «44932000002349», «auth_code»: «»}, «code»: «0», «message»: «Success»}, «подпись»: «liDM865/azvMYLt3PHGQ06sJ1636giqSMtMmF6cybmWupmHrzbgdIBMWupmHzbxgdIBMWupmHzfsgdIBMWupmHzfxdIB  } 

Ниже приведен пример обратного вызова для покупки, отклоненной из-за недостатка средств на счете клиента. не.

Рисунок: Пример обратного вызова отклоненной покупки

 {"project_id": 477, "payment": {"id": "2496584", "type":  "покупка", "статус": "отказ", "дата": "2019-09-10T08: 43: 10 + 0000", "метод": "qiwi", "сумма": {"сумма": 15000, "  currency ":" EUR "}," description ":" "}," account ": {" number ":" 79500232022 "}," operation ": {" id ": 46483000002283," type ":" sale ","  status ":" отклонение "," date ":" 2019-09-10T08: 43: 10 + 0000 "," created_date ":" 2019-09-09T07: 10: 08 + 0000 "," request_id ":" 9f4fa47f818c7ba46fc1815580c464878772ace205da8d36b7 "  , "sum_initial": {"amount": 15000, "currency": "EUR"}, "sum_converted": {"amount": 1084950, "currency": "RUB"}, "provider": {"id":  416, «payment_id»: «46483000002283», «result_code»: «0», «result_message»: «expired», «auth_code»: «»}, «code»: «20105», «message»: «Недостаточно средств на  счет клиента "," описание ":" Операция была отклонена из-за недостатка средств на счете клиента "}," подпись ":" no/72vXyh8gWwUOUtBC2yAAgJ49CUkwlaz25k0b  tVRc7 + 0xLOluAICLpw 4hPyZcnoOYbNY4uzSKhJHNjgRGIDQ == "}} 

Связанные темы

Следующие темы могут быть полезны при осуществлении платежей с использованием платежа Страница:

  • Принципы взаимодействия
  • Генерация и проверка подписи
  • Модели и статусы платежей
  • Информация о выполняемых операциях

Покупки с помощью Gate

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

В методах QIWI Wallet при обработке покупки с помощью Gate веб-сервис продавца должен выполнять следующие действия:

  1. Отправьте запрос со всеми необходимыми параметрами и подписью на URL-адрес ECommPay.
  2. Выполните перенаправление клиента в службу QIWI Wallet.
  3. Получите обратный вызов с результатом платежа от платежной платформы.

На следующей диаграмме представлена ​​подробная картина обработки платежа процедура.

Рисунок: Покупка с помощью Gate

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

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

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

Есть несколько вещей, которые вы должны учитывать при использовании запросов на покупку в методе QIWI Wallet:

  1. Вы отправляете запросы на покупку, отправляя запрос/v2/payment/qiwi/sale с помощью HTTP-метода POST.
  2. В любом запросе должны быть указаны следующие объекты и параметры:
    • general — общая информация о покупке:
      • project_id — идентификатор проекта
      • payment_id — уникальный идентификатор покупки.
      • signature — подпись создана после того, как вы укажете все необходимые параметры. Для получения дополнительной информации о создании подписи см. Создание и проверка подписи.
    • customer — информация о клиенте:
      • id — идентификатор клиент в проекте продавца
      • ip_address — IP-адрес клиента
    • account — информация об учетной записи клиента:
      • номер — номер телефона, связанный с учетной записью QIWI Wallet, должен быть указан с использованием кода страны и без знаков препинания или специальных символов, например 79031234567 , вы можете узнать больше о формате в FAQ раздел
    • платеж — информация о покупке:
      • сумма — сумма покупки.
      • валюта — валюта выплаты в формате ISO-4217 alpha-3.
  3. Валютой покупки может быть только одна из следующих валют: евро, рубль, доллар США.
  4. При необходимости вы также можете добавить любые другие дополнительные параметры, которые поддерживает Gate.
  5. После того, как вы укажете все необходимые параметры, вы должны создать подпись для запроса. Инструкции по подписанию платежного запроса см. В разделе «Создание и проверка подписи».

Таким образом, правильный платежный запрос в методе QIWI Wallet должен включать идентификаторы проекта и платежа, идентификатор клиента и IP-адрес, номер кошелька QIWI, валюта и сумма покупки, как показано в следующем примере:

Рисунок: Пример запроса на покупку

 {"general"  : {"id_проекта": 35, "payment_id": "Платеж 12", "подпись": "2tlMuYxLW9Yu6RETr8pdCfmi0UPE8euD + 2AbrQgJguu0BQjXWH6naCA9Ts6o4EV Pjlyfboq", "ipad.1", "ipad.1", "idlfboq" + 9ajkAteg5, "id", "id", "идентификатор клиента" + 9ajkAteg5  ":" 123 "}," account ": {" number ":" 79039999999 "}," payment ": {" amount ": 10000," currency ":" EUR "}} 

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

Чтобы перенаправить клиента с веб-службы на сайт QIWI Wallet, вы должны получить обратный вызов от платежной платформы, содержащий URL для перенаправления в параметре redirect_data.url и данных для отправки в запросите тело в параметре redirect_data.body и используйте эти параметры при открытии HTML-страницы с помощью метода, указанного в параметре redirect_data.method.

Ниже приведен фрагмент обратного вызова, содержащий токен для покупки.

  "redirect_data": {"body": {"shop": "12345", "transaction": 34700000003226, "iframe": "false", "successUrl":  "test.com/success", "failUrl": "test.com", "target": "iframe"}, "method": "GET", "url": "https://bill.qiwi.com/ order/external/main.action "}  

В результате вы должны получить следующую ссылку для перенаправления https://bill.qiwi.com/order/external/main. action? shop = 12345 & transaction = 34723000002456 & iframe = false & successUrl = http://test.com/success&failUrl=http://test.com/fail & target = iframe.

Формат обратного вызова

Метод QIWI Wallet использует стандартный формат обратных вызовов для доставки результатов покупки. Для получения дополнительной информации см. Обратные вызовы.

Ниже приведен пример обратного вызова с информацией об успешной 50.00 EUR покупке на счете 79503239672 сделано в проекте 481 .

Рисунок: Пример успешного обратного вызова покупки

 {"project_id": 481, "payment": {"id": "1207007", "type":  "покупка", "статус": "успех", "дата": "2019-09-10T09: 54: 45 + 0000", "метод": "qiwi", "сумма": {"сумма": 5000, "  currency ":" EUR "}," description ":" "}," account ": {" number ":" 79503239672 "}," operation ": {" id ": 44932000002349," type ":" sale ","  status ":" успех "," дата ":" 2019-09-10T09: 54: 45 + 0000 "," created_date ":" 2019-09-10T09: 54: 14 + 0000 "," request_id ":" 66e7615d7658a741a09858e2c82868eac3e571dc78fcf164a50 "  , "sum_initial": {"amount": 5000, "currency": "EUR"}, "sum_converted": {"amount": 361650, "currency": "RUB"}, "provider": {"id":  416, «payment_id»: «44932000002349», «auth_code»: «»}, «code»: «0», «message»: «Success»}, «подпись»: «liDM865/azvMYLt3PHGQ06sJ1636giqSMtMmF6cybmWupmHrzbgdIBMWupmHzbxgdIBMWupmHzfsgdIBMWupmHzfxdIB  } 

Ниже приведен пример обратного вызова для покупки, отклоненной из-за недостатка средств на счете клиента. не.

Рисунок: Пример обратного вызова отклоненной покупки

 {"project_id": 477, "payment": {"id": "2496584", "type":  "покупка", "статус": "отказ", "дата": "2019-09-10T08: 43: 10 + 0000", "метод": "qiwi", "сумма": {"сумма": 15000, "  currency ":" EUR "}," description ":" "}," account ": {" number ":" 79500232022 "}," operation ": {" id ": 46483000002283," type ":" sale ","  status ":" отклонение "," date ":" 2019-09-10T08: 43: 10 + 0000 "," created_date ":" 2019-09-09T07: 10: 08 + 0000 "," request_id ":" 9f4fa47f818c7ba46fc1815580c464878772ace205da8d36b7 "  , "sum_initial": {"amount": 15000, "currency": "EUR"}, "sum_converted": {"amount": 1084950, "currency": "RUB"}, "provider": {"id":  416, «payment_id»: «46483000002283», «result_code»: «0», «result_message»: «expired», «auth_code»: «»}, «code»: «20105», «message»: «Недостаточно средств на  счет клиента "," описание ":" Операция была отклонена из-за недостатка средств на счете клиента "}," подпись ":" no/72vXyh8gWwUOUtBC2yAAgJ49CUkwlaz25k0b  tVRc7 + 0xLOluAICLpw 4hPyZcnoOYbNY4uzSKhJHNjgRGIDQ == "}} 

Связанные темы

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

  • Модели взаимодействия
  • Создание и проверка подписи
  • Модели и статусы платежей
  • Информация о выполняемых операциях

Возврат средств с помощью шлюза

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

QIWI Wallet поддерживает полную обработку возвратов. В методе QIWI Wallet любой возврат осуществляется по обычной процедуре, которая является общей для Gate: веб-сервис продавца отправляет запрос со всеми необходимыми параметрами и подписью на URL-адрес ECommPay, Gate принимает запрос и перенаправляет на платежную платформу для дальнейшей обработки. Полная последовательность процесса выплаты представлена ​​ниже.

Рисунок. Последовательность возврата с помощью шлюза

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

В следующих разделах более подробно обсуждается формат запроса и параметры шлюза для использования в способе оплаты QIWI Wallet и предоставить информацию о формате обратных вызовов с результатами возврата.

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

При использовании запросов возврата в методе QIWI Wallet необходимо учитывать несколько моментов:

  1. Вы отправляете запросы на выплату, отправляя запрос/v2/payment/qiwi/возмещение, используя HTTP-метод POST.
  2. В любом запросе должны быть указаны следующие объекты и параметры:
    • general — общая информация о возврате:
      • project_id — идентификатор проекта
      • payment_id — уникальный идентификатор возврата.
      • signature — подпись создается после того, как вы укажете все необходимые параметры. Для получения дополнительной информации о создании подписи см. Создание и проверка подписи.
    • Платеж — информация о возврате:
      • description — комментарий к возврату. .
  3. При необходимости вы также можете добавить любые другие дополнительные параметры, которые поддерживает Gate.

Таким образом, правильный запрос на возврат средств в методе QIWI Wallet должен включать идентификаторы проекта и платежа, подпись и описание выплаты, как показано в следующем примере:

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

 {"общий": {"project_id": 35, "payment_id": "Платеж 12", "подпись": "2tlMuYxLW9Yu6RETr8pdCfmi0UPE8euD + 2AbrQgJguu0BQjXWH6naCEV5Tjlj6k4q =" payment_id "+  ": {" description ":" Refund "}} 

Формат обратного вызова

Метод QIWI Wallet использует стандартный формат для обратные вызовы для доставки результатов возврата. Для получения дополнительной информации см. Обратные вызовы.

Ниже приведен пример обратного вызова с информацией об успешном возмещении 9,88 долларов США для учетной записи 79165354204 клиента 1 в проекте 135 .

Рисунок: Пример успешного обратного вызова возврата

 {"project_id": 135, "payment": {"type": "покупка", "sum":  {"amount": 0, "currency": "USD"}, "status": "refunded", "method": "qiwi", "id": "ECT_TEST_1566292942896", "date": "2019-08-26T10  : 52: 04 + 0000 "," description ":" ECT_TEST_1566292942896 "}," customer ": {" id ":" 1 "}," account ": {" number ":" 79165354204 "}," operation ": {  «id»: 47003000001425, «type»: «возврат», «status»: «успех», «date»: «2019-08-26T10: 52: 04 + 0000», «created_date»: «2019-08-26T10  : 52: 02 + 0000 "," request_id ":" b6f322b36fec4a35264c652bacd73695a2e970a9287faee7cf "," sum_initial ": {" amount ": 988," currency ":" USD "}," sum_converted ": {" amount ": 65025," currency "  : "RUB"}, "provider": {"id": 416, "payment_id": "5jxuu8dut", "auth_code": ""}, "code": "0", "message": "Success"},  "подпись": "ls/fOKQSg4YT/FcheW5X + HV1VE/ZH/fgTHDvGTeZy5s97U2YFSL8EqVHVc6P4 GT5hubvKybMqdyYzDvwaObYzA =="}} 

Пример обратного вызова отклонено из-за того, что учетная запись клиента больше не доступна.

Рисунок: Пример отклоненного обратного вызова возврата

 {"project_id": 460, "payment": {"id": "Demo_zqw1", "type":  "покупка", "статус": "успех", "дата": "2019-03-02T09: 33: 42 + 0000", "метод": "qiwi", "сумма": {"сумма": 988, "  currency ":" USD "}," description ":" Test "}," account ": {" number ":" 9088889977 "}," customer ": {" id ":" Demo "}," operation ": {  «id»: 26740000000119, «type»: «возврат», «status»: «отказ», «date»: «2019-03-02T09: 41: 08 + 0000», «created_date»: «2019-03-02T09  : 41: 07 + 0000 "," request_id ":" 724a9bffdd63f5e61e73d78f517d85a51075b589fee38002 "," sum_initial ": {" amount ": 988," currency ":" USD "}," sum_converted ": {" amount ": 65025," currency "  : "RUB"}, "provider": {"id": 416, "payment_id": ""}, "code": "20106", "message": "Аккаунт клиента больше не доступен"}, "signature"  : "hE0T4t2cONjWo5XsXDnO8eZqPVwvnYldS2bfrweP0JxXIOTMWwZBmFMiI3IDvX FQKxACF9MtawyxEG1EZfc4rw =="}} 

полезно при осуществлении платежей через Gate:

  • Модели взаимодействия
  • Генерация и проверка подписи
  • Модели и статусы платежей
  • Информация об операциях, выполняемых

Выплаты с использованием гейта

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

Для выполнения выплаты через метод QIWI Wallet веб-сервис продавца отправляет запрос со всеми необходимыми параметрами и подписью на URL-адрес ECommPay и получает обратный вызов с результатом платежа. Полная последовательность процесса выплаты представлена ​​ниже.

Рисунок: Выплата с использованием шлюза

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

В следующих разделах более подробно обсуждается формат запроса и шлюз. параметры для использования в способе оплаты QIWI Wallet и предоставляют информацию о формате обратных вызовов с результатами выплат.

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

При использовании запросов на выплату в методе QIWI Wallet необходимо учитывать несколько моментов:

  1. Вы отправляете запросы на выплату, отправляя запрос/v2/payment/qiwi/payout, используя HTTP-метод POST.
  2. В любом запросе должны быть указаны следующие объекты и параметры:
    • general — общая информация о выплатах:
      • project_id — идентификатор проекта
      • payment_id — уникальный идентификатор выплаты
      • signature — подпись создается после того, как вы укажете все необходимые параметры. Для получения дополнительной информации о создании подписи см. Создание и проверка подписи.
    • customer — информация о клиенте:
      • id — идентификатор
      • ip_address — IP-адрес клиента.
    • account — информация об учетной записи клиента:
      • number — номер телефона, связанный с учетная запись QIWI Wallet должна быть указана с использованием кода страны, без знаков препинания и специальных символов, например 79031234567 , вы можете узнать больше о формате в разделе часто задаваемых вопросов
    • платеж — информация о выплате:
      • сумма — сумма выплаты;
      • валюта — валюта выплаты в стандарте ISO-4217 alpha-3. формат.
  3. Валютой покупки может быть только одна из следующих валют: евро, рубли, доллары США ..
  4. При необходимости вы также можете добавить любые другие дополнительные параметры, которые поддерживает Gate.

Таким образом, правильный платежный запрос в методе QIWI Wallet должен включать идентификаторы проекта и платежа, подпись , custom r идентификатор и IP-адрес, номер счета (для зачисления), валюта и сумма выплаты, как показано в следующем примере:

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

 {"общий": {"project_id": 35, "payment_id": "Платеж 12", "подпись": "2tlMuYxLW9Yu6RETr8pdCfmi0UPE8euD + 2AbrQgJguu0BQjXWH6n aCA9Ts6o4EVPjlyfteg", "id": id "9" = "клиент" = "9"  "" ip_address ":" 1.1.1.1 "}," payment ": {" amount ": 10000," currency ":" EUR "," description ":" Тестовая выплата "}," account ": {" number ":  "79039999999"}} 

Формат обратного вызова

Метод QIWI Wallet использует стандартный формат обратных вызовов для доставки результатов выплат. Для получения дополнительной информации см. Обратные вызовы.

Ниже приведен пример обратного вызова с информацией об успешной выплате 50,00 евро на iy280590 @ gmail.com клиент в проекте 1483 .

Рисунок: Пример успешного обратного вызова выплаты

 {"project_id": 1483, "payment": {"id": "852af08d-1ff0-46a4-af4b  -c4f3e9664d5b "," тип ":" выплата "," статус ":" успех "," дата ":" 2019-09-12T10: 23: 43 + 0000 "," метод ":" qiwi "," сумма ":  {"amount": 5000, "currency": "EUR"}, "description": ""}, "account": {"number": "79610818551"}, "customer": {"id": "iy280590 @  gmail.com "}," операция ": {" идентификатор ": 46266000002521," тип ":" выплата "," статус ":" успех "," дата ":" 2019-09-12T10: 23: 43 + 0000 "  , "created_date": "2019-09-12T10: 23: 30 + 0000", "request_id": "0cc015ea0cfaf822ad8f0d0bf4ebf5aa02659d23940db61fd718", "sum_initial": {"amount": 5000, "currency": "EUR"}  : {"amount": 361650, "currency": "RUB"}, "provider": {"id": 416, "payment_id": "16401320435", "date": "2019-09-12T13: 23: 32  +0000 "," auth_code ":" "}," code ":" 0 "," message ":" Success "}," signature ":" AYjholAnDB4f0 + GnlaVnzXweILICE/f + mJxR73 + fbbcFv + wYC8IPFoWEaEgE8T McQi7CohS  == "}} 

Ниже приводится пример обратного вызова для выплаты, отклоненной из-за того, что учетная запись клиента больше не доступна.

Рисунок: Пример обратного вызова для отклоненной выплаты

 {"project_id"  : 1483, «выплата»: {«id»: «852af08d-1ff0-46a4-af4b-c4f3e9664d5b», «type»: «выплата», «status»: «отказ», «date»: «2019-09-12T10  : 23: 43 + 0000 "," method ":" qiwi "," sum ": {" amount ": 5000," currency ":" EUR "}," description ":" "}," account ": {"  number ":" 79610818551 "}," customer ": {" id ":" siy280590 @ gmail. com "}," operation ": {" id ": 46266000002521," type ":" payout "," status ":" cancel "," date ":" 2019-09-12T10: 23: 43 + 0000 ","  created_date ":" 2019-09-12T10: 23: 30 + 0000 "," request_id ":" 0cc015ea0cfaf822ad8f0d0bf4ebf5aa02659d23940db61fd718 "," sum_initial ": {" amount ": 5000," currency ":" EUR_converted}, "sum_converted",  "amount": 361650, "currency": "RUB"}, "provider": {"id": 416, "payment_id": "16401320435", "date": "2019-09-12T13: 23: 32 + 0000  "," auth_code ":" "}," code ":" 20106 "," message ":" Учетная запись клиента больше не доступна "}," signature ":" AYjholAnDB4f0 + GnlaVnzXweILICE/f + mJxR73 + fbbcFv + wYC8IPFoWEaEgE8TMQih +  y + Mgw == "}} 

Связанные темы

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

  • Модели взаимодействия
  • Создание и проверка подписи
  • Модели и статусы платежей
  • Информация о выполняемых операциях

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

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

Для метода QIWI Wallet тестирование покупок с использованием Оплаты Доступны Page и Gate, возврат средств и выплаты с помощью Gate.

Тестирование может быть выполнено в рамках тестового проекта, чтобы включить или отключить доступность тестирования, обратитесь в службу технической поддержки ECommPay через support @ ecommpay. com.

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


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

При тестировании покупок окончательный статус платежа определяется суммой, указанной в запрос:

  • отклонить статус с суммой 40000 или 40400
  • Успешно статус с любой другой суммой

При тестировании возвратов окончательный статус платежа определяется суммой указанный в запросе:

  • отклонить статус с 50000 или 50500 amount
  • Success статус с любой другой суммой

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

  • отклонить статус с 40000 или 40400 amount
  • success статус с любой другой суммой

Покупки с помощью страницы оплаты

Перфорировать При пробной покупке с помощью страницы оплаты выполните следующие действия:

  1. Отправьте правильный тестовый запрос для открытия страницы оплаты в платежную платформу.
  2. Если в запросе не был указан метод qiwi — выберите метод на странице эмулятора.
  3. Укажите случайный номер телефона в поле ввода данных (это достаточно, чтобы указать хотя бы одну цифру для тестирования).
  4. Нажмите кнопку «Успешно» или «Отклонить» (в зависимости от суммы, указанной в запросе).
  5. Примите обратный вызов с помощью информация о результате платежа.

Полная информация о процессе покупки с использованием QIWI Wallet через страницу оплаты представлена ​​в разделе Покупки с помощью страницы оплаты.

Покупки с помощью Gate

Чтобы выполнить тестовую покупку с помощью Gate, выполните следующие действия:

  1. Отправьте правильный тестовый запрос на покупку на платежную платформу.
  2. Примите обратный вызов с данными перенаправления.
  3. Перейдите к полученному URL и нажмите кнопку «Успешно» или «Отклонить» (в зависимости от суммы, указанной в запросе).
  4. Примите обратный вызов с информацией о результате платежа.

Полная информация о процессе покупки с использованием QIWI Wallet через Gate представлена ​​в разделе Покупки с помощью Gate.

Возврат с использованием Gate

Чтобы выполнить тестовый возврат с помощью Gate, отправьте правильный тестовый запрос на возврат ранее выполненной тестовой покупки в платежную платформу и примите обратный вызов с информацией о результате платежа.

Тестовый возврат средств возможен только в течение суток после первой покупки. Полная информация о процессе возврата с использованием QIWI Wallet через Gate представлена ​​в разделе «Возврат через Gate»..

Выплаты с помощью Gate

Чтобы выполнить тестовую выплату с помощью Gate, отправьте правильный тестовый запрос на платежную платформу и принять обратный звонок с информацией о результате платежа. Полная информация о процессе выплаты с использованием QIWI Wallet через Gate представлена ​​в разделе Выплаты через Gate.

Анализ результаты платежей

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

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

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

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

Если у вас есть дополнительные вопросы относительно анализа данных о платежах, обратитесь в службу технической поддержки ECommPay.



QIWI Push

Обзор

QIWI Push — это способ оплаты, позволяющий обрабатывать платежи с помощью электронного кошелька QIWI. Обработка платежей с использованием этого метода поддерживает пополнение счетов клиентов в веб-сервисе продавца через сервис QIWI Push. При этом пополнение счета клиента считается покупкой (тип операции продажа ) в рамках платежной платформы..

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

Тип метода оплаты Платежи через электронный кошелек
Страны и регионы RU
Валюты платежей RUB
Конвертация валюты
Покупки +
Выплаты
Платежи с сохраненными учетными данными
Полный возврат
Частичный возврат
Возвратные платежи
Особые соображения
Получение доступа к способ оплаты и плата за доступ обратитесь к вашему менеджеру по работе с ключевыми клиентами ECommPay

Схема взаимодействия

Обработка платежей с использованием метода оплаты QIWI Push re требует технических средств QIWI Push, платежной платформы ECommPay, а также веб-службы продавца.


Операционная поддержка

Обработка платежей с использованием метода оплаты QIWI Push поддерживает пополнение личных счетов клиентов. Пороговое время обработки платежа составляет 1 день (пороговое время — это максимально возможное время между моментом инициирования платежа в платежной платформе до момента, когда продавец получит обратный вызов с результатом платежа). Платеж автоматически отклоняется, если время его ожидания превышает пороговое время. Для индивидуальной настройки порогового времени обратитесь в службу технической поддержки ECommPay.

Сценарии обработки

В методе QIWI Push клиент пополнение счета осуществляется через службу QIWI Push.

Рисунок: Пополнение счета


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

Пополнение счета

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

В Метод QIWI Push, при пополнении счета клиента веб-сервис продавца должен выполнить следующие действия:

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

На следующей диаграмме представлена ​​подробная картина процедуры обработки платежа.

Рисунок: Кредитование учетной записи

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

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

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

При использовании запросов на проверку существования учетной записи в методе QIWI Push необходимо учитывать несколько моментов:

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

    Рисунок: Пример запроса на проверку существования учетной записи

     {"type": "verify", "project_id": 111, "customer_id": "customer@example.com", "signature":  "lY0LT8AzpRqfYGacOuY ... lHG7mdOqRXJnL1kO0lUmkQ0YYLWRg == "} 
  3. Ответ на запрос verify должен быть отправлен синхронно и содержать следующие обязательные параметры:
    • code — код ответа
    • currency — валюта в формате ISO-4217 alpha-3
    Таблица 1. Допустимые коды ответов
    Код Описание
    0 Успешная операция
    400 Подпись недействительна
    404 Аккаунт не существует
    500 Общая ошибка. Причину необходимо указать в параметре errors.message

    Рисунок: Пример ответа

     {"code": 0, "currency": "RUB"} 

Есть несколько вещей, которые вы должны учитывать при использовании запросов для идентификатора платежа на стороне веб-службы:

  1. Запрос check_deposit для идентификатора платежа отправляется с использованием HTTP-метода POST в указанную веб-службу URL.
  2. Запрос содержит следующие обязательные параметры:
    • type — тип операции на стороне веб-сервиса, значение всегда check_deposit
    • customer_id — идентификатор клиента на стороне веб-сервиса.
    • project_id — идентификатор проекта, полученный от ECommPay.
    • amount — сумма покупки в второстепенных единицах
    • currency — валюта в формате ISO-4217 alpha-3
    • payment_method — название метода оплаты, значение всегда terminal/qiwi -ru
    • подпись — подпись, созданная после того, как вы укажете все необходимые параметры (для получения дополнительной информации о создании подписи см. Создание и проверка подписи).

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

     {"type": "check_deposit", "project_id": 111, "c  ustomer_id ":" customer8@example.com "," amount ": 10000," currency ":" RUB "," payment_method ":" terminal/qiwi-ru "," подпись ":" lY0LTSAzpR7zGce5qfYG ... R7mdOqRXJnL1kO0lUmkQ0YY  } 
  3. Ответ на запрос check_deposit должен быть отправлен синхронно и содержать следующие обязательные параметры:
    • код — код ответа
    • payment_id — уникальный идентификатор платежа в рамках проекта
    Таблица 2. Допустимые коды ответов
    Code Описание
    0 Успешная операция
    400 Подпись недействительна
    404 Аккаунт не существует
    500 Общая ошибка. Причину необходимо указать в параметре errors.message

    Рисунок: Пример ответа

     {"code": 0, "payment_id": "445", "description": "test payment"} 

Формат обратного вызова

Метод QIWI Push использует стандартный формат обратных вызовов для доставки результатов пополнения счета. Для получения дополнительной информации см. Обратные вызовы.

Ниже приводится пример обратного вызова с информацией об успешном зачислении на счет 20,00 руб. , сделанном в 238 проект.

Рисунок: Пример успешного пополнения счета

 {"project_id": 238, "payment": {"id": "21538362", "type": "  покупка »,« статус »:« успех »,« дата »:« 2020-04-24T11: 53: 19 + 0000 »,« метод »:« qiwi-ru »,« сумма »: {« сумма »: 2000,  "currency": "RUB"}, "is_new_attempts_available": false, "plays_timeout": 0, "description": ""}, "account": {"number": "123456"}, "customer_data": {"ip_address  ":" 1.2.3.4 "}," fee ": {" amount ": 1," currency ":" RUB "}," merchant_account_id ": 6389," operation ": {" id ": 1000000001," type ":  «продажа», «статус»: «успех», «дата»: «2020-04-24T11: 53: 19 + 0000», «created_date»: «2020-04-24T11: 53: 12 + 0000», «request_id»  ":" a5821969a8538aaef75 ... c1ff3d0d8e9805b-00000002 "," sum_initial ": {" amount ": 2000," currency ":" RUB "}," sum_converted ": {" amount ": 2000," currency ":" RUB "  }, "code": "0", "message": "Success", "provider": {"id": 6389, "payment_id": "471623", "auth_code": ""}}, "signature":  "mcDPZRhkuYCm + 8iiWdOO ... 6uk8xn0nT6GaEnLiMy1L77tA =="} 

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

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

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

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

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

Если у вас есть дополнительные вопросы относительно анализа данных о платежах, обратитесь в службу технической поддержки ECommPay.

Оцените статью
logicle.ru
Добавить комментарий