Quick Start

Here will be provided several examples on YooWallet usage.

Examples

All usage examples are available in tests/ dir in the root of the project

• Getting account info
• Getting operation history
• QuickPay
• Sync API
• HTTP notifications

Getting account info

import asyncio
from yoowallet import App
from yoowallet.types import AccountInfo

async def main(): 
    app: App = App("TOKEN")
    if not await app.connect():
        raise ValueError("Token is invalid!")
    app_info: AccountInfo = await app.account_info()
    app_info.debug()

if __name__ == "__main__":
    asyncio.run(main())

Getting operation history

More info

Go to API Reference to get the complete information about parameters

import asyncio
from yoowallet import App
from yoowallet.types import OperationHistory

async def main(): 
    app: App = App("TOKEN")
    if not await app.connect():
        raise ValueError("Token is invalid!")
    # Operation history without filters
    history: OperationHistory = await app.operation_history()
    print("[*] The entire operation history:")
    history.debug()

    # Operation history for the last hour
    from datetime import datetime
    date = datetime.now()
    date = date.replace(hour = date.hour - 1)
    history: OperationHistory = await app.operation_history(from_time = date)
    print("[*] Operation history for he last hour:")
    history.debug()

if __name__ == "__main__":
    asyncio.run(main())

QuickPay

About QuickPay

QuickPay is used to receive donates via link. You can set label for such link and verify it's status in operation history

You can generate link for fundraising:

import asyncio
from yoowallet import App

async def main(): 
    app: App = App("TOKEN")
    if not await app.connect():
        raise ValueError("Token is invalid!")
    # Set label to get it in operation history
    payment = await app.quickpay(2.0, label = "some_random_unique_id")
    print(f"[*] Payment link: {payment['url']} ({payment['amount_due']} RUB will be received)")

if __name__ == "__main__":
    asyncio.run(main())

By the way, there is an App method for easily receiving QuickPay status from operation history:

import asyncio
from yoowallet import App

async def main(): 
    app: App = App("TOKEN")
    if not await app.connect():
        raise ValueError("Token is invalid!")
    if await app.get_by_label("your label"):
        print("[*] Payment was successfully received")

if __name__ == "__main__":
    asyncio.run(main())

Sync API

For some reason you may need for synchronously using Yoowallet, so there is support for Sync API. App from Sync API has the same methods as the async one:

Sync API

To use sync API - you must install yoowallet in special edition. Go to installation for more info.

from yoowallet.sync import App
from yoowallet.types import AccountInfo

app: App = App("TOKEN")
if not app.connect():
    raise ValueError("Token is invalid!")
app.account_info().debug()

HTTP notification server

WARNING

Notification server has not been finished yet. Due to a lack of testing it may be VERY unstable. So, when server is finally written - you will see usage info here

But you can still try it via example in tests/ dir at your own risk.