Parallel

Введение

Как устроен приём платежей в Parallel и как подключиться

Parallel принимает от ваших клиентов рубли — переводом по СБП или на карту — и зачисляет их на ваш баланс в USDT. Эта документация — про API v2. В нём сейчас приём платежей.

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

  1. Вы создаёте заявку: POST /api/v2/invoices. В ответе — реквизиты.
  2. Вы показываете реквизиты клиенту, клиент переводит деньги.
  3. Чек к нам попадает одним из двух способов, его вы выбираете в заявке:
    • UPLOAD — вы загружаете файл чека через API;
    • EMAIL — клиент отправляет чек из приложения Т-Банка на почту заявки.
  4. Мы проверяем чек. Заявка становится PAID, USDT зачисляются на ваш баланс.
  5. О каждой смене статуса заявки к вам приходит вебхук.

Полные примеры с запросами и вебхуками — на странице Примеры.

Подключение

Личный кабинет

Зарегистрируйтесь в личном кабинете: cabinet.parallel-pay.com и подтвердите почту по ссылке из письма.

Активация магазина

Новый магазин работает после активации Parallel. До неё на любой запрос к API приходит ошибка:

HTTP Status: 403 Forbidden

{
  "error": {
    "code": "SHOP_NOT_ACTIVATED",
    "message": "Магазин ещё не активирован. Свяжитесь с поддержкой Parallel, чтобы его активировали"
  }
}

API-ключ можно выпустить и подключить заранее: после активации он заработает без изменений.

API-ключ

Рекомендуемый способ

Скопируйте в чат с агентом (Claude, Codex):

Подключи приём платежей Parallel в этот проект через API v2.
Токен API не спрашивай у меня — получи сам, пришли мне ссылку для входа: https://docs.parallel-pay.com/docs/browser-login
Документация: https://docs.parallel-pay.com/llms-full.txt

Агент пришлёт вам ссылку и код. Откройте ссылку, войдите в личный кабинет или зарегистрируйтесь, выберите магазин и нажмите «Разрешить». Агент сам получит токен, сохранит его в безопасном месте и адаптирует код. Подробнее.

Самостоятельная настройка

Авторизуйтесь в личном кабинете и создайте магазин. После этого вы сможете получить токен доступа. Токен показывается один раз, сохраните его в безопасном месте. Как передавать токен в запросах — на странице Запросы и ошибки.

Токен хранится только на вашем сервере. Никогда не передавайте его в браузер или приложение клиента.

Версии API

  • API v2 — актуальная версия, ей посвящены разделы «Начало работы» и «Приём платежей». Сейчас в ней приём платежей.
  • API v1 — устаревшая. Существующие интеграции продолжают работать, новые подключайте к v2. Выплаты пока есть только в v1: API v1.
  • Баланс, вывод средств и вход агента общие для обеих версий: Баланс и вывод, Получить токен через браузер.

На этой странице