SDK

Официальные библиотеки RollyPay для быстрой интеграции платежей в ваш проект. Создание платежей, управление кассами, статистика и курсы — всё через пару строк кода.

---

Python

Установка

pip install rollypay

Быстрый старт

from rollypay import RollyPayClient, RollyPayError

client = RollyPayClient(api_key="ваш_api_ключ")

# Создание платежа
try:
    payment = client.payments.create(
        amount="1500.00",
        order_id="order_12345",
        payment_method="sbp",
        description="Оплата заказа #12345",
        customer_id="user@example.com",
        redirect_url="https://myshop.com/success",
    )
    print(f"ID платежа: {payment['payment_id']}")
    print(f"Ссылка на оплату: {payment['pay_url']}")
except RollyPayError as e:
    print(f"Ошибка: {e}")

Проверка статуса платежа

payment = client.payments.get("payment_uuid")

if payment["status"] == "paid":
    print("Платеж успешно оплачен!")
elif payment["status"] == "created":
    print("Платеж ожидает оплаты.")
else:
    print(f"Статус: {payment['status']}")

Работа с кассами

# Список касс
terminals = client.terminals.list()
for t in terminals:
    print(f"Касса: {t['name']} (ID: {t['id']})")

# Баланс кассы
balance = client.balance(terminal_id="terminal_uuid")
print(f"Доступно USDT: {balance['available_usdt']}")

Текущий курс

rate = client.rate(terminal_id="terminal_uuid")
print(f"Курс: {rate['rate']} RUB/USDT")

Возможности

• Управление платежами: создание, получение информации, списки
• Управление кассами (терминалами): просмотр, настройки, ротация API-ключей
• Статистика: финансовая сводка и аналитика
• Курсы валют: актуальные курсы обмена
• Баланс: проверка баланса кассы

Обработка ошибок

Исключение	Описание
RollyPayError	Базовый класс для всех ошибок SDK
APIError	Ошибка при выполнении запроса к API
AuthenticationError	Неверный API-ключ
NotFoundError	Ресурс не найден (404)
ServerError	Ошибка на стороне сервера (5xx)

Ссылки

• PyPI — rollypay
• Лицензия: MIT
• Python >= 3.7

---

Node.js

SDK для Node.js доступен по запросу. Напишите в поддержку, и мы предоставим доступ и документацию.

Ссылка на npm-пакет появится в ближайшее время.

---

PHP

SDK для PHP доступен по запросу. Напишите в поддержку, и мы предоставим доступ и документацию.

Ссылка на Packagist появится в ближайшее время.

---

Нужен другой язык?

Если вам нужен SDK для языка, которого нет в списке, свяжитесь с нами — support@rollypay.io или Telegram.