Skip to main content

AAIO

A Library for easy work with Aaio API, in the Python programming language.
Библиотека для легкой работы с Aaio API, на языке программирования Python.

What is available in this library? - Что имеется в данной библиотеке?

  • Creating a bill for payment - Создание счета для оплаты
  • Quick check of payment status - Быстрая проверка статуса оплаты
  • Asynchronous / synchronous version - Асинхронная / синхронная версия
  • Get balance - Получение баланса
  • Get payment info - Получение информации о платежах

Installation - Установка

Required version Python: not lower than 3.7
Требуемая версия Python: не ниже 3.7

pip install AaioAPI

Using - Использование

To get started, you need to register and get all the necessary store data via this link on the official AAIO website
Чтобы начать работу, вам необходимо зарегистрироваться и получить все необходимые данные магазина по этой ссылке на оф.сайте AAIO

Get balance - Получение баланса

Чтобы получить доступ к балансу, скопируйте ваш API Ключ

Использование в синхронной версии:

from AaioAPI import AaioAPI

client = AaioAPI('API KEY', 'SECRET №1', 'MERCHANT ID')
balance = client.get_balance()
balance = balance['balance']
# balance = {
#     "type": "success",
#     "balance": 50.43, // Текущий доступный баланс
#     "referral": 0, // Текущий реферальный баланс
#     "hold": 1.57 // Текущий замороженный баланс
#  }

print(balance)

Использование в асинхронной версии:

from AaioAPI import AsyncAaioAPI
import asyncio

async def main():
    client = AsyncAaioAPI('API KEY', 'SECRET №1', 'MERCHANT ID')
    balance = await client.get_balance()
    balance = balance['balance']
    # balance = {
    #     "type": "success",
    #     "balance": 50.43, // Текущий доступный баланс
    #     "referral": 0, // Текущий реферальный баланс
    #     "hold": 1.57 // Текущий замороженный баланс
    #  }

    print(balance)


asyncio.run(main())

Get payment info - Получение информации о платеже

Здесь пример получения информации о платеже

Использование в синхронной версии:

from AaioAPI import AaioAPI

client = AsyncAaioAPI('API KEY', 'SECRET №1', 'MERCHANT ID')
order_id = 'my_id123' # Номер заказа
payment_info = client.get_payment_info(order_id)

print(payment_info)

Использование в синхронной версии:

from AaioAPI import AsyncAaioAPI
import asyncio

async def main():
    client = AsyncAaioAPI('API KEY', 'SECRET №1', 'MERCHANT ID')
    order_id = 'my_id123' # Номер заказа
    payment_info = await client.get_payment_info(order_id)

    print(payment_info)


asyncio.run(main())

Example of creating an invoice and receiving a payment link - Пример создания счета и получения ссылки на оплату

Здесь вам понадобятся данные вашего магазина

Использование в синхронной версии:

from AaioAPI import AaioAPI
import time

client = AaioAPI('API KEY', 'SECRET №1', 'MERCHANT ID')

order_id = 'my_id123' # Номер заказа
amount = 25 # Сумма к оплате
lang = 'ru' # Язык страницы
currency = 'RUB' # Валюта заказа
desc = 'Test payment.' # Описание заказа

URL = client.create_payment(order_id, amount, lang, currency, desc)

print(URL) # Ссылка на оплату

Использование в aсинхронной версии:

from AaioAPI import AsyncAaioAPI
import asyncio

async def main():
    client = AsyncAaioAPI('API KEY', 'SECRET №1', 'MERCHANT ID')

    order_id = 'my_id123' # Номер заказа
    amount = 25 # Сумма к оплате
    lang = 'ru' # Язык страницы
    currency = 'RUB' # Валюта заказа
    desc = 'Test payment.' # Описание заказа

    URL = await client.create_payment(order_id, amount, lang, currency, desc)

    print(URL) # Ссылка на оплату


asyncio.run(main())

Example of a status check - Пример проверки статуса

Проверяем статус платежа каждые 5 секунд с помощью цикла

