EasyQiwi 🥝
Модуль easyqiwi - асинхронный Python модуль для работы с QIWI API. Он позволяет легко интегрировать функционал QIWI кошелька в ваши Python приложения. С помощью easyqiwi вы можете получать профиль пользователя, баланс счетов, историю платежей, генерировать счета и многое другое!
Основные возможности
- Получение профиля пользователя 👤
- Управление счетами 💳
- Просмотр истории платежей 🔍
- Создание счетов для оплаты (инвойсов) 🧾
- Асинхронная работа ⚙️
- Поддержка прокси 🌐
- Есть обработка каптчи 🔒
- Использование аутентифицированной сессии в Selenium/Puppeteer и т.д. 🤖
Быстрый старт
Пример асинхронного использования easyqiwi для аутентификации в QIWI и создания счета для оплаты:
import asyncio
from easyqiwi import EasyQiwiAuthCore, EasyQiwiAPI, setup_proxy
from easyqiwi import AuthException
async def main():
phone = '+79228133736'
password = 'example'
proxy_tuple = await setup_proxy('socks5', '162.210.192.136', '25881')
qiwi = EasyQiwiAuthCore(phone, password, proxy_tuple)
try:
await qiwi.auth()
except AuthException as e:
print(e)
exit()
qiwi_api = EasyQiwiAPI(qiwi)
p2p_resp = await qiwi_api.generate_p2p_public()
p2p_key = p2p_resp['publicKey']
widget_code = p2p_resp['widgetAliasCode']
invoice_resp = await qiwi_api.create_invoice(p2p_key, widget_code, 100)
invoice_uid = invoice_resp['invoice_uid']
print(f'https://oplata.qiwi.com/form?invoiceUid={invoice_uid}')
await qiwi.close()
if __name__ == '__main__':
asyncio.run(main())В этом примере мы создаем асинхронное соединение с QIWI, аутентифицируемся и создаем счет на оплату в 100 рублей.
Использование аутентифицированной сессии
Selenium
import asyncio
from easyqiwi import EasyQiwiAuthCore
from easyqiwi import AuthException
from selenium import webdriver
async def main():
phone = '+79228133736'
password = 'example'
qiwi = EasyQiwiAuthCore(phone, password)
try:
await qiwi.auth()
except AuthException as e:
pass
cookies = qiwi.cookies
auth_data = qiwi.auth_data
await qiwi.close()
driver = webdriver.Chrome()
driver.get('https://qiwi.com/')
driver.get('https://qiwi.com/')
for cookie in cookies:
driver.add_cookie({
'name': cookie['name'],
'value': cookie['value'],
'domain': cookie['domain']
})
driver.execute_script(f"localStorage.setItem('oauth-token-head', '{auth_data}');")
driver.get('https://qiwi.com/main')
await asyncio.sleep(100)
driver.quit()
if __name__ == '__main__':
asyncio.run(main())Pyppeteer
import asyncio
from easyqiwi import EasyQiwiAuthCore
from easyqiwi import AuthException
from pyppeteer import launch
async def main():
phone = '+79228133736'
password = 'example'
qiwi = EasyQiwiAuthCore(phone, password)
try:
await qiwi.auth()
except AuthException as e:
pass
cookies = qiwi.cookies
auth_data = qiwi.auth_data
await qiwi.close()
browser = await launch(headless=False)
pages = await browser.pages()
page = pages[0]
for cookie in cookies:
await page.setCookie({'name': cookie['name'], 'value': cookie['value'], 'domain': cookie['domain']})
await page.goto('https://qiwi.com/')
await page.evaluate(f"localStorage.setItem('oauth-token-head', '{auth_data}')")
await page.goto('https://qiwi.com/main')
await asyncio.sleep(100)
await browser.close()
if __name__ == '__main__':
asyncio.run(main())Установка
Установить модуль easyqiwi можно через pip:
pip install easyqiwiНебольшая документация
Аутентификация
Чтобы начать работу с QIWI API, необходимо произвести аутентификацию, используя номер телефона и пароль от QIWI кошелька:
qiwi = EasyQiwiAuthCore(phone, password)
await qiwi.auth()Обработка каптчи
Можно обработать каптчу, если она выскакивает:
from easyqiwi import RecaptchaException
try:
qiwi = EasyQiwiAuthCore(phone, password)
await qiwi.auth()
except RecaptchaException as e:
# и тут можно решать каптчу и затем вызвать
await qiwi.auth(recaptcha='обработанная каптча')Получение профиля
Получение данных профиля пользователя:
qiwi_api = EasyQiwiAPI(qiwi)
profile = await qiwi_api.get_current_profile()
print(profile)История платежей
Получение истории платежей:
payments = await qiwi_api.get_payments(person_id, rows=10)
print(payments)Создание инвойса
Генерация и отправка инвойса для оплаты:
invoice_resp = await qiwi_api.create_invoice(p2p_key, widget_code, 500, comment='За услуги')
invoice_uid = invoice_resp['invoice_uid']
print(f'Ссылка для оплаты: https://oplata.qiwi.com/form?invoiceUid={invoice_uid}')Закрытие сессии
Не забудьте закрыть сессию при завершении работы:
await qiwi.close()Прокси
Если вам необходимо использовать прокси, вы можете настроить его следующим образом:
proxy_tuple = await setup_proxy('socks5', 'proxy_ip', 'proxy_port', 'username', 'password')Другие методы API
Помимо описанных выше, easyqiwi предоставляет доступ и к другим методам QIWI API:
Источники финансирования
Получить список источников финансирования пользователя:
sources = await qiwi_api.get_sources(person_id)Идентификация
Получить данные по идентификации пользователя:
identification = await qiwi_api.get_identification(person_id)Счета
Получить количество неоплаченных счетов по их статусам:
checkouts = await qiwi_api.get_checkouts() Карты
Получить данные по привязанным картам пользователя:
cards = await qiwi_api.get_cards()Общая сумма платежей
Получить общую сумму входящих/исходящих платежей за период:
total_payments = await qiwi_api.get_total_payments(person_id, start_date, end_date)Транзакция
Получить информацию по конкретной транзакции:
transaction = await qiwi_api.get_transactions(transaction_id) 
