Parallel

Приём платежей (IN)

Клиент переводит рубли на реквизиты Parallel, вы получаете USDT на баланс

Ваш клиент переводит рубли по СБП или на карту на реквизиты, которые выдаёт Parallel. Вы получаете USDT на баланс по курсу заявки.

С тестовым токеном запросы из этой статьи выполняются прямо здесь, без настоящих денег. Токен хранится только в вашем браузере.

Интеграция состоит из четырёх шагов:

  1. Подпишитесь на события Webhook.
  2. Создайте заявку. Покажите реквизиты клиенту.
  3. Клиент оплачивает и присылает чек до конца срока заявки. Загрузите чек.
  4. Если чек не подтвердил оплату, загрузите видео оплаты или возьмите заявку под свою финансовую ответственность.

1. Подпишитесь на события Webhook

Укажите адрес и типы событий, о которых присылать уведомления. Тип можно указать целиком, например invoice.in.paid, или его началом до точки — тогда придут все события этой группы:

  • invoice — все события;
  • invoice.in — все события приёма;
  • invoice.in.dispute — диспуты по приёму.

Если events не указать или передать пустым списком, подписка идёт на все события. Список событий — в конце статьи.

Запрос
curl -X PUT https://api.parallel-pay.com/api/v2/webhook_subscription \
  -H "Authorization: Bearer $PARALLEL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/webhooks/parallel", "events": ["invoice"]}'
Вставьте тестовый токен в начале страницы
Ответ 200
{
  "url": "https://example.com/webhooks/parallel",
  "events": ["invoice"],
  "secret": "whsec_Jq7tKx2mVb9pLr4sWn8yDc3fHg6zQa1eUo5iTk0RvXw"
}

Сохраните secret: им подписано каждое событие.

Что приходит на ваш адрес

Parallel отправляет объект события на ваш адрес запросом POST. Поле type содержит тип события, data.object — обновлённый объект заявки целиком, а data.previous — прежние значения полей, которые изменились.

Webhook
POST /webhooks/parallel HTTP/1.1
Content-Type: application/json
X-Webhook-Signature: 9f2c1e7ab4d05c6e8a31f7b2d9c4e6a05b8d3f1c7e2a9b4d6c8e0f1a3b5c7d9e
X-Webhook-Delivery-Id: 6f1d2c3b-8a9e-4f70-b1c2-d3e4f5a6b7c8
Тело
{
  "event_id": "6f1d2c3b-8a9e-4f70-b1c2-d3e4f5a6b7c8",
  "type": "invoice.in.paid",
  "created_at": "2026-11-09T12:05:00+03:00",
  "data": {
    "object": {
      "invoice_id": "cm3k8x7y80001z8j4k5m6n7o8",
      "status": "PAID",
      "paid_amount": "1000",
      "paid_at": "2026-11-09T12:05:00+03:00"
      // …остальные поля заявки
    },
    "previous": {
      "status": "REVIEW",
      "review_until": "2026-11-09T12:20:00+03:00",
      "paid_amount": null,
      "paid_at": null
    }
  }
}

Вложенные объекты в previous содержат только изменившиеся ключи, список — прежний целиком.

Ответьте любым кодом 2xx. Если ответа нет, Parallel повторит то же событие через 1, 5 и 30 минут, затем через 2, 6 и 12 часов. У повторов тот же X-Webhook-Delivery-Id, он же event_id. События по одной заявке приходят по порядку.

Заголовок X-Webhook-Signature содержит HMAC-SHA256 от тела запроса с ключом secret, в hex. Проверяйте подпись до разбора JSON.

2. Создайте заявку

Оплата должна быть завершена в течение срока заявки.

Дедлайн по заявке указан в поле pay_until.

После истечения срока заявка переходит в статус EXPIRED, и оплата не принимается.

Запрос
curl https://api.parallel-pay.com/api/v2/invoices \
  -H "Authorization: Bearer $PARALLEL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "internal_id": "order-1001",
    "direction": "IN",
    "amount": "1000",
    "currency": "RUB"
  }'
₽Вставьте тестовый токен в начале страницы

Поля запроса:

internal_idstring

Номер заявки в вашей системе. Защищает от случайного повторного создания: повтор с тем же internal_id вернёт уже созданную заявку

direction"IN"

