Документация 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
Параметры: 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
- provider (str, int or
-
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