Permalink
Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
77 lines (47 sloc) 5.7 KB
title search metatitle metadescription language_tabs toc_footers includes
Top-Up API QIWI Кошелька
true
Top-Up API QIWI Кошелька
Top-Up API QIWI Кошелька позволяет автоматизировать выплаты на QIWI Кошельки пользователей.
xml
XML
<a href='/'>На главную</a>
<a href='mailto:bss@qiwi.com'>Обратная связь</a>
topup-wallet/authorization_ru
topup-wallet/topup_ru
topup-wallet/topup-status_ru
topup-wallet/check-user_ru
topup-wallet/get-balance_ru
topup-wallet/errors_ru

Введение {#introduction}

Последнее обновление: 2017-11-15 | Редактировать на GitHub

API выплат на кошельки предназначено для платежных агентов КИВИ Банк (АО), позволяет зачислять деньги на кошельки пользователей (балансы учетных записей клиентов в системе QIWI Wallet).

Что позволяет протокол

  1. Переводить деньги клиентам сервиса QIWI Кошелек - pay.
  2. Проверять существование клиентов в сервисе QIWI Кошелек - check-user.
  3. Следить за балансом на агентском счете для выплат - ping.

Как это работает

  1. Пользователь передает вам сумму пополнения и номер QIWI Кошелька, который нужно пополнить.
  2. Вы отправляете запрос в Top-Up API QIWI Кошелька на пополнение этого кошелька.
  3. Вы проверяете текущий статус платежа. Платеж должен принять финальный статус.
  4. При успешном финальном статусе платежа средства автоматически перечисляются на баланс кошелька пользователя с вашего агентского счета.
  5. При неуспешном финальном статусе платежа вы возвращаете средства пользователю.

По вопросам интеграции и сотрудничества пишите на bss@qiwi.com.

Формат взаимодействия {#general}

Взаимодействие происходит посредством пересылки запросов и ответов на них системы QIWI Wallet. Запросы и ответы – XML-документы в кодировке UTF-8.

Запросы отправляются по протоколу HTTPS на URL:

https://api.qiwi.com/xml/topup.jsp

Тип HTTP-запроса - POST, XML-документ помещается в теле HTTP-запроса. Формат значений тегов и атрибутов XML.

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

Аутентификация запросов выполняется по идентификатору и паролю, выдаваемому при подключении к системе QIWI Wallet. Смена пароля выполняется через сотрудников КИВИ Банк (АО) или сотрудников уполномоченного представителя КИВИ Банк (АО). Также возможна аутентификация по цифровой подписи или по клиентскому сертификату.

Приведенные теги и атрибуты запросов/ответов обязательны для передачи в запросах и ответах (если в описании конкретного тега или атрибута не указано иное). Добавление дополнительных тегов или атрибутов в ответы или запросы не является нарушением протокола.

Единственным признаком, на основе которого вы можете принимать решение о успешности или неуспешности выполнения платежа на своей стороне, является статус транзакции в системе QIWI Wallet.

Каждому платежу (набору реквизитов: сумма, валюта, идентификатор клиента в системе QIWI Wallet, идентификатор сервиса) вы должны присваивать уникальный идентификатор.

Этапы процесса информационного взаимодействия при пополнении QIWI Кошелька отображены на диаграмме:

TopUp Sequence

Логическая последовательность операций при взаимодействии с системой QIWI Wallet должна соответствовать блок-схеме:

TopUp FlowChart