Введение
Как устроен приём платежей в Parallel и как подключиться
Parallel принимает от ваших клиентов рубли — переводом по СБП или на карту — и зачисляет их на ваш баланс в USDT. Эта документация — про API v2. В нём сейчас приём платежей.
Как проходит оплата
- Вы создаёте заявку:
POST /api/v2/invoices. В ответе — реквизиты. - Вы показываете реквизиты клиенту, клиент переводит деньги.
- Чек к нам попадает одним из двух способов, его вы выбираете в заявке:
UPLOAD— вы загружаете файл чека через API;EMAIL— клиент отправляет чек из приложения Т-Банка на почту заявки.
- Мы проверяем чек. Заявка становится
PAID, USDT зачисляются на ваш баланс. - О каждой смене статуса заявки к вам приходит вебхук.
Полные примеры с запросами и вебхуками — на странице Примеры.
Подключение
Личный кабинет
Зарегистрируйтесь в личном кабинете: 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.
- Баланс, вывод средств и вход агента общие для обеих версий: Баланс и вывод, Получить токен через браузер.