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

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

Что можно делать через 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 от 0%, ваша ставка видна в ответе /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, когда появится разработчик. Модель заработка в обоих случаях описана в статье как заработать на пополнении Стим.