Skip to content
Permalink
master
Switch branches/tags
Go to file
 
 
Cannot retrieve contributors at this time
title search metatitle metadescription category language_tabs toc_footers includes
API QIWI Кошелька
true
API QIWI Кошелька
API QIWI Кошелька позволяет автоматизировать выполнение платежей и получение отчетов о платежах, информации о счёте, идентификации.
apiqiwiwallet
http
Запрос/ответ
shell
cURL
php
PHP
python
Python
<a href='/ru/qiwi-wallet-api-release-notes/index.html'>Список изменений</a>
<a href='/'>На главную</a>
<a href='mailto:api_help@qiwi.com'>Обратная связь</a>
<a href='/sandbox/index.html'>Попробовать API</a>
qiwi-wallet-personal/profile_ru
qiwi-wallet-personal/payment_history_ru
qiwi-wallet-personal/balance_ru
qiwi-wallet-personal/master_ru
qiwi-wallet-personal/payment_ru
qiwi-wallet-personal/webhook_ru
qiwi-wallet-personal/error_ru

*[Токен]: Символьная строка для аутентификации пользователя в API по стандарту OAuth 2.0 RFC 6749, RFC 6750. *[токен]: Символьная строка для аутентификации пользователя в API по стандарту OAuth 2.0 RFC 6749, RFC 6750. *[API]: Application Programming Interface - набор готовых методов, предоставляемых приложением (системой) для использования во внешних программных продуктах. *[JSON]: JavaScript Object Notation - текстовый формат обмена данными, основанный на JavaScript.

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

Последнее обновление: 2020-07-28 | Предложить свои правки на GitHub

API QIWI Кошелька позволяет автоматизировать получение информации о вашем счёте в сервисе QIWI Кошелек и проводить операции с его помощью.

Методы API доступны после регистрации пользователя в сервисе QIWI Кошелек.

Авторизация запросов {#auth_param}

  • Авторизация

Параметр Описание Тип
Bearer token Токен для доступа к вашему QIWI кошельку по API. Действие токена заканчивается через 180 дней после выпуска. Одновременно может действовать только один токен. String

Доступ к API {#auth_api}

Основной URL-адрес для вызова методов API (если не указано иное):

https://edge.qiwi.com

Для успешного вызова методов API необходимы:

  • Корректные значения HTTP-заголовков Accept и Content-Type в запросе. API QIWI Кошелька поддерживает только один MIME-тип: application/json. Любое другое значение приведет к ошибке формата данных.
  • URL, составленный согласно требованиям к нужному запросу.
  • OAuth-токен, выданный вам для доступа к вашему QIWI кошельку. Для некоторых запросов его не потребуется.

Получение OAuth-токена {#auth_data}

API QIWI Кошелька использует открытый протокол OAuth 2.0. Согласно протоколу, пользователь авторизуется или регистрируется на сайте https://qiwi.com и запрашивает токен OAuth 2.0 Bearer с правом выполнения определённых действий. Выпуск токена подтверждается одноразовым кодом из СМС.

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

Для выпуска токена выполните следующие шаги:

  1. Откройте в браузере страницу https://qiwi.com/api. Для этого потребуется авторизоваться или зарегистрироваться в сервисе QIWI Кошелек. После этого нажмите Выпустить новый токен.

    Token Issue

  2. Во всплывающем окне выберите разрешения на операции с токеном и нажмите Продолжить:

    Token Scopes

  3. Подтвердите согласие на выпуск токена и нажмите Продолжить.

    Token Scopes

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

    Token Accept

  5. Скопируйте строку токена и сохраните в безопасном месте. Используйте токен для запросов к API QIWI Кошелька.

    Token

Токен действует в течение 180 дней с момента выпуска. Вы можете заблокировать токен, не дожидаясь окончания срока его действия. Для этого удалите доступ к вашему кошельку приложению QIWI API на этой странице.

Пример вызова API {#auth_ex}

user@server:~$ curl "адрес сервера" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer jMyN22DQxMjM6NDUzRmRnZDQ0Mw11212e"

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

  • В результате авторизации на сайте QIWI Кошелек и выпуска токена получен токен, представляющий собой строку:

U1QtOTkwMTAyLWNud3FpdWhmbzg3M

  • Токен добавляется в заголовок Authorization: Bearer

  • Итоговый заголовок, добавляемый в каждый запрос к API QIWI Кошелька:

Authorization: Bearer U1QtOTkwMTAyLWNud3FpdWhmbzg3M