Направление: IN — заявка на вход: клиент переводит рубли на реквизиты Parallel

amountstring

Сумма в рублях: "1000"

currency"RUB"
method"SBP" | "TO_CARD"необязательное

Способ оплаты: SBP — по СБП, TO_CARD — на карту. Без него подойдёт любой. Выбирать способ оплаты можно, только если это разрешено вашему магазину, иначе — 403 METHOD_CHOICE_DISABLED

bankstringнеобязательное

Банк реквизитов. Без него подойдёт любой доступный. Выбирать банк можно, только если это разрешено вашему магазину, иначе — 403 BANK_CHOICE_DISABLED

receipt_delivery"BANK_EMAIL" | "UPLOAD"необязательное

Как к нам попадёт чек: BANK_EMAIL — с почты Т-Банка, UPLOAD — вы загрузите сами. Без него — default_receipt_delivery из GET /api/v2/sla

В ответе приходит заявка с реквизитами. Покажите их клиенту.

Ответ 201
{
  "internal_id": "order-1001",
  "invoice_id": "cm3k8x7y80001z8j4k5m6n7o8",
  "direction": "IN",
  "created_at": "2026-11-09T12:00:00+03:00",
  "updated_at": "2026-11-09T12:00:00+03:00",
  "amount": "1000",
  "currency": "RUB",
  "deal_rate": "95.5",
  "requisites": {
    "method": "SBP",
    "bank": "sberbank",
    "bank_name": "Сбербанк",
    "full_name": "Ivan I.",
    "phone_number": "+79001234567"
  },
  "attachments": [],
  "status": "IN_PROGRESS",
  "pay_until": "2026-11-09T13:00:00+03:00"
}

Когда свободных реквизитов нет, API отвечает 503 NO_REQUISITES. Повторите запрос позже.

3. Загрузите чек

Чек загружается файлом в поле file. Формат запроса: multipart/form-data. Размер файла до 10 МБ.

Запрос
curl https://api.parallel-pay.com/api/v2/invoices/cm3k8x7y80001z8j4k5m6n7o8/attachments \
  -H "Authorization: Bearer $PARALLEL_TOKEN" \
  -F "file=@receipt.pdf"
Вставьте тестовый токен в начале страницы

Оплату подтверждает чек PDF из банка.

В ответе приходит заявка целиком.

Поле amount содержит изначальную сумму заявки и не меняется при частичной оплате.

Поле paid_amount содержит подтверждённую оплаченную сумму по заявке.

Зачисление средств считается по paid_amount.

Чек добавляется в attachments. Если с чеком есть проблема, его поле failure_reason содержит код и сообщение ошибки.

Скриншот (JPG, PNG) тоже можно загрузить, но оплату он не подтверждает: заявка сразу перейдёт в PROOF_REQUIRED и будет ждать дополнительное доказательство оплаты.

Ответ 201
{
  "internal_id": "order-1001",
  "invoice_id": "cm3k8x7y80001z8j4k5m6n7o8",
  "direction": "IN",
  "created_at": "2026-11-09T12:00:00+03:00",
  "updated_at": "2026-11-09T12:05:00+03:00",
  "amount": "1000",
  "currency": "RUB",
  "deal_rate": "95.5",
  "requisites": {
    "method": "SBP",
    "bank": "sberbank",
    "bank_name": "Сбербанк",
    "full_name": "Ivan I.",
    "phone_number": "+79001234567"
  },
  "attachments": [
    {
      "attachment_id": "cm3k9b2c40002z8j4q1r2s3t4",
      "type": "PDF",
      "file_name": "receipt.pdf",
      "file_url": "https://api.parallel-pay.com/files/attachments/cm3k9b2c40002z8j4q1r2s3t4/receipt.pdf?expires=1795330800&signature=fcd3fcf3893605287a54c62e3923958dc854f3bad53754cff331cfd69510ecf5",
      "received_at": "2026-11-09T12:05:00+03:00",
      "status": "PASSED",
      "checked_at": "2026-11-09T12:05:00+03:00",
      "transfer": {
        "amount": "1000",
        "at": "2026-11-09T12:03:00+03:00",
        "bank_status": "Успешно",
        "operation_id": null,
        "from": {
          "bank": "tbank",
          "name": "Пётр П."
        },
        "to": {
          "method": "SBP",
          "bank": "sberbank",
          "name": "Иван И.",
          "phone_number": "+79001234567",
          "card_number": null
        }
      }
    }
  ],
  "status": "PAID",
  "paid_amount": "1000",
  "paid_at": "2026-11-09T12:05:00+03:00"
}

