Parallel

Справочник API

Все методы API v2

Удобство наших партнёров — приоритетная задача Parallel. Ниже перечислены все доступные методы API. Контракт API вы также можете найти на TypeScript и в стандарте OpenAPI.

Адрес и токен

Адрес API один: https://api.parallel-pay.com. Передавайте токен в заголовке каждого запроса:

curl https://api.parallel-pay.com/api/v2/sla \
  -H "Authorization: Bearer $PARALLEL_TOKEN"

Токен выпускается в личном кабинете, в настройках магазина. Он показывается один раз. Храните его на своём сервере и не передавайте в браузер или приложение клиента. Чтобы проверить интеграцию без настоящих денег, используйте тестовый токен.

Ошибки

Любой ответ с кодом не 2xx выглядит одинаково:

409 Conflict
{
  "error": {
    "code": "INVALID_STATUS",
    "message": "Загрузить файл нельзя: заявка в статусе PAID"
  }
}

Стройте логику на error.code. Поле error.message написано для человека. Лишнее поле в теле запроса, которого нет в описании метода, тоже ошибка: 400 с кодом VALIDATION_ERROR.

HTTPcodeКогда
400VALIDATION_ERRORтело или параметры запроса не прошли проверку
401UNAUTHORIZEDнет токена или токен неверный
403SHOP_NOT_ACTIVATEDмагазин ещё не активирован
403DIRECTION_DISABLEDзаявки этого направления (на вход или на выход) магазину не подключены
403RECEIPT_DELIVERY_DISABLEDэтот способ получения чека не подключён магазину
403BANK_CHOICE_DISABLEDвыбор банка реквизитов (bank) вашему магазину не подключён
403METHOD_CHOICE_DISABLEDвыбор способа оплаты (method) вашему магазину не подключён
403DISPUTE_DISABLEDдиспуты по заявкам на выход вашему магазину не подключены
403PROOF_OPTION_DISABLEDэтот вид дополнительного доказательства оплаты не подключён магазину
404NOT_FOUNDзаявки или адреса нет
404WEBHOOK_NOT_SETподписки на события ещё нет
405METHOD_NOT_ALLOWEDэтот метод у адреса не поддерживается
409INVALID_STATUSдействие недоступно в текущем статусе заявки
409RECEIPT_DELIVERY_IS_BANK_EMAILчек по этой заявке клиент присылает на почту, загрузка недоступна
409FINANCIAL_RESPONSIBILITY_ALREADY_TAKENпод финансовую ответственность по этой заявке уже взята другая сумма
409INSUFFICIENT_BALANCEна балансе не хватает доступных USDT
409DISPUTE_ALREADY_OPENEDдиспут по этой заявке уже открывался
409DISPUTE_WINDOW_CLOSEDсрок, в который можно открыть диспут, вышел: dispute_days в GET /api/v2/sla
413FILE_TOO_LARGEфайл больше допустимого
415UNSUPPORTED_FILEформат файла не поддерживается
503NO_REQUISITESсейчас нет реквизитов на эту сумму, повторите запрос позже с тем же internal_id. Бывает у магазина, заявки которого не ждут реквизиты: requisites_wait_minutes: 0 в GET /api/v2/sla
503UNAVAILABLEвременный сбой, повторите запрос позже

Любой метод может вернуть UNAUTHORIZED, SHOP_NOT_ACTIVATED и UNAVAILABLE. Какие коды возвращает конкретный метод, указано на его странице.

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