July 9, 2023

telepycrypto

telepycrypto - использует апи "CryptoBotAPI" которые предоставляют ряд крутых функций для упрощения работы с CryptoBot, наша библиотека telepycrypto упрощает в несколько раз в понимании CryptoBotAPI

telepycrypto поддерживает:

Client - предоставляет ряд одиночных функций такие как:

  • получить баланс
  • получить информацию про себя
  • создать инвойс
  • проверить инвойсы
  • и т.д

Types - предоставляет ряд вспомогательных функций такие как:

  • получить статус с инвойса
  • получить текст инвойса
  • получить кнопки с инвойса
  • и т.д

Download

чтобы скачать нашу библиотеку на свой python напишите:

pip install telepycrypto

чтобы получить ключ для обычных запросов:

  • зайти в бота @CryptoBot
  • Crypto Pay
  • Создать приложение
  • API-токен
  • и копируете токен

чтобы получить ключ для тестнет запросов:

  • зайти в бота @CryptoTestnetBot
  • Crypto Pay
  • Создать приложение
  • API-токен
  • и копируете токен

Client

Client поддерживает тест мод через который вы сможете тестировать функции не тратя Crypto, чтобы получить доступ к тест моду вам нужен специальный ключ с бота телеграма [Bot](https://t.me/CryptoTestnetBot)

прошу обратить внимание на функции:

Get Me

import telepycrypto as api
app = api.Client(token="your key")
print(app.getme())

чтобы включить тест мод пишем следующее:

import telepycrypto as api
app = api.Client(token="your test key")
print(app.getme(test=True)) #по умолчанию False

Balance

balance - показывает ваш баланс

import telepycrypto as api
app = api.Client(token="your key")
print(app.balance())

Test Mode

import telepycrypto as api
app = api.Client(token="your test key")
print(app.balance(test=True))#по умолчанию False

Currencies

currencies - показывает доступные валюты в боте

import telepycrypto as api
app = api.Client(token="your key")
print(app.currencies())

Test Mode

import telepycrypto as api
app = api.Client(token="your test key")
print(app.currencies(test=True))#по умолчанию False

Get Exchange Rates

Get Exchange Rates - получаем курсы обмена

import telepycrypto as api
app = api.Client(token="your key")
print(app.exchange_rates())

Test Mode

import telepycrypto as api
app = api.Client(token="your test key")
print(app.exchange_rates(test=True))#по умолчанию False

Create Invoice

Create Invoice - создает инвойс

import telepycrypto as api
app = api.Client(token="your key")
data = {
"crypto": "USDT",
"amount": 120
}
print(app.createinvoice(data=data))

в дату можно добавить все что душе угодно но лишь crypto и amount обязательно

в дату можно передать такие параметры как:

  • description - описание вашего инвойса(по умолчанию None)
  • hidden_message - текст которое будет показано пользователю после оплаты счета
  • paid_btn_name - название кнопки которое будет показана после оплаты счета, Поддерживаемые имена:
    • viewItem
    • openChannel
    • openBot
    • callback
  • paid_btn_url - Требуется если используется paid_btn_name, URL который будет открываться при нажатии кнопки
  • payload - Любые данные, которые вы хотите прикрепить к счету (например, идентификатор пользователя, идентификатор платежа и т. д.) до 4КБ
  • allow_comments - Разрешить пользователю добавлять комментарий к платежу. Значение по умолчанию True
  • allow_anonymous - Разрешить пользователю оплачивать счет анонимно. Значение по умолчанию True
  • expires_in - Вы можете установить лимит времени оплаты счета в секундах. Допустимы значения от 1 до 2678400. значение по умолчанию 2000

Test Mode

import telepycrypto as api
app = api.Client(token="your key")
data = {
"crypto": "USDT",
"amount": 120
}
print(app.createinvoice(data=data, test=True))

Get Invoices

Get Invoices - получаем все наши счета

import telepycrypto as api
app = api.Client(token="your key")
print(app.invoices())

так же есть фильтр если добавить data:

  • crypto - фильтр по крипте(если USDT покажет все счета на эту крипту)
  • invoice_ids - фильтр по айди(если к примеру айди 77187 покажет лишь этот счет с таким айди)
  • status - фильтр по статусу:
    • active - покажет все счета которые активные
    • paid - покажет все счета которые оплатил
  • offset - необходимое для возврата определенного подмножества счетов-фактур. По умолчанию 0.
  • count - возвращает счета по умолчанию стоит 100(возвращается до 100 счетов максимум можно до 1000)

фильтр

import telepycrypto as api
app = api.Client(token="your key")
data = {
"crypto": "USDT",
"status": "paid",
"count": 10
}
print(app.invoices(data=data))

Test Mode

import telepycrypto as api
app = api.Client(token="your key")
data = {
"crypto": "USDT",
"status": "paid",
"count": 10
}
print(app.invoices(data=data, test=True))

Types

Types - создан чтобы облегчить вам работу(бета)

Get Status

get_status - показывает вам статус счета по его айди

import telepycrypto.Types as api
inv = api.Invoice(token="key")
print(inv.get_status(ids="invoice id"))