This library was created to simplify the LAVA api provided on the official website, in the Python programming language.
Эта библиотека создана для упрощения работы с LAVA api, предоставленной на официальном сайте, на языке программирования Python.
Features – Возможности
- Checking token validity – Проверка токена на валидность
- Detailed validity check of the token – Подробная проверка токена на валидность
- Checking wallet balance – Проверка баланса кошелька
- Withdrawal from a wallet – Вывод из кошелька
- Transfers between wallets – Переводы между кошельками
- Transfer history of your wallet – История переводов вашего кошелька
- Creating a bill for payment – Создания счета для оплаты
- Information about the bill – Информация о созданном счете
Installation – Установка
Python version 3.6 or higher must be installed
Необходимо установить Python версии не ниже 3.6
pip install requests
pip install lavaapi
Using – Использование
To get your TOKEN, you need to register in LAVA and get your key by following this link
Для получения вашего ТОКЕНА необходимо зарегистрироваться в LAVA и получить свой ключ по этой ссылке
API key = Token
Checking token validity – Проверка токена на валидность
Returns True or False
Возвращает True или False
CheckWallet("YOUR_TOKEN")
Detailed validity check of the token – Подробная проверка токена на валидность
Returns True if valid or String with error
Возвращает True если валидный или String с ошибкой, если токен невалидный
CheckWalletDetails("YOUR_TOKEN")
Checking wallet balance – Проверка баланса кошелька
Returns String
Возвращает String
CURRENCY: “USD”, “EUR” or “RUB”
WalletBalance("YOUR_TOKEN", "CURRENCY")
Withdrawal from a wallet – Вывод из кошелька
Returns True or String with error
Возвращает True или String с ошибкой
ACCOUNT_ID: Your account number (For example: R10007689)
AMOUNT: Withdrawal amount in Int
SERVICE: “qiwi”, “yoomoney”, “card”, “advcash”, “payeer”, “mobile”, “perfect”
WALLET_TO: Wallet, where the money will be withdrawn
WithdrawCreate("YOUR_TOKEN", "ACCOUNT_ID", AMOUNT, "SERVICE", "WALLET_TO")
Example:
WithdrawCreate("MY_TOKEN", "R10007689", 100, "qiwi", "88005553535")
Transfers between wallets – Переводы между кошельками
Returns True or String with error
Возвращает True или String с ошибкой
ACCOUNT_ID: Your account number (For example: R10007689)
AMOUNT: Transferable amount in Int
ACCOUNT_TO: Account to which the money will be transferred
TransferCreate("YOUR_TOKEN", "ACCOUNT_ID", AMOUNT, "ACCOUNT_TO")
Example:
TransferCreate("MY_TOKEN", "R10007689", 500, "R100126592")
Transfer history of your wallet – История переводов вашего кошелька
Returns an array of data
Возвращает массив данных
ACCOUNT_ID: Your account number (For example: R10007689)
**TYPE: “withdraw” or “transfer”
**LIMIT: Number of records that will be returned
** – Optional parameter – Необязательный параметр
TransactionsList("YOUR_TOKEN", "ACCOUNT_ID", type="TRANSLATION_TYPE", limit=MAX_TRANSLATION)
Example:
myTranslations = TransactionsList("MY_TOKEN", "R10007689", limit=3)
print(myTranslations[0]["amount"], myTranslations[0]["comment"])
1230.00 Hello
Full function output:
[
{
"id": "bc81edeb-3f81-156d-21bd-06c67010094f", // Номер транзакции
"created_at": "1634902579", // Время создания (unix timestamp)
"created_date": "2021-10-22T11:36:19+00:00", // Время создания
"amount": "1230.00", // Сумма транзакции
"status": "success", // Статус транзакции
"transfer_type": "transfer", // Тип перевода
"comment": "Hello", // Комментарий
"method": "-1", // Метод 1 - зачисление, -1 - расход
"currency": "RUB", // Валюта
"account": "R10000001", // Номер аккаунта
"commission": "12.30", // Комиссия
"type": "out", // Тип in - пополнение, out - перевод
"receiver": "R10000000" // Номер аккаунта получателя
},
{
"id": "3e22b0c8-2c4a-93d8-2f6d-b93ce824ee62",
"created_at": "1634899536",
"created_date": "2021-10-22T10:45:36+00:00",
"amount": "1000.01",
"commission": "0.00",
"status": "pending",
"transfer_type": "withdraw",
"service": "card",
"comment": null,
"method": "-1",
"currency": "RUB",
"account": "R10000001"
},
{
"id": "f569a6e7-14e4-1895-374c-c9dd6775c0ce",
"created_at": "1634744391",
"created_date": "2021-10-20T15:39:51+00:00",
"amount": "1000.00",
"status": "pending",
"transfer_type": "transfer",
"comment": "123123",
"method": "1",
"currency": "RUB",
"account": "R10000001",
"commission": 0,
"type": "in",
"sender": "system" // Отправитель
},
]
Creating a bill for payment – Создания счета для оплаты
Returns Json array
Возвращает массив Json
ACCOUNT_ID: Your account number (For example: R10007689)
AMOUNT: Transferable amount in Int
**EXPIRE: The time in minutes after which the account will automatically close. By standard 1440
**SUCCESSURL: Url for redirection after successful payment
**FAILURL: Url for redirecting after unsuccessful payment
**SUBTRACT: Who to charge the commission to (1 – Write off from the client, 0 – Write off from the store). By standard 0
**COMMENT: Payment comment
**MERCHANTNAME: Merchant name (displayed in the translation form)
** – Optional parameter – Необязательный параметр
InvoiceCreate("YOUR_TOKEN", "ACCOUNT_ID", AMOUNT, expire=None, successUrl=None,
failUrl=None, subtract=0, comment=None, merchantName=None)
Example:
billCreate = InvoiceCreate("MY_TOKEN", "R10007689", 150, comment="DBD20RANK")
print("Payment link:", billCreate["url"])
Payment link: https://p2p.lava.ru/form?id=1ee31634-e3e0-34ce-1423-b5b4cb524c6a
Full function output:
{
"status": "success",
// Номер счета на оплату
"id": "1ee31634-e3e0-34ce-1423-b5b4cb524c6a",
// Ссылка на оплату
"url": "https://p2p.lava.ru/form?id=1ee31634-e3e0-34ce-1423-b5b4cb524c6a",
// Время истечения счета
"expire": 1636983503,
// Сумма счета
"sum": "100.00",
// URL для переадресации после успешной оплаты
"success_url": "https://lava.ru?success",
// URL для переадресации после неудачной оплаты
"fail_url": "https://lava.ru?fail",
// URL для отправки webhook
"hook_url": "https://lava.ru?hook",
// Дополнительное поле
"custom_fields": "123",
// ID и наименование мерчанта
"merchant_name": "123",
"merchant_id": "123",
}
Information about the bill – Информация о созданном счете
Returns Json array
Возвращает массив Json
ACCOUNT_ID: Your account number (For example: R10007689)
BILL_ID: Billed number
InvoiceInfo("YOUR_TOKEN", "BILL_ID")
Example:
billCreate = InvoiceInfo("MY_TOKEN", "R10007689", "1ee31634-e3e0-34ce-1423-b5b4cb524c6a")
print(billCreate["invoice"]["comment"])
На бигтести с колой
Full function output:
{
"status": "success",
"invoice": {
// Номер счета на оплату
"id": "1ee31634-e3e0-34ce-1423-b5b4cb524c6a",
// Номер счета в системе клиента
"order_id": "order_125",
// Время истечение счета
"expire": 1636983503,
// Сумма счета
"sum": "100.00",
// Комментарий
"comment": "На бигтести с колой",
// Статус счета
"status": "success",
// URL для переадресации после успешной оплаты
"success_url": "https://lava.ru?success",
// URL для переадресации после неудачной оплаты
"fail_url": "https://lava.ru?fail",
// URL для отправки webhook
"hook_url": "https://lava.ru?hook",
// Дополнительное поле
"custom_fields": "123"
}
}
License
GNU General Public License (GPL)