Использование в синхронной версии:

while True:

    if client.is_expired(order_id):                # Если счет просрочен
        print("Invoice was expired")
        break
    elif client.is_success(order_id):              # Если оплата прошла успешно
        print("Payment was succesful")
        break
    else:                                   # Или если счет ожидает оплаты
        print("Invoice wasn't paid. Please pay the bill")
    time.sleep(5)

Использование в асинхронной версии:

while True:

    if await client.is_expired(order_id):                # Если счет просрочен
        print("Invoice was expired")
        break
    elif await client.is_success(order_id):              # Если оплата прошла успешно
        print("Payment was succesful")
        break
    else:                                   # Или если счет ожидает оплаты
        print("Invoice wasn't paid. Please pay the bill")
    await asyncio.sleep(5)

Full Code - Полный код

Синхронная версия:

from AaioAPI import AaioAPI
import time

client = AaioAPI('API KEY', 'SECRET №1', 'MERCHANT ID')

order_id = 'my_id123' # Номер заказа
amount = 25 # Сумма к оплате
lang = 'ru' # Язык страницы
currency = 'RUB' # Валюта заказа
desc = 'Test payment.' # Описание заказа

URL = client.create_payment(order_id, amount, lang, currency, desc)

print(URL) # Ссылка на оплату


while True:

    if client.is_expired(order_id):                # Если счет просрочен
        print("Invoice was expired")
        break
    elif client.is_success(order_id):              # Если оплата прошла успешно
        print("Payment was succesful")
        break
    else:                                   # Или если счет ожидает оплаты
        print("Invoice wasn't paid. Please pay the bill")
    time.sleep(5)

Асинхронная версия:

from AaioAPI import AsyncAaioAPI
import asyncio


async def main():
    client = AsyncAaioAPI('API KEY', 'SECRET №1', 'MERCHANT ID')

    order_id = 'my_id123' # Номер заказа
    amount = 25 # Сумма к оплате
    lang = 'ru' # Язык страницы
    currency = 'RUB' # Валюта заказа
    desc = 'Test payment.' # Описание заказа

    URL = await client.create_payment(order_id, amount, lang, currency, desc)

    print(URL) # Ссылка на оплату


    while True:

        if await client.is_expired(order_id):                # Если счет просрочен
            print("Invoice was expired")
            break
        elif await client.is_success(order_id):              # Если оплата прошла успешно
            print("Payment was succesful")
            break
        else:                                   # Или если счет ожидает оплаты
            print("Invoice wasn't paid. Please pay the bill")
        await asyncio.sleep(5)


asyncio.run(main())

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

AaioAPI-2.5.0.tar.gz (5.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

AaioAPI-2.5.0-py3-none-any.whl (6.9 kB view details)

Uploaded Python 3

File details

Details for the file AaioAPI-2.5.0.tar.gz.

File metadata

  • Download URL: AaioAPI-2.5.0.tar.gz
  • Upload date:
  • Size: 5.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.3

File hashes

Hashes for AaioAPI-2.5.0.tar.gz
Algorithm Hash digest
SHA256 8a8558d3beca729eff7c7469c44464cdee513a1b63a51d493f7e451ff8e39f6b
MD5 8d78403b6dcbea6d70df4542cab9dbab
BLAKE2b-256 f8082fe9be0d8b79ff735be791f5afffc6f288a5f4d73c4eb447025a3fbffa79

See more details on using hashes here.

File details

Details for the file AaioAPI-2.5.0-py3-none-any.whl.

File metadata

  • Download URL: AaioAPI-2.5.0-py3-none-any.whl
  • Upload date:
  • Size: 6.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.3

File hashes

Hashes for AaioAPI-2.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ea47c437260115c87e1f4b0693bef11056a2c39a609b304ab5cea7c0dc577b89
MD5 b21d04c5749a3955f180548d22772ebf
BLAKE2b-256 870508bc9c87edc3fce4bcb51e6d587677aea11a6ce0f242f776c6abbe496651

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page