Wallet¶

class pyqiwi.Wallet(token, number=None, contract_info=True, auth_info=True, user_info=True)[исходный код]¶

Visa QIWI Кошелек

Параметры:

token (str) – Ключ Qiwi API пользователя
number (Optional[str]) – Номер для указанного кошелька По умолчанию - None Если не указан, статистика и история работать не будет
contract_info (Optional[bool]) – Логический признак выгрузки данных о кошельке пользователя По умолчанию - True
auth_info (Optional[bool]) – Логический признак выгрузки настроек авторизации пользователя По умолчанию - True
user_info (Optional[bool]) – Логический признак выгрузки прочих пользовательских данных По умолчанию - True

accounts¶: iterable of Account – Все доступные методы оплаты для кошелька

profile¶: Profile – Профиль пользователя

balance(currency)[исходный код]¶

Баланс Visa QIWI Кошелька

Параметры:	currency (int) – ID валюты в `number-3 ISO-4217` Например, `643` для российского рубля
Результат:	Баланс кошелька
Тип результата:	float

commission(pid, recipient, amount)[исходный код]¶

Расчет комиссии для платежа

Параметры:	pid (str) – Идентификатор провайдера recipient (str) – Номер телефона (с международным префиксом) или номер карты/счета получателя В зависимости от провайдера amount (float/int) – Сумма платежа Положительное число, округленное до 2 знаков после десятичной точки. При большем числе знаков значение будет округлено до копеек в меньшую сторону.
Результат:	Комиссия для платежа
Тип результата:	`OnlineCommission`

history(rows=20, operation=None, start_date=None, end_date=None, sources=None)[исходный код]¶

История платежей

Предупреждение

Максимальная интенсивность запросов истории платежей - не более 100 запросов в минуту с одного IP-адреса. При превышении доступ к API блокируется на 5 минут.

Параметры:

rows (Optional[int]) – Число платежей в ответе, для разбивки отчета на части. От 1 до 50, по умолчанию 20.
operation (Optional[str]) – Тип операций в отчете, для отбора Варианты: ALL, IN, OUT, QIWI_CARD По умолчанию - ALL
start_date (Optional[datetime.datetime]) – Начальная дата поиска платежей
end_date (Optional[datetime.datetime]) – Конечная дата поиска платежей
sources (Optional[list]) – Источники платежа, для отбора Варианты: QW_RUB, QW_USD, QW_EUR, CARD, MK По умолчанию - все указанные

Примечание

Если вы хотите использовать startDate или endDate, вы должны указать оба параметра Максимальный допустимый интервал между startDate и endDate - 90 календарных дней.

Результат:	Транзакция
Тип результата:	`Transaction`

send(pid, recipient, amount, comment=None, fields=None)[исходный код]¶

Отправить платеж

Параметры:	pid (str) – Идентификатор провайдера recipient (str) – Номер телефона (с международным префиксом) или номер карты/счета получателя В зависимости от провайдера amount (float/int) – Сумма платежа Положительное число, округленное до 2 знаков после десятичной точки. При большем числе знаков значение будет округлено до копеек в меньшую сторону. comment (Optional[str]) – Комментарий к платежу fields (dict) – Ручное добавление dict’а в платежи. Требуется для специфичных платежей Например, перевод на счет в банке
Результат:	Платеж
Тип результата:	`Payment`

stat(start_date=None, end_date=None, operation=None, sources=None)[исходный код]¶

Статистика платежей

Примечание

Изначально берется статистика с начала месяца

Параметры:	operation (Optional[str]) – Тип операций в отчете, для отбора Варианты: ALL, IN, OUT, QIWI_CARD По умолчанию - ALL start_date (Optional[datetime.datetime]) – Начальная дата поиска платежей end_date (Optional[datetime.datetime]) – Конечная дата поиска платежей sources (Optional[list]) – Источники платежа, для отбора Варианты: QW_RUB, QW_USD, QW_EUR, CARD, MK По умолчанию - все указанные
Результат:	Статистика
Тип результата:	`Statistics`

Types¶

Account¶

class pyqiwi.types.Account(alias, fs_alias, title, has_balance, currency, _type, balance)[исходный код]¶

Счет из Visa QIWI Кошелька

alias¶: str – Псевдоним пользовательского баланса

fs_alias¶: str – Псевдоним банковского баланса

title¶: str – Название соответствующего счета кошелька

has_balance¶: str – Логический признак реального баланса в системе QIWI Кошелек (не привязанная карта, не счет мобильного телефона и т.д.)

currency¶: int – Код валюты баланса (number-3 ISO-4217). Возвращаются балансы в следующих валютах: 643 - российский рубль, 840 - американский доллар, 978 - евро

type¶: AccountType – Сведения о счете

balance¶: Optional[float] – Псевдоним пользовательского баланса

AccountType¶

class pyqiwi.types.AccountType(_id, title)[исходный код]¶

Сведения о счете из Visa QIWI Кошелька

id¶: str – Кодовое название счета

title¶: str – Название счета

Profile¶

