Так как КИВИ больше не работают в России, я больше не буду обновлять эту библиотеку. Я удалил метод, который был доступен только в рублях. Если оплата через ссылку теперь доступна и в Тенге, вы можете использовать версию в соседней ветке.
Простое Python SDK для p2p Qiwi API Параметры функций, кроме lifetime в оплате через форму, идентичны параметрам из официальной документации QIWi p2p, но изменены для соответствия PEP. Так billId переименовано в bill_id, а все параметры с *DateTime переименованы в *_datetime
- Скачать этот репозиторий
- Распаковать в папке, где находится исполняемый скрипт или в папке с модулями (что-то вроде
$PYTHONPATH$\Lib\site-packages) pip install -r requirements.txt
QIWI требует, чтобы при переходе по ссылке указывался referer. Если вы передаёте ссылки через мессенджеры или соцсети, вероятнее всего, этот параметр будет указан (по крайней мере, оф. приложения VK и Telegram однозначно оставляют его). Подробнее можете почитать тут.
Создание счёта и печать ссылки на него
from qiwip2py import QiwiP2P
from datetime import timedelta
qiwi_p2p = QiwiP2P(secret_key=SECRET_KEY)
bill = qiwi_p2p.create_bill(bill_id='test', amount=1.99, custom_fields={'themeCode': THEME_CODE},
expiration_datetime=timedelta(hours=3))
print(bill.pay_url)Проверка существования счёта
bill = qiwi_p2p.get_bill('test')
if bill:
print(f'Счёт на {bill.amount_value} {bill.amount["currency"]} существует')
else:
print('Счета не существует')При создании можно не задавать какой-то из ключей, если его использование не планируется, однако, при использовании метода, для которого этот ключ нужен, будет возвращено Assertion Error или AttributeError, если секретный ключ неверен. Во всех случаях, кроме оплаты через форму, используется секретный ключ.
Во все методы можно передать иные именованные аргументы, вроде proxy, и те передадутся в requests.request
Таблица параметров и соответствия с Qiwi p2p
| Параметр | Через API | Через форму | Описание |
|---|---|---|---|
| bill_id | передаётся в url | billId | Уникальный идентификатор выставляемого счета в вашей системе |
| amount | amount.value | amount | Сумма, на которую выставляется счет, округленная в меньшую сторону до 2 десятичных знаков |
| amount_currency | amount.currency | недоступно. Только через RUB | Валюта суммы счета. Возможные значения: RUB - рубли (по умолчанию), KZT - тенге |
| phone | customer.phone | phone | Номер телефона пользователя (в международном формате) |
| customer.email | E-mail пользователя | ||
| account | customer.account | account | Идентификатор пользователя в вашей системе |
| comment | comment | comment | Комментарий к счету (Виден пользователю при оплате) |
| expiration_datetime | expirationDateTime | lifetime | datetime.timedelta промежуток, который доступен счёт |
| custom_fields | customFields | customFields | dict с дополнительными полями (themeCode, paySourcesFilter, свои поля) |
| success_url | недоступно | successUrl | URL для переадресации в случае успешного перевода |
| return_pay_link | - | - | Если True, возвращает строку с ссылкой на форму, вместо создания счёта и возвращения Bill |
- bill_id: str Возвращает данные по счёту с bill_id (См. Возвращаемые объекты)
- bill_id: str Отменяет счёт с bill_id и возвращает данные по нему (См. Возвращаемые объекты)
Все методы, кроме create_bill(return_pay_link=True) возвращают один из этих двух объектов, кроме случаев с неуказанным или неверным секретным ключом:
Объект с данными о счёте
bool(Bill) == True
| Атрибут | QIWI | Тип | Описание |
|---|---|---|---|
| site_id | siteId | str | siteId |
| bill_id | billId | ||
| amount | amount | dict | Данные о сумме счета |
| amount_value | amount.value | float | Сумма счета |
| status | status | dict | Данные о статусе счета |
| status_value | status.value | str: 'WAITING', 'PAID', 'REJECTED' или 'EXPIRED' | Статус счёта |
| costumer | customer | dict | Идентификаторы пользователя |
| custom_fields | customFields | dict | строковые данные, переданные вами |
| comment | comment | str | Комментарий к счёту |
| creation_datetime | creationDateTime | datetime.datetime | Системная дата создания счета |
| expiration_datetime | expirationDateTime | datetime.datetime | Срок действия созданной формы для перевода |
| pay_url | payUrl | str | Ссылка для переадресации пользователя на созданную форму |
| json | - | dict | Преобразованный в dict json из ответа Qiwi |
Объект, возвращаемый при коде, отличном от 200
bool(ErrorResponse) == False
- status_code: status_code: int - код ошибки
- json: dict - Преобразованный в dict json из ответа Qiwi
- service_name
- error_code
- description
- user_message
- datetime
- trace_id
Если вы почему-то столкнулись с какими-то проблемами, но почему-то не хотите открыть issues или же просто желаете что-то написать, можете достать меня в telegram или VK