API оплаты зарубежных сервисов и Steam: как подключить Payli API

API для оплаты зарубежных сервисов нужно, когда виджета мало: у вас своё приложение, бот со сложной логикой или сервис, где заказ должен жить в вашем интерфейсе от корзины до выдачи. Payli Partner API — это REST поверх того же каталога, что и на сайте: пополнение Steam по логину, донат в игры по ID, коды подарочных карт, подписки с ручной активацией и eSIM с продлением. Покупатель платит в рублях по ссылке — СБП, карта или USDT, — а выдача, статусы и уведомления приходят к вам вебхуками. Ниже — что есть в API, как считается комиссия и как подключиться за один день.

Что можно делать через API

Полное описание полей, статусов и ошибок — в документации API; примеры ниже сокращены до того, что нужно для первого заказа.

Как проходит заказ

1. Получаете каталог: для Steam — лимиты суммы, для остальных товаров — fields из карточки (ID аккаунта, сервер, почта).
2. Создаёте заказ: POST /orders с типом, товаром, полями покупателя и суммой; опционально — своя наценка partner_commission_percent, webhook_url с секретом, idempotency_key, чтобы повтор запроса не создал второй заказ.
3. Отдаёте покупателю payment.pay_url: по умолчанию это СБП; передав payment_method: card или crypto, получите страницу оплаты картой или в USDT.
4. После оплаты приходит вебхук order.status с payment_received, затем — completed с результатом: код ваучера, QR eSIM или подтверждение зачисления. Промежуточные статусы можно и опрашивать через GET /orders/{public_id}.

Суммы везде в рублях с двумя знаками, даты — RFC3339. Лимиты — 600 GET и 60 POST в минуту на токен. Вебхук считается доставленным при любом ответе 2xx в течение 8 секунд; иначе повторы с растущей паузой до 8 попыток в течение часа, поэтому обрабатывайте событие асинхронно и дедуплицируйте по X-Payli-Event-Id. Подпись — X-Payli-Signature: sha256=HMAC(тело, webhook_secret), сравнивайте за константное время.

Ручные заказы: подписки и активация на аккаунте

Часть товаров выдаёт исполнитель — подписки с активацией на аккаунте покупателя, готовые аккаунты, покупки в сторонних магазинах. В каталоге они помечены type: manual. Заказ создаётся так же, а после оплаты открывается чат с исполнителем: его сообщения приходят вебхуком order.message, ваши — через POST …/messages. Когда исполнитель отмечает выдачу, заказ переходит в awaiting_confirmation: покупатель подтверждает или открывает спор, и это тоже делается через API. Так в вашем интерфейсе можно продавать PS Plus, Game Pass и Spotify, не разбирая переписку вручную.

Комиссии и как вы зарабатываете

У каждого сервиса есть базовая комиссия Payli — на момент публикации 4% для пополнения Steam и 6% для остальных, она видна в ответе /services. Сверх неё вы задаёте партнёрскую наценку в каждом заказе, и она целиком ваша. Оплата картой чуть дороже СБП — надбавка покрывает эквайринг; криптовалюта — со скидкой. Возврат заказа в статусе failed идёт на полную сумму платежа, комиссия эквайринга при возврате удерживается с партнёрского баланса. Заказы можно оплачивать и с партнёрского баланса, минуя ссылку, — баланс пополняется инвойсом из кабинета.

Как подключиться

1. Зарегистрируйтесь на payli.ru и откройте вкладку «Партнёрам» → «API-ключи».
2. Создайте токен с нужными правами: orders_create_acquirer для заказов с оплатой по ссылке, orders_refund для возвратов; чтение каталога, заказов и баланса доступно любому токену.
3. Сделайте тестовый заказ на минимальную сумму, проверьте вебхук и GET /orders.
4. Если нужны индивидуальные условия по комиссии под объём или помощь с интеграцией — оставить заявку на /partners.

Токен передаётся только в заголовке Authorization: Bearer с вашего сервера. В браузере и в мобильном приложении его быть не должно — для фронтенда есть виджет, который не требует токена.

Подключение и вопросы: оставить заявку на /partners, Telegram @payli_support, почта partners@payli.ru. Отвечаем в течение рабочего дня, с интеграцией помогаем.

API или виджет

Если задача — «принимать оплату Steam и подписок на сайте», виджет быстрее: строка скрипта, наценка в кабинете, готово. API нужен, когда заказ должен быть частью вашего продукта: своя корзина, свой личный кабинет, бот с нестандартной логикой, автоматические продления eSIM (renew_order_id), сверка статусов с вашей CRM. Оба формата работают с одним кабинетом и одним балансом, поэтому начать можно с виджета и перейти на API, когда появится разработчик. Модель заработка в обоих случаях описана в статье как заработать на пополнении Стим.