class pyqiwi.types.Profile(auth_info, contract_info, user_info)[исходный код]¶

Профиль пользователя Visa QIWI Кошелька

auth_info¶: Optional[AuthInfo] – Настройки авторизации пользователя

contract_info¶: Optional[ContractInfo] – Информация о кошельке пользователя

user_info¶: Optional[UserInfo] – Прочие пользовательские данные

AuthInfo¶

class pyqiwi.types.AuthInfo(bound_email, ip, last_login_date, mobile_pin_info, pass_info, person_id, pin_info, registration_date)[исходный код]¶

Профиль пользователя Visa QIWI Кошелька

bound_email¶: str/None – E-mail, привязанный к кошельку. Если отсутствует, то None

ip¶: str – IP-адрес последней пользовательской сессии

last_login_date¶: str – Дата/время последней сессии в QIWI Кошельке

mobile_pin_info¶: MobilePinInfo – Данные о PIN-коде мобильного приложения QIWI Кошелька

pass_info¶: PassInfo – Данные о пароле к сайту qiwi.com

person_id¶: int – Номер кошелька пользователя

pin_info¶: PinInfo – Данные о PIN-коде к приложению QIWI Кошелька на QIWI терминалах

registration_date¶: datetime.datetime – Дата/время регистрации QIWI Кошелька пользователя (через сайт либо мобильное приложение, либо другим способом)

MobilePinInfo¶

class pyqiwi.types.MobilePinInfo(mobile_pin_used, last_mobile_pin_change, next_mobile_pin_change)[исходный код]¶

Данные о PIN-коде мобильного приложения QIWI Кошелька

mobile_pin_used¶: bool – Логический признак использования PIN-кода (фактически означает, что мобильное приложение используется)

last_mobile_pin_change¶: datetime.datetime – Дата/время последнего изменения PIN-кода мобильного приложения QIWI Кошелька

next_mobile_pin_change¶: datetime.datetime – Дата/время следующего (планового) изменения PIN-кода мобильного приложения QIWI Кошелька

PassInfo¶

class pyqiwi.types.PassInfo(last_pass_change, next_pass_change, password_used)[исходный код]¶

Данные о пароле к сайту qiwi.com

last_pass_change¶: str – Дата/время последнего изменения пароля сайта qiwi.com

next_pass_change¶: str – Дата/время следующего (планового) изменения пароля сайта qiwi.com

password_used¶: bool – Логический признак использования пароля (фактически означает, что пользователь заходит на сайт)

PinInfo¶

class pyqiwi.types.PinInfo(pin_used)[исходный код]¶

Данные о PIN-коде к приложению QIWI Кошелька на QIWI терминалах

pin_used¶: bool – Логический признак использования PIN-кода (фактически означает, что пользователь заходил в приложение)

ContractInfo¶

class pyqiwi.types.ContractInfo(blocked, contract_id, creation_date, features, identification_info)[исходный код]¶

Информация о кошельке пользователя

blocked¶: bool – Логический признак блокировки кошелька

contract_id¶: int – Номер кошелька пользователя

creation_date¶: datetime.datetime – Дата/время создания QIWI Кошелька пользователя (через сайт либо мобильное приложение, либо при первом пополнении, либо другим способом)

features¶: ??? – Служебная информация

identification_info¶: list[IdentificationInfo] – Данные об идентификации пользователя

IdentificationInfo¶

class pyqiwi.types.IdentificationInfo(bank_alias, identification_level)[исходный код]¶

Данные об идентификации пользователя

bank_alias¶: str – Акроним системы, в которой пользователь получил идентификацию: QIWI - QIWI Кошелек.

identification_level¶: str – Текущий уровень идентификации кошелька Возможные значения: ANONYMOUS - без идентификации SIMPLE, VERIFIED - упрощенная идентификация FULL - полная идентификация

UserInfo¶

class pyqiwi.types.UserInfo(default_pay_currency, default_pay_source, email, first_txn_id, language, operator, phone_hash, promo_enabled)[исходный код]¶

Прочие пользовательские данные

default_pay_currency¶: int – Код валюты баланса кошелька по умолчанию (number-3 ISO-4217)

default_pay_source¶: ??? – Служебная информация

email¶: str – E-mail пользователя

first_txn_id¶: int – Номер первой транзакции пользователя после регистрации

language¶: ??? – Служебная информация

operator¶: str – Название мобильного оператора номера пользователя

phone_hash¶: ??? – Служебная информация

promo_enabled¶: ??? – Служебная информация

Transaction¶

class pyqiwi.types.Transaction(txn_id, person_id, date, error_code, error, status, _type, status_text, trm_txn_id, account, _sum, commission, total, provider, source, comment, currency_rate, extras, cheque_ready, bank_document_available, bank_document_ready, repeat_payment_enabled, favorite_payment_enabled, regular_payment_enabled)[исходный код]¶

Транзакция

txn_id¶: int – ID транзакции в процессинге

person_id¶: int – Номер кошелька

date¶: datetime.datetime – Дата/время платежа, время московское

error_code¶: int/float – Код ошибки платежа

error¶: str – Описание ошибки

