Приём платежей (IN)
Клиент переводит рубли на реквизиты Parallel, вы получаете USDT на баланс
Ваш клиент переводит рубли по СБП или на карту на реквизиты, которые выдаёт Parallel. Вы получаете USDT на баланс по курсу заявки.
С тестовым токеном запросы из этой статьи выполняются прямо здесь, без настоящих денег. Токен хранится только в вашем браузере.
Интеграция состоит из четырёх шагов:
- Подпишитесь на события Webhook.
- Создайте заявку. Покажите реквизиты клиенту.
- Клиент оплачивает и присылает чек до конца срока заявки. Загрузите чек.
- Если чек не подтвердил оплату, загрузите видео оплаты или возьмите заявку под свою финансовую ответственность.
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"]}'{
"url": "https://example.com/webhooks/parallel",
"events": ["invoice"],
"secret": "whsec_Jq7tKx2mVb9pLr4sWn8yDc3fHg6zQa1eUo5iTk0RvXw"
}Сохраните secret: им подписано каждое событие.
Что приходит на ваш адрес
Parallel отправляет объект события на ваш адрес запросом POST. Поле type содержит тип события, data.object — обновлённый объект заявки целиком, а data.previous — прежние значения полей, которые изменились.
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 содержат только изменившиеся ключи, список — прежний целиком.
event_idstringНомер события
type"invoice.in.attachment_received" | "invoice.in.attachment_rejected" | "invoice.in.canceled" | "invoice.in.dispute.closed" | "invoice.in.dispute.opened" | "invoice.in.expired" | "invoice.in.paid" | "invoice.in.partially_paid" | "invoice.in.proof_required" | "invoice.in.requisites_issued" | "invoice.out.canceled" | "invoice.out.dispute.closed" | "invoice.out.dispute.opened" | "invoice.out.dispute.statement_received" | "invoice.out.dispute.statement_required" | "invoice.out.expired" | "invoice.out.paid" | "invoice.out.receipt_added"created_atstringКогда произошло событие
dataobjectПоля data
objectInvoiceЗаявка на момент события
Поля object
internal_idstringНомер заявки в вашей системе
invoice_idstringНомер заявки в Parallel
direction"OUT" | "IN"OUT — заявка на выход
Направление: IN — заявка на вход: клиент переводит рубли на реквизиты Parallel
created_atstringupdated_atstringВремя последнего изменения. Webhook по одной заявке приходят по порядку; если сравниваете сами, сравнивайте по этому полю
amountstringСумма заявки
currency"RUB"attachmentsAttachment[]необязательноеФайлы по заявке — чеки и видео оплаты — в порядке получения
Поля attachments
attachment_idstringНомер файла в Parallel
type"IMAGE" | "PDF" | "VIDEO"PDF — чек из банка, IMAGE — скриншот, VIDEO — видео оплаты
file_namestringfile_urlstringСсылка на файл, действует 7 дней
received_atstringstatus"CHECKING" | "PASSED" | "FAILED"CHECKING— Файл на проверке, результат придёт на WebhookPASSED— Файл подтверждает оплатуFAILED— Файл не подтверждает оплату, почему — вfailure_reason
checked_atstringЕсть в статусе PASSED или FAILED.
transferTransferЧто прочитано из файла. Есть, если файл удалось прочитать
Есть в статусе PASSED или FAILED.
Поля transfer
amountstring | nullСумма перевода
atstring | nullВремя перевода
bank_statusstring | nullСтатус перевода в чеке как есть, словами банка: "Успешно", "В обработке"
operation_idstring | nullНомер операции в банке
fromobjectОтправитель: банк и имя
Поля from
bankstring | nullnamestring | nulltoobjectПолучатель: куда ушёл перевод
Поля to
method"SBP" | "TO_CARD" | nullbankstring | nullnamestring | nullphone_numberstring | nullcard_numberstring | nullfailure_reasonAttachmentFailureReasonЕсть в статусе FAILED.
Поля failure_reason
code"DUPLICATE" | "FAKE" | "NOT_COMPLETED" | "UNREADABLE" | "WRONG_RECIPIENT"FAKE— файл похож на подделку;UNREADABLE— не удалось распознать банк или формат;NOT_COMPLETED— перевод не завершён: например, «В обработке»; банк может его отменить;WRONG_RECIPIENT— перевод на другие реквизиты;DUPLICATE— этим чеком уже закрыта другая заявка
messagestringdeal_ratestringнеобязательноеКурс USDT/RUB заявки: столько рублей стоит 1 USDT на вашем балансе
Курс USDT/RUB заявки, если он уже известен. Иначе появится вместе с реквизитами
requisitesRequisitesнеобязательноеРеквизиты получателя
Реквизиты, на которые платит клиент
Поля requisites
method"SBP" | "TO_CARD"SBP— Перевод по СБП на номерphone_numberTO_CARD— Перевод на картуcard_number
bankstringКод банка. В заявке на выход без банка в запросе — определённый по номеру карты, а если не определили — "unknown"
Код банка
bank_namestringНазвание банка для клиента; при bank: "unknown" — "Неизвестный банк"
Название банка для клиента
full_namestringИмя получателя латиницей
phone_numberstringТелефон получателя: + и цифры, "+79001234567"
Есть, когда method — SBP.
card_numberstringНомер карты получателя: только цифры, "2200700012345673"
Есть, когда method — TO_CARD.
receipt_emailstringнеобязательноеПочта для чека, своя у каждой заявки. Есть, только если чек придёт на почту (receipt_delivery: "BANK_EMAIL")
payer_warningstringнеобязательноеТекст для клиента: платить только из приложения Т-Банка и отправить чек на receipt_email. Покажите его рядом с реквизитами
financial_responsibilityFinancialResponsibilityнеобязательноеЕсть, если вы взяли оплату под финансовую ответственность
Поля financial_responsibility
amountstringСколько рублей вы зачли на свою ответственность
taken_atstringstatus"NEW" | "IN_PROGRESS" | "REVIEW" | "PROOF_REQUIRED" | "PAID" | "DISPUTE" | "CHARGEBACK" | "EXPIRED" | "CANCELED"NEW— Ищем реквизиты доrequisites_until. Нашли — заявка переходит вIN_PROGRESSсrequisitesиpay_until, придёт WebhookIN_PROGRESS— Ждём оплату от клиента доpay_untilREVIEW— Проверяем файл доreview_until, результат придёт на WebhookPROOF_REQUIRED— Чек не подтвердил оплату. Доproof_untilпришлите видео оплаты или возьмите заявку под финансовую ответственностьPAID— Оплачена: зачтеноpaid_amountрублей, USDT на вашем балансеDISPUTE— Открыт диспут: на реквизиты пришло меньше, чем зачтено. Зачтённое заморожено до решенияCHARGEBACK— Диспут решён: денег не пришло, зачтённое списано с балансаEXPIRED— Срок вышел, а оплата так и не подтвердилась. Окончательный статусCANCELED— Отменена. Окончательный статус
requisites_untilstringДо этого времени ищем реквизиты, иначе заявка отменится с NO_REQUISITES
Есть в статусе NEW.
pay_untilstringДо этого времени мы переведём деньги: pay_minutes из GET /api/v2/sla с создания заявки или с решения диспута
До этого времени клиент должен заплатить, а вы загрузить чек. Считается от выдачи реквизитов
Есть в статусе IN_PROGRESS.
paid_amountstringнеобязательноеСколько рублей получатель получил по этой заявке. Растёт с каждым чеком; после диспута может быть уменьшена
Есть, если чеки подтвердили часть суммы заявки. Клиент может доплатить до pay_until; не доплатил — заявка переходит в PAID на эту сумму
Сколько рублей зачтено. Меньше amount, если к pay_until клиент заплатил меньше или вы взяли под финансовую ответственность меньшую сумму
review_untilstringДо этого времени мы проверим файл: review_minutes из GET /api/v2/sla с последнего полученного
Есть в статусе REVIEW.
proof_untilstringДо этого времени загрузите видео оплаты или возьмите заявку под финансовую ответственность, иначе заявка истечёт
Есть в статусе PROOF_REQUIRED.
paid_atstringЕсть в статусе PAID или DISPUTE.
disputeOpenOutDispute | ClosedOutDispute | ClosedDispute | DisputeнеобязательноеЕсть, если диспут принят с REPAY: переводим недостающее, paid_amount — сколько получатель получил
Есть, если по заявке был диспут
Поля dispute
received_amountstringСколько, по словам клиента, пришло получателю; "0" — ничего
Сколько на самом деле пришло на реквизиты заявки; "0" — ничего
messagestringнеобязательноеВаш комментарий
Что случилось
file_namestringнеобязательноеНаша выписка по реквизитам
file_urlstringнеобязательноеСсылка на выписку, действует 7 дней
opened_atstringclosed_atstringнеобязательноеresolution"RECALCULATE" | "REPAY"необязательноеЧто вы просите сделать с заявкой
statementsStatement[]необязательноеВыписки, которые вы приложили, в порядке загрузки
Поля statements
file_namestringfile_urlstringСсылка на выписку, действует 7 дней
messagestringнеобязательноеВаш комментарий к выписке
received_atstringstatus"REVIEW" | "STATEMENT_REQUIRED" | "ACCEPTED" | "REJECTED"необязательноеParallel проверяет выписку
Parallel просит другую выписку: что нужно, написано в request
Недостача подтвердилась: заявка перевыплачивается или пересчитана, как вы выбрали в resolution
Выписка не подтвердила недостачу, заявка не изменилась
review_untilstringнеобязательноеДо этого времени Parallel решит диспут или попросит другую выписку. Если не успеет, диспут примется и заявка пересчитается на received_amount
requeststringнеобязательноеКакая выписка нужна и почему не подошла прежняя
statement_untilstringнеобязательноеДо этого времени загрузите выписку. Если её не будет, диспут отклонится
decisionstringнеобязательноеРешение Parallel текстом
chargeback_atstringЕсть в статусе CHARGEBACK.
expired_atstringЕсть в статусе EXPIRED.
canceled_atstringЕсть в статусе CANCELED.
cancellationOutStop | { code: "CANCELED_BY_MERCHANT" | "NO_REQUISITES"; message: string; } | CancellationЕсть в статусе CANCELED.
Поля cancellation
code"OTHER" | "PAY_UNTIL_PASSED" | "REQUISITES_NOT_WORKING" | "CANCELED_BY_MERCHANT" | "NO_REQUISITES" | "CANCELED_BY_MERCHANT" | "OTHER" | "REQUISITES_NOT_WORKING"REQUISITES_NOT_WORKING— банк получателя отклонил перевод;PAY_UNTIL_PASSED— вышел срокpay_until;OTHER— другое, подробности вmessage
CANCELED_BY_MERCHANT— вы отменили заявку;NO_REQUISITES— реквизиты не нашлись кrequisites_until
CANCELED_BY_MERCHANT— вы отменили заявку;REQUISITES_NOT_WORKING— реквизиты не принимают перевод;OTHER— другое, подробности вmessage
messagestringfile_namestringнеобязательноеСкриншот ошибки банка, если мы его приложили
Скриншот, если мы его приложили
file_urlstringнеобязательноеСсылка на скриншот, действует 7 дней
max_receiptsnumberнеобязательноеМаксимальное число переводов по заявке
receiptsReceipt[]необязательноеЧеки наших переводов в порядке оплаты. Сумму можем перевести частями, тогда чеков несколько
Поля receipts
receipt_idstringНомер чека в Parallel
amountstringСумма этого перевода
file_namestringfile_urlstringСсылка на чек, действует 7 дней
paid_atstringВремя перевода
partialOutStopнеобязательноеЕсть, если мы перевели меньше суммы заявки
Поля partial
code"OTHER" | "PAY_UNTIL_PASSED" | "REQUISITES_NOT_WORKING"REQUISITES_NOT_WORKING— банк получателя отклонил перевод;PAY_UNTIL_PASSED— вышел срокpay_until;OTHER— другое, подробности вmessage
messagestringfile_namestringнеобязательноеСкриншот ошибки банка, если мы его приложили
file_urlstringнеобязательноеСсылка на скриншот, действует 7 дней
previousRecord<string, unknown>необязательноеПрежние значения полей, которые изменились в заявке.
Поля previous
Ответьте любым кодом 2xx. Если ответа нет, Parallel повторит то же событие через 1, 5 и 30 минут, затем через 2, 6
и 12 часов. У повторов тот же X-Webhook-Delivery-Id, он же event_id. События по одной заявке приходят по порядку.
Заголовок X-Webhook-Signature содержит HMAC-SHA256 от тела запроса с ключом secret, в hex. Проверяйте подпись
до разбора JSON.
import crypto from "node:crypto";
import express from "express";
const app = express();
const secret = process.env.PARALLEL_WEBHOOK_SECRET;
// express.raw: подпись считается от сырого тела, а не от разобранного JSON
app.post("/webhooks/parallel", express.raw({ type: "*/*" }), (req, res) => {
const expected = crypto.createHmac("sha256", secret).update(req.body).digest("hex");
const signature = req.get("X-Webhook-Signature") ?? "";
if (
signature.length !== expected.length ||
!crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected))
) {
return res.status(401).send("invalid signature");
}
const event = JSON.parse(req.body.toString("utf8"));
handleEvent(event); // event.type, event.data.object
res.sendStatus(200);
});
app.listen(3000);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
В ответе приходит заявка с реквизитами. Покажите их клиенту.
{
"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. Повторите запрос позже.
Заявка может прийти в статусе NEW: реквизиты для неё ещё подбираются. В такой заявке нет requisites и
pay_until, а курс deal_rate может появиться позже, вместе с реквизитами.
{
"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",
"attachments": [],
"status": "NEW",
"requisites_until": "2026-11-09T12:10:00+03:00"
}До requisites_until придёт одно из двух событий:
- Webhook
invoice.in.requisites_issued: реквизиты выданы, заявка в статусеIN_PROGRESSсrequisitesиpay_until. Срок оплаты считается от выдачи реквизитов. Покажите реквизиты клиенту; - Webhook
invoice.in.canceled: реквизиты не нашлись, заявка в статусеCANCELEDс кодомNO_REQUISITES. Чтобы попробовать снова, создайте заявку с новымinternal_id.
В data.object для краткости показаны только изменившиеся поля:
{
"event_id": "1b2c3d4e-5f60-4a7b-8c9d-0e1f2a3b4c5d",
"type": "invoice.in.requisites_issued",
"created_at": "2026-11-09T12:04:00+03:00",
"data": {
"object": {
"deal_rate": "95.5",
"requisites": {
"method": "SBP",
"bank": "sberbank",
"bank_name": "Сбербанк",
"full_name": "Ivan I.",
"phone_number": "+79001234567"
},
"status": "IN_PROGRESS",
"pay_until": "2026-11-09T13:04:00+03:00"
// …остальные поля заявки
},
"previous": {
"deal_rate": null,
"requisites": null,
"status": "NEW",
"requisites_until": "2026-11-09T12:10:00+03:00",
"pay_until": null
}
}
}Клиент платит из приложения Т-Банка и сам отправляет чек на почту заявки. Загружать чек не нужно: когда он придёт и
подтвердит оплату, заявка перейдёт в статус PAID.
В такой заявке есть почта для чека receipt_email и текст для клиента payer_warning. Покажите этот текст клиенту
рядом с реквизитами.
{
"internal_id": "order-1002",
"invoice_id": "cm3k8z1a20003z8j4b5c6d7e8",
"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": "TO_CARD",
"bank": "tbank",
"bank_name": "Т-Банк",
"full_name": "Ivan I.",
"card_number": "2200700012345673"
},
"attachments": [],
"receipt_email": "inbox+k7m9q2@example.com",
"payer_warning": "Оплачивайте только из приложения Т-Банка. После оплаты отправьте чек из приложения на inbox+k7m9q2@example.com: без него оплата не зачтётся.",
"status": "IN_PROGRESS",
"pay_until": "2026-11-09T13:00:00+03:00"
}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 и
будет ждать дополнительное доказательство оплаты.
{
"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, Webhookinvoice.in.partially_paid. Чек подтвердил часть суммы. Клиент может доплатить доpay_until.PAID, Webhookinvoice.in.paid. Работа над заявкой завершена: оплачена вся сумма или при частичной оплате вышел срокpay_until.PROOF_REQUIRED, Webhookinvoice.in.proof_required. Чек не подтвердил оплату. Причина указана в полеfailure_reasonчека. Перейдите к шагу 4.
Поля чека:
attachment_idstringНомер файла в Parallel
type"IMAGE" | "PDF" | "VIDEO"PDF — чек из банка, IMAGE — скриншот, VIDEO — видео оплаты
file_namestringfile_urlstringСсылка на файл, действует 7 дней
received_atstringstatus"CHECKING" | "PASSED" | "FAILED"CHECKING— Файл на проверке, результат придёт на WebhookPASSED— Файл подтверждает оплатуFAILED— Файл не подтверждает оплату, почему — вfailure_reason
checked_atstringЕсть в статусе PASSED или FAILED.
transferTransferЧто прочитано из файла. Есть, если файл удалось прочитать
Есть в статусе PASSED или FAILED.
Поля transfer
amountstring | nullСумма перевода
atstring | nullВремя перевода
bank_statusstring | nullСтатус перевода в чеке как есть, словами банка: "Успешно", "В обработке"
operation_idstring | nullНомер операции в банке
fromobjectОтправитель: банк и имя
Поля from
bankstring | nullnamestring | nulltoobjectПолучатель: куда ушёл перевод
Поля to
method"SBP" | "TO_CARD" | nullbankstring | nullnamestring | nullphone_numberstring | nullcard_numberstring | nullfailure_reasonAttachmentFailureReasonЕсть в статусе FAILED.
Поля failure_reason
code"DUPLICATE" | "FAKE" | "NOT_COMPLETED" | "UNREADABLE" | "WRONG_RECIPIENT"FAKE— файл похож на подделку;UNREADABLE— не удалось распознать банк или формат;NOT_COMPLETED— перевод не завершён: например, «В обработке»; банк может его отменить;WRONG_RECIPIENT— перевод на другие реквизиты;DUPLICATE— этим чеком уже закрыта другая заявка
messagestring4. Если чек не подтвердил оплату
Если чек вызывает сомнения, 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 для краткости показаны только изменившиеся поля, на ваш адрес заявка приходит
целиком:
{
"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. Показаны только изменившиеся поля:
{
"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"{
"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Название вашего магазина
testnetbooleantrue — запрос с тестовым токеном: деньги не настоящие
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.opened | Parallel открыл диспут | DISPUTE |
invoice.in.dispute.closed | Диспут решён | PAID или CHARGEBACK |