Статус заявки в ответе и событие, которое приходит на Webhook:

  • IN_PROGRESS с полем paid_amount, Webhook invoice.in.partially_paid. Чек подтвердил часть суммы. Клиент может доплатить до pay_until.
  • PAID, Webhook invoice.in.paid. Работа над заявкой завершена: оплачена вся сумма или при частичной оплате вышел срок pay_until.
  • PROOF_REQUIRED, Webhook invoice.in.proof_required. Чек не подтвердил оплату. Причина указана в поле failure_reason чека. Перейдите к шагу 4.

Поля чека:

attachment_idstring

Номер файла в Parallel

type"IMAGE" | "PDF" | "VIDEO"

PDF — чек из банка, IMAGE — скриншот, VIDEO — видео оплаты

file_namestring
file_urlstring

Ссылка на файл, действует 7 дней

received_atstring
status"CHECKING" | "PASSED" | "FAILED"
  • CHECKING — Файл на проверке, результат придёт на Webhook
  • PASSED — Файл подтверждает оплату
  • FAILED — Файл не подтверждает оплату, почему — в failure_reason
checked_atstring

Есть в статусе PASSED или FAILED.

transferTransfer

Что прочитано из файла. Есть, если файл удалось прочитать

Есть в статусе PASSED или FAILED.

Поля transfer
amountstring | null

Сумма перевода

atstring | null

Время перевода

bank_statusstring | null

Статус перевода в чеке как есть, словами банка: "Успешно", "В обработке"

operation_idstring | null

Номер операции в банке

fromobject

Отправитель: банк и имя

Поля from
bankstring | null
namestring | null
toobject

Получатель: куда ушёл перевод

Поля to
method"SBP" | "TO_CARD" | null
bankstring | null
namestring | null
phone_numberstring | null
card_numberstring | null
failure_reasonAttachmentFailureReason

Есть в статусе FAILED.

Поля failure_reason
code"DUPLICATE" | "FAKE" | "NOT_COMPLETED" | "UNREADABLE" | "WRONG_RECIPIENT"
  • FAKE — файл похож на подделку;
  • UNREADABLE — не удалось распознать банк или формат;
  • NOT_COMPLETED — перевод не завершён: например, «В обработке»; банк может его отменить;
  • WRONG_RECIPIENT — перевод на другие реквизиты;
  • DUPLICATE — этим чеком уже закрыта другая заявка
messagestring

4. Если чек не подтвердил оплату

Если чек вызывает сомнения, Parallel запрашивает дополнительное доказательство оплаты: заявка переходит в статус PROOF_REQUIRED. Доказательство нужно прислать до proof_until. Есть два способа.

Загрузите видео оплаты

Тем же запросом, что и чек: в поле file передайте видео. Форматы MP4, MOV и WebM, размер до 50 МБ.

Запрос
curl https://api.parallel-pay.com/api/v2/invoices/cm3k8x7y80001z8j4k5m6n7o8/attachments \
  -H "Authorization: Bearer $PARALLEL_TOKEN" \
  -F "file=@payment.mp4"
Вставьте тестовый токен в начале страницы

В ответе приходит заявка в статусе REVIEW и Webhook invoice.in.attachment_received. Parallel проверит видео до review_until и пришлёт результат:

  • Webhook invoice.in.paid. Видео подтвердило оплату.
  • Webhook invoice.in.proof_required. Видео не подтвердило оплату. До proof_until можно загрузить другое.
  • Webhook invoice.in.expired. До proof_until оплата так и не подтвердилась.

Примеры событий. В data.object для краткости показаны только изменившиеся поля, на ваш адрес заявка приходит целиком:

