Документация qiwi_api

qiwi_api - модуль для взаимодействия с Qiwi API

Установка:

$ pip install --upgrade qiwi_api

Пример:

from qiwi_api import Qiwi

api = Qiwi('your_token_here')
print(api.balance(only_balance=True))

Qiwi_api

class qiwi_api.Qiwi(token)[исходный код]

Класс для работы с Qiwi API

Получить ключ

Подробнее об API

Параметры:token (str) – Ключ доступа к api
get_profile(auth_info=True, contract_info=True, user_info=True)[исходный код]

Получить информацию о профиле

Параметры:
  • auth_info (bool) – Информация об авторизации
  • contract_info (bool) – Информация о кошельке
  • user_info (bool) – Прочие данные
get_identification()[исходный код]

Данные идентификации

identification(birth_date, first_name, middle_name, last_name, passport, inn=None, snils=None, oms=None)[исходный код]

Упрощённая идентификация

Параметры:
  • birth_date (str) – Дата рождения в формате ГГГГ-ММ-ДД
  • first_name (str) – Имя
  • middle_name (str) – Отчество
  • last_name (str) – Фамилия
  • passport (str) – Серия и номер паспорта (цифры без пробела)
  • inn (str) – ИНН
  • snils (str) – СНИЛС
  • oms (str) – ОМС
history(rows=10, operation='ALL', sources=None, from_date=None, to_date=None, next_txn_date=None, next_txn_id=None)[исходный код]

Получить историю транзакций.

Ограничение - 100 запросов в минуту.

Параметры:
  • rows (int) – Число транзакций. Максимальное количество - 50
  • operation (str) – Тип операций, учитываемых при подсчете статистики. см. OPERATIONS
  • sources (list or str) – Источники платежа, учитываемые при подсчете статистики
  • from_date (str) – Начальная дата периода статистики. ГГГГ-ММ-ДД-<часовой пояс>. Указывается так: +0000(UTC), +0300(Москва) и т.д.
  • to_date (str) – Конечная дата периода статистики. ГГГГ-ММ-ДД-<часовой пояс>
  • next_txn_date (str) – Дата транзакции для отсчета от предыдущего списка. Используется только вместе с nextTxnId
  • next_txn_id (int) – Номер транзакции для отсчета от предыдущего списка. Используется только вместе с nextTxnDate
statistics(from_date, to_date, operation='ALL', sources=None)[исходный код]

Получить статистику транзакций

Параметры:
  • from_date (str) – Начальная дата периода статистики. ГГГГ-ММ-ДД-<часовой пояс>. Указывается так: +0000(UTC), +0300(Москва) и т.д.
  • to_date (str) – Конечная дата периода статистики. ГГГГ-ММ-ДД-<часовой пояс>
  • operation (list or str) – Тип операций, учитываемых при подсчете статистики см. OPERATIONS
  • sources (str) – Источники платежа, учитываемые при подсчете статистики
transaction_info(transaction_id)[исходный код]

Получить информацию о транзакции

Параметры:transaction_id (str or int) – Номер транзакции
get_receipt_email(transaction_id, email)[исходный код]

Отправка квитанции по транзакции transaction_id на email

Параметры:
  • transaction_id (str or int) – Номер транзакции
  • email (str) – Адрес почты для получения квитанции
balance(only_balance=False)[исходный код]

Получить баланс кошельков

Параметры:only_balance (bool) – если True, вернётся только название кошелька и его баланс
comission(provider)[исходный код]

Комиссионные условия провайдера

Параметры:provider (str, int or Providers) – id провайдера
fill_form(provider, recipient=None, amount=None, comment=None, blocked=None)[исходный код]

Автозаполнение платёжных форм

Параметры:
  • provider (str, int or Providers) – id провайдера
  • recipient (str) – Номер телефона/счета/карты пользователя
  • amount (int or float) – Сумма в рублях. Должна быть меньше 99 999 рублей
  • comment (str) – Комментарий. Только если provider == 99 (перевод на киви-кошелёк)
  • blocked (list or str) – Неактивные поля формы. См. BLOCKABLE_FIELDS
send_qiwi(recipient, amount, comment=None)[исходный код]

Перевод на кошелёк Киви

Параметры:
  • recipient (str) – Номер получателя в формате 71234567890
  • amount (int or float) – Сумма в рублях. Минимум 1 рубль
  • comment (str) – Комментарий
send_mobile(recipient, amount)[исходный код]

Оплата мобильной связи

Параметры:
  • recipient (str) – Номер телефона для пополнения в формате 71234567890
  • amount (int or float) – Сумма в рублях
method(method_name, payload=None, method='GET')[исходный код]

Вызов метода API

Параметры:
  • method_name (str) – Часть url после https://edge.qiwi.com/
  • payload (str or dict) – json параметры
  • method (str) – Метод запроса (get, post)
detect_operator(number)[исходный код]

Узнать id оператора

Параметры:number (str) – номер телефона в формате 71234567890

Enums

qiwi_api.enums.OPERATIONS = ['ALL', 'IN', 'OUT', 'QIWI_CARD']

Типы операций

qiwi_api.enums.SOURCES = ['QW_RUB', 'QW_USD', 'QW_EUR', 'CARD', 'MK']

Источники платежей

qiwi_api.enums.IDENTIFICATIONS = ['SIMPLE', 'VERIFIED', 'FULL']

Уровни идентифицации

qiwi_api.enums.STATUSES = ['WAITING', 'SUCCESS', 'ERROR']

Статусы платежей

qiwi_api.enums.BLOCKABLE_FIELDS = ['sum', 'account', 'comment']

Поля формы, которые можно сделать неактивными

class qiwi_api.Providers[исходный код]
Базовые классы: enum.IntEnum

An enumeration.

QIWI = 99

Киви

ALFABANK = 464

Альфа-Банк

TINKOFFBANK = 466

Тинькофф Банк

RSBANK = 815

Банк Русский Стандарт

PSBANK = 821

Промсвязьбанк

VISA_CIS = 1960

Visa СНГ

VISA_RUSSIA = 1963

Visa Россия

MASTERCARD_CIS = 21012

MasterCard СНГ

MASTERCARD_RUSSIA = 21013

MasterCard Россия

MIR = 31652

Мир

Exceptions

class qiwi_api.exceptions.ApiError[исходный код]
Базовые классы: Exception
class qiwi_api.exceptions.WrongToken[исходный код]
Базовые классы: qiwi_api.exceptions.ApiError
class qiwi_api.exceptions.PermissionError[исходный код]
Базовые классы: qiwi_api.exceptions.ApiError