Metadata-Version: 2.1
Name: walletpay-sdk
Version: 1.1.3
Summary: 
Author: pypchuk
Author-email: opengl32.dll.tar.gz@gmail.com
Requires-Python: >=3.11,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: adaptix (>=3.0.0a4,<4.0.0)
Requires-Dist: aiohttp (>=3.8.5,<4.0.0)
Description-Content-Type: text/markdown

# Wallet Pay Python API
https://docs.wallet.tg/pay/

## Installation
```commandline
pip install walletpay-sdk
```

## Example
```python
import asyncio

from uuid import uuid4

from aiogram import Bot
from aiogram.types import InlineKeyboardButton, InlineKeyboardMarkup

from walletpay import Client


CUSTOMER_TELEGRAM_ID = 133777888


async def main():
    api = Client("YoUrApIKey")
    bot = Bot("1294789:YourBoTKey")

    # Create order
    order = await api.create_order(
        "0.001",
        external_id=str(uuid4()),
        customer_telegram_user_id=CUSTOMER_TELEGRAM_ID,
        description="Support me",
        timeout_seconds=60,
    )

    # Send order to user
    await bot.send_message(
        CUSTOMER_TELEGRAM_ID,
        "Pay",
        reply_markup=InlineKeyboardMarkup(
            inline_keyboard=[
                [
                    InlineKeyboardButton(
                        text="👛 Pay via Wallet",
                        url=order.data.payLink,
                    )
                ]
            ]
        )
    )

    await api.session.close()
    await bot.session.close()


asyncio.run(main())
```

## Requirements
1. Python >= 3.11

## Running tests
1. Clone repo  
2. From the root dir run  
```commandline
pytest tests
```

## Running examples
1. Clone repo
2. Run `poetry install --group examples`
3. Add env vars:  
3.1 Add WP_TEST_KEY with your API key  
3.2 (FOR bot.py) Add WP_BOT_TOKEN with bot token bound to your api  
4. Go to examples folder and run them like regular python scripts  

### Note about webhooks example
WARNING! For development purposes only!  
To run webhook example you need dedicated IP address  
You can use ngrok to test your application:  
1. Download ngrok and log in
2. Run `ngrok http 80`
3. Copy your temporary IP address
4. Paste it in your merchant settings
5. !AFTER DEVELOPMENT DON'T FORGET TO REMOVE ADDRESS IN WALLETPAY WEBHOOK SETTINGS PROVIDED FROM NGROK!