Webhook
{
  "event_id": "3d4e5f60-7182-4c9d-8e0f-2a3b4c5d6e7f",
  "type": "invoice.in.paid",
  "created_at": "2026-11-09T12:20:00+03:00",
  "data": {
    "object": {
      "attachments": [
        // { …чек из шага 3, без изменений },
        {
          "attachment_id": "cm3k9d4e60004z8j4u5v6w7x8",
          "type": "VIDEO",
          "file_name": "payment.mp4",
          "file_url": "https://api.parallel-pay.com/files/attachments/cm3k9d4e60004z8j4u5v6w7x8/payment.mp4?expires=1795332000&signature=0b7e1c9a4d2f68e3b5a7c9d1e3f5a7b9c1d3e5f7a9b1c3d5e7f9a1b3c5d7e9f1",
          "received_at": "2026-11-09T12:10:00+03:00",
          "status": "PASSED",
          "checked_at": "2026-11-09T12:20:00+03:00"
        }
      ],
      "status": "PAID",
      "paid_amount": "1000",
      "paid_at": "2026-11-09T12:20:00+03:00"
    },
    "previous": {
      "attachments": [
        // { …чек из шага 3 },
        {
          "attachment_id": "cm3k9d4e60004z8j4u5v6w7x8",
          "type": "VIDEO",
          "file_name": "payment.mp4",
          "file_url": "https://api.parallel-pay.com/files/attachments/cm3k9d4e60004z8j4u5v6w7x8/payment.mp4?expires=1795332000&signature=0b7e1c9a4d2f68e3b5a7c9d1e3f5a7b9c1d3e5f7a9b1c3d5e7f9a1b3c5d7e9f1",
          "received_at": "2026-11-09T12:10:00+03:00",
          "status": "CHECKING"
        }
      ],
      "status": "REVIEW",
      "review_until": "2026-11-09T12:25:00+03:00",
      "paid_amount": null,
      "paid_at": null
    }
  }
}

Или возьмите заявку под финансовую ответственность

Вы сами подтверждаете оплату, полную или частичную, и отвечаете за неё. В запросе укажите сумму, на которую зачитывается вся заявка. Заявка сразу переходит в PAID, приходит Webhook invoice.in.paid. Это можно сделать, пока заявка в статусе IN_PROGRESS, REVIEW или PROOF_REQUIRED, в том числе без чека.

Запрос
curl https://api.parallel-pay.com/api/v2/invoices/cm3k8x7y80001z8j4k5m6n7o8/take_financial_responsibility \
  -H "Authorization: Bearer $PARALLEL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"amount": "1000"}'
amountstring

На сколько рублей зачитывается вся заявка: больше уже подтверждённого чеками paid_amount и не больше суммы заявки

В ответе приходит заявка в статусе PAID с полем financial_responsibility. Показаны только изменившиеся поля:

Ответ 200
{
  "updated_at": "2026-11-09T12:15:00+03:00",
  "status": "PAID",
  "paid_amount": "1000",
  "paid_at": "2026-11-09T12:15:00+03:00",
  "financial_responsibility": {
    "amount": "1000",
    "taken_at": "2026-11-09T12:15:00+03:00"
  }
}

Взять заявку под финансовую ответственность можно один раз. Повтор с той же суммой вернёт ту же заявку, с другой суммой вернёт ошибку 409 с кодом FINANCIAL_RESPONSIBILITY_ALREADY_TAKEN.

Диспут

Если заявка зачтена под вашу финансовую ответственность, а деньги на реквизиты не пришли или пришли не полностью, Parallel может открыть диспут: приходит Webhook invoice.in.dispute.opened. Заявка переходит в статус DISPUTE, зачтённая сумма замораживается на балансе.

Итог приходит Webhook invoice.in.dispute.closed: заявка становится PAID на сумму, которая пришла на самом деле, или CHARGEBACK, если не пришло ничего.

received_amountstring

Сколько на самом деле пришло на реквизиты заявки; "0" — ничего

messagestring

Что случилось

file_namestring

Наша выписка по реквизитам

file_urlstring

Ссылка на выписку, действует 7 дней

opened_atstring

Получить заявку

Заявку можно запросить в любой момент: ответ совпадает с data.object последнего события.

Запрос
curl https://api.parallel-pay.com/api/v2/invoices/cm3k8x7y80001z8j4k5m6n7o8 \
  -H "Authorization: Bearer $PARALLEL_TOKEN"

Список заявок, например пять последних. Фильтры по статусу и дате — в справочнике API.