status¶: str – Статус платежа. Возможные значения: WAITING - платеж проводится, SUCCESS - успешный платеж, ERROR - ошибка платежа.

type¶: str – Тип платежа. Возможные значения: IN - пополнение, OUT - платеж, QIWI_CARD - платеж с карт QIWI (QVC, QVP).

status_text¶: str – Текстовое описание статуса платежа

trm_txn_id¶: str – Клиентский ID транзакции

account¶: str – Номер счета получателя

sum¶: TransactionSum – Данные о сумме платежа

commission¶: TransactionSum – Данные о комиссии платежа

total¶: TransactionSum – Данные об общей сумме платежа

provider¶: TransactionProvider – Данные о провайдере

comment¶: str – Комментарий к платежу

currency_rate¶: float/int – Курс конвертации (если применяется в транзакции)

source¶: ??? – ???

extras¶: ??? – Служебная информация

cheque_ready¶: bool – Специальное поле

bank_document_available¶: bool – Специальное поле

bank_document_ready¶: bool – Специальное поле

repeat_payment_enabled¶: bool – Специальное поле

favorite_payment_enabled¶: bool – Специальное поле

regular_payment_enabled¶: bool – Специальное поле

TransactionSum¶

class pyqiwi.types.TransactionSum(amount, currency)[исходный код]¶

Данные о платеже

amount¶: float/int – Сумма

currency¶: str – Валюта

TransactionProvider¶

class pyqiwi.types.TransactionProvider(_id, short_name, long_name, logo_url, description, keys, site_url)[исходный код]¶

Данные о провайдере

id¶: int – ID провайдера в процессинге

short_name¶: str – Краткое наименование провайдера

long_name¶: str – Развернутое наименование провайдера

logo_url¶: str – Cсылка на логотип провайдера

description¶: str – Описание провайдера (HTML)

keys¶: str – Список ключевых слов

site_url¶: str – Сайт провайдера

Statistics¶

class pyqiwi.types.Statistics(incoming_total, outgoing_total)[исходный код]¶

Статистика платежей

incoming_total¶: list[TransactionSum] – Данные о входящих платежах (пополнениях), отдельно по каждой валюте

outgoing_total¶: list[TransactionSum] – Данные об исходящих платежах, отдельно по каждой валюте

Commission¶

class pyqiwi.types.Commission(ranges)[исходный код]¶

Стандартная комиссия

ranges¶: list[CommissionRange] – Массив объектов с граничными условиями комиссий

CommissionRange¶

class pyqiwi.types.CommissionRange(bound, fixed, rate, _min, _max)[исходный код]¶

Условия комиссии

bound¶: Optional[float/int] – Сумма платежа, начиная с которой применяется условие

rate¶: Optional[float/int] – Комиссия (абсолютный множитель)

min¶: Optional[float/int] – Минимальная сумма комиссии

max¶: Optional[float/int] – Максимальная сумма комиссии

fixed¶: Optional[float/int] – Фиксированная сумма комиссии

OnlineCommission¶

class pyqiwi.types.OnlineCommission(provider_id, withdraw_sum, enrollment_sum, qw_commission, funding_source_commission, withdraw_to_enrollment_rate)[исходный код]¶

Подсчитанная комиссия

provider_id¶: int – Идентификатор провайдера

withdraw_sum¶: TransactionSum – Общая сумма платежа

enrollment_sum¶: TransactionSum – Сумма платежа с учетом комиссии

qw_commission¶: TransactionSum – Комиссия Qiwi

funding_source_commission¶: TransactionSum – Комиссия платежной системы(если Qiwi, то всегда 0)

withdraw_to_enrollment_rate¶: float/int – ???

Payment¶

class pyqiwi.types.Payment(_id, terms, fields, _sum, transaction, source, comment)[исходный код]¶

Данные о принятом платеже

id¶: str – Клиентский ID транзакции (В этой библиотеке, он считается 1000*Unix timestamp)

terms¶: str – Идентификатор провайдера

fields¶: PaymentFields – Реквизиты платежа

sum¶: TransactionSum – Данные о сумме платежа

source¶: str – ???

comment¶: Optional[str] – Комментарий к платежу

transaction¶: dict – Данные о транзакции в процессинге

PaymentFields¶

class pyqiwi.types.PaymentFields[исходный код]¶

Реквизиты платежа

Данный класс представляет из себя полностью хаотичную структуру Судя по документации Qiwi API, создается из исходного поля fields для платежа

Примечание

Если вы хотите посмотреть исходный вид выданный Qiwi API, используйте str(PaymentFields)

Exceptions¶

exception pyqiwi.exceptions.APIError(msg, method_name, response=None)[исходный код]¶

Ошибка в Qiwi API

msg¶: str – Сообщение ошибки

method_name¶: str – Название метода, вызванного при возникновении ошибки

request¶: requests.Response – Чистый ответ от сервера, полученный от requests

response¶: str – Текст выданный Qiwi API, без какой либо обработки

method¶: str – Метод вызванный на сервере Qiwi

params¶: dict – Параметры вызванного метода