Запрос
curl "https://api.parallel-pay.com/api/v2/invoices?direction=IN&limit=5" \
  -H "Authorization: Bearer $PARALLEL_TOKEN"

Отменить заявку

Вы можете отменить заявку, если оплата по ней точно не ожидается. В ответе приходит заявка в статусе CANCELED и Webhook invoice.in.canceled.

Запрос
curl -X POST https://api.parallel-pay.com/api/v2/invoices/cm3k8x7y80001z8j4k5m6n7o8/cancel \
  -H "Authorization: Bearer $PARALLEL_TOKEN"

Условия магазина (SLA)

Возвращает условия вашего магазина и текущий курс.

Запрос
curl https://api.parallel-pay.com/api/v2/sla \
  -H "Authorization: Bearer $PARALLEL_TOKEN"
Ответ 200
{
  "shop_id": "cm2abc123def456ghi789jkl0",
  "shop_name": "Мой магазин",
  "testnet": false,
  "out": ,
  "in": {
    "rate": "95.5",
    "default_receipt_delivery": "UPLOAD",
    "requisites_wait_minutes": 10,
    "pay_minutes": 60,
    "review_minutes": 15,
    "proof_minutes": 60,
    "proof_options": ["FINANCIAL_RESPONSIBILITY", "VIDEO", "PDF"]
  }
}
shop_idstring

Номер вашего магазина в Parallel

shop_namestring

Название вашего магазина

testnetboolean

true — запрос с тестовым токеном: деньги не настоящие

outobjectнеобязательное

Заявки на выход (OUT)

Поля out
ratestring

Курс USDT/RUB, по которому сейчас создастся заявка

pay_minutesnumber

За сколько минут мы переводим деньги получателю: pay_until

dispute_daysnumberнеобязательное

Сколько дней после paid_at можно открыть диспут. Есть, только если диспуты разрешены вашему магазину

dispute_minutesnumberнеобязательное

За сколько минут Parallel проверяет выписку (review_until); столько же у вас на другую выписку (statement_until). Есть, только если диспуты разрешены вашему магазину

inobject

Заявки на вход (IN)

Поля in
ratestring

Курс USDT/RUB, по которому сейчас создастся заявка

default_receipt_delivery"BANK_EMAIL" | "UPLOAD"

Как к нам попадёт чек, если не указать receipt_delivery при создании заявки

requisites_wait_minutesnumber

Сколько минут заявка ждёт реквизиты в статусе NEW: requisites_until. 0 — не ждёт: если реквизитов сразу нет, ответ 503 NO_REQUISITES

pay_minutesnumber

Сколько минут у клиента на оплату: pay_until

review_minutesnumber

Сколько минут мы проверяем видео оплаты: review_until

proof_minutesnumber

Сколько минут у клиента на дополнительное доказательство оплаты: proof_until

proof_options("BANK_EMAIL" | "FINANCIAL_RESPONSIBILITY" | "PDF" | "VIDEO")[]

Способы подтвердить оплату, подключённые вашему магазину, от самого надёжного к менее надёжному:

  • FINANCIAL_RESPONSIBILITY — взять оплату под финансовую ответственность;
  • BANK_EMAIL — чек на почту заявки (receipt_delivery: "BANK_EMAIL");
  • VIDEO — видео оплаты;
  • PDF — чек PDF из банка.

События Webhook

СобытиеКогда приходитСтатус заявки
invoice.in.requisites_issuedВыданы реквизиты заявке, которая их ждалаIN_PROGRESS
invoice.in.attachment_receivedПришёл файл на проверкуREVIEW
invoice.in.attachment_rejectedЧек не подтвердил оплату, а дополнительное доказательство не запрашивается: чек на почту или магазину оно не подключено. Ждём другой чекIN_PROGRESS
invoice.in.proof_requiredЧек не подтвердил оплату, нужно видео или финансовая ответственностьPROOF_REQUIRED
invoice.in.partially_paidЧек подтвердил часть суммы, клиент может доплатитьIN_PROGRESS с paid_amount
invoice.in.paidОплата подтвержденаPAID
invoice.in.expiredСрок вышел без оплатыEXPIRED
invoice.in.canceledЗаявка отмененаCANCELED
invoice.in.dispute.openedParallel открыл диспутDISPUTE
invoice.in.dispute.closedДиспут решёнPAID или CHARGEBACK

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