Выплаты клиентам (OUT)
Parallel переводит рубли вашему клиенту и списывает USDT с вашего баланса
Создайте заявку на выплату, чтобы Parallel перевёл рубли вашему клиенту по СБП или на карту. USDT за эту сумму списываются с вашего баланса по курсу заявки.
С тестовым токеном запросы из этой статьи выполняются прямо здесь, без настоящих денег. Токен хранится только в вашем браузере.
Интеграция состоит из трёх шагов:
- Подпишитесь на события Webhook.
- Создайте заявку с реквизитами клиента.
- Получайте чеки переводов на Webhook.
1. Подпишитесь на события Webhook
События по заявкам на выплату приходят на тот же адрес, что и по приёму платежей. Если вы уже подписались на все события, переходите к шагу 2.
Укажите адрес и типы событий, о которых присылать уведомления. Тип можно указать целиком, например
invoice.out.paid, или его началом до точки — тогда придут все события этой группы:
invoice— все события;invoice.out— все события выплат;invoice.out.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"]}'Каждое событие содержит тип type, заявку целиком в data.object и прежние значения изменившихся полей в
data.previous. Список событий — в конце статьи.
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: 8b9c0d1e-2f3a-4b4c-9d5e-6f7a8b9c0d1e{
"event_id": "8b9c0d1e-2f3a-4b4c-9d5e-6f7a8b9c0d1e",
"type": "invoice.out.paid",
"created_at": "2026-11-09T12:45:00+03:00",
"data": {
"object": {
"invoice_id": "cm3k9a1b20005z8j4p6q7r8s9",
"status": "PAID",
"paid_amount": "12000",
"paid_at": "2026-11-09T12:45:00+03:00"
// …остальные поля заявки
},
"previous": {
"status": "IN_PROGRESS",
"pay_until": "2026-11-09T14:00:00+03:00",
"paid_amount": "7000",
"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);internal_idstringНомер заявки в вашей системе
invoice_idstringНомер заявки в Parallel
direction"OUT"OUT — заявка на выход
created_atstringupdated_atstringВремя последнего изменения. Webhook по одной заявке приходят по порядку; если сравниваете сами, сравнивайте по этому полю
amountstringСумма заявки
currency"RUB"deal_ratestringКурс USDT/RUB заявки: столько рублей стоит 1 USDT на вашем балансе
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.
paid_amountstringСколько рублей получатель получил по этой заявке. Растёт с каждым чеком; после диспута может быть уменьшена
max_receiptsnumberМаксимальное число переводов по заявке
receiptsReceipt[]Чеки наших переводов в порядке оплаты. Сумму можем перевести частями, тогда чеков несколько
Поля receipts
receipt_idstringНомер чека в Parallel
amountstringСумма этого перевода
file_namestringfile_urlstringСсылка на чек, действует 7 дней
paid_atstringВремя перевода
status"IN_PROGRESS" | "PAID" | "DISPUTE" | "EXPIRED" | "CANCELED"IN_PROGRESS— Переводим деньги получателю доpay_until. На каждый новый чек приходитinvoice.out.receipt_addedPAID— Оплачена: получателю переведеноpaid_amountрублей, USDT за эту сумму списаны с баланса. Если переведена только часть,paid_amountменьшеamount, причина указана вpartial, а USDT за остаток возвращены на балансDISPUTE— Вы открыли диспут: получателю пришло меньше, чем в чеках. Чей ход и до какого срока — вdispute.statusEXPIRED— Кpay_untilне переведено ничего, USDT возвращены на баланс. Окончательный статусCANCELED— Мы не смогли перевести ничего: реквизиты получателя не принимают перевод. USDT возвращены на баланс. Окончательный статус. Отменить заявку на выход сами вы не можете
pay_untilstringДо этого времени мы переведём деньги: pay_minutes из GET /api/v2/sla с создания заявки или с решения диспута
Есть в статусе IN_PROGRESS.
disputeOpenOutDispute | ClosedOutDisputeЕсть, если диспут принят с REPAY: переводим недостающее, paid_amount — сколько получатель получил
Есть, если по заявке был диспут
Есть в статусе IN_PROGRESS, PAID или DISPUTE.
Поля dispute
received_amountstringСколько, по словам клиента, пришло получателю; "0" — ничего
resolution"RECALCULATE" | "REPAY"Что вы просите сделать с заявкой
messagestringнеобязательноеВаш комментарий
statementsStatement[]Выписки, которые вы приложили, в порядке загрузки
Поля statements
file_namestringfile_urlstringСсылка на выписку, действует 7 дней
messagestringнеобязательноеВаш комментарий к выписке
received_atstringopened_atstringstatus"REVIEW" | "STATEMENT_REQUIRED" | "ACCEPTED" | "REJECTED"REVIEW— Parallel проверяет выпискуSTATEMENT_REQUIRED— Parallel просит другую выписку: что нужно, написано вrequestACCEPTED— Недостача подтвердилась: заявка перевыплачивается или пересчитана, как вы выбрали вresolutionREJECTED— Выписка не подтвердила недостачу, заявка не изменилась
review_untilstringДо этого времени Parallel решит диспут или попросит другую выписку. Если не успеет, диспут примется и заявка пересчитается на received_amount
Есть в статусе REVIEW.
requeststringКакая выписка нужна и почему не подошла прежняя
Есть в статусе STATEMENT_REQUIRED.
statement_untilstringДо этого времени загрузите выписку. Если её не будет, диспут отклонится
Есть в статусе STATEMENT_REQUIRED.
decisionstringРешение Parallel текстом
Есть в статусе ACCEPTED или REJECTED.
closed_atstringЕсть в статусе ACCEPTED или REJECTED.
paid_atstringЕсть в статусе PAID или DISPUTE.
partialOutStopЕсть, если мы перевели меньше суммы заявки
Есть в статусе PAID.
Поля partial
code"OTHER" | "PAY_UNTIL_PASSED" | "REQUISITES_NOT_WORKING"REQUISITES_NOT_WORKING— банк получателя отклонил перевод;PAY_UNTIL_PASSED— вышел срокpay_until;OTHER— другое, подробности вmessage
messagestringfile_namestringнеобязательноеСкриншот ошибки банка, если мы его приложили
file_urlstringнеобязательноеСсылка на скриншот, действует 7 дней
expired_atstringЕсть в статусе EXPIRED.
canceled_atstringЕсть в статусе CANCELED.
cancellationOutStopЕсть в статусе CANCELED.
Поля cancellation
code"OTHER" | "PAY_UNTIL_PASSED" | "REQUISITES_NOT_WORKING"REQUISITES_NOT_WORKING— банк получателя отклонил перевод;PAY_UNTIL_PASSED— вышел срокpay_until;OTHER— другое, подробности вmessage
messagestringfile_namestringнеобязательноеСкриншот ошибки банка, если мы его приложили
file_urlstringнеобязательноеСсылка на скриншот, действует 7 дней
2. Создайте заявку
Parallel переводит деньги получателю в течение срока заявки. Parallel начинает переводить деньги сразу.
Созданную заявку на выплату отменить нельзя.
curl https://api.parallel-pay.com/api/v2/invoices \
-H "Authorization: Bearer $PARALLEL_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"internal_id": "payout-2001",
"direction": "OUT",
"amount": "12000",
"currency": "RUB",
"requisites": {
"method": "SBP",
"bank": "sberbank",
"full_name": "Иван Иванович И.",
"phone_number": "+79001234567"
}
}'Поля запроса:
internal_idstringНомер заявки в вашей системе. Защищает от случайного повторного создания: повтор с тем же internal_id вернёт уже созданную заявку
direction"OUT"OUT — заявка на выход: Parallel переводит рубли вашему клиенту
amountstringСумма в рублях, которую получит клиент: "12000"
currency"RUB"requisitesRecipientRequisitesКуда перевести деньги
Поля requisites
method"SBP" | "TO_CARD"SBP— Перевод по СБП на номерphone_numberTO_CARD— Перевод на картуcard_number
full_namestringИмя получателя, как в банке: "Иван Иванович И."
phone_numberstringТелефон получателя: "+79001234567"
Есть, когда method — SBP.
card_numberstringНомер карты получателя: только цифры, "2200700012345673"
Есть, когда method — TO_CARD.
В ответе приходит заявка в статусе IN_PROGRESS. USDT за её сумму
замораживаются на балансе.
{
"internal_id": "payout-2001",
"invoice_id": "cm3k9a1b20005z8j4p6q7r8s9",
"direction": "OUT",
"created_at": "2026-11-09T12:00:00+03:00",
"updated_at": "2026-11-09T12:00:00+03:00",
"amount": "12000",
"currency": "RUB",
"deal_rate": "93.1",
"requisites": {
"method": "SBP",
"bank": "sberbank",
"bank_name": "Сбербанк",
"full_name": "Иван Иванович И.",
"phone_number": "+79001234567"
},
"paid_amount": "0",
"max_receipts": 3,
"receipts": [],
"status": "IN_PROGRESS",
"pay_until": "2026-11-09T14:00:00+03:00"
}Если на балансе не хватает доступных USDT, API отвечает 409 INSUFFICIENT_BALANCE.
3. Получайте чеки на Webhook
Parallel может перевести сумму частями, не больше max_receipts переводов. После каждого перевода приходит Webhook
invoice.out.receipt_added: в receipts добавляется чек, paid_amount растёт. Когда переведена вся сумма, приходит Webhook
invoice.out.paid с последним чеком.
Поле amount содержит изначальную сумму заявки и не меняется.
Поле paid_amount содержит сумму, которую получатель уже получил.
Списание USDT считается по paid_amount.
Примеры событий. В data.object для краткости показаны только изменившиеся поля, на ваш адрес заявка приходит
целиком:
{
"event_id": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d",
"type": "invoice.out.receipt_added",
"created_at": "2026-11-09T12:20:00+03:00",
"data": {
"object": {
"paid_amount": "7000",
"receipts": [
{
"receipt_id": "cm3k9c4d50006z8j4t7u8v9w0",
"amount": "7000",
"file_name": "receipt-1.pdf",
"file_url": "https://api.parallel-pay.com/files/cm3k9c4d50006z8j4t7u8v9w0",
"paid_at": "2026-11-09T12:20:00+03:00"
}
],
"status": "IN_PROGRESS",
"pay_until": "2026-11-09T14:00:00+03:00"
},
"previous": {
"paid_amount": "0",
"receipts": []
}
}
}Статус заявки:
IN_PROGRESS. Переводы продолжаются доpay_until.PAID. Получателю переведена вся сумма заявки.
Поля чека:
receipt_idstringНомер чека в Parallel
amountstringСумма этого перевода
file_namestringfile_urlstringСсылка на чек, действует 7 дней
paid_atstringВремя перевода
Если реквизиты не принимают перевод
- Реквизиты не принимают перевод, не переведено ничего. Приходит Webhook
invoice.out.canceled, заявка переходит вCANCELED, кcancellationприложен скриншот ошибки банка. USDT возвращаются на баланс. - Переведена часть суммы. Приходит Webhook
invoice.out.paid, заявка переходит вPAID, вpaid_amountуказана переведённая сумма. USDT списываются только за неё, остаток возвращается на баланс. Причина указана в полеpartial: банк получателя отклонил перевод (REQUISITES_NOT_WORKING) или вышел срок (PAY_UNTIL_PASSED). - Срок вышел, не переведено ничего. Приходит Webhook
invoice.out.expired, заявка переходит вEXPIRED, USDT возвращаются на баланс.
{
"event_id": "0d1e2f3a-4b5c-4d6e-9f7a-8b9c0d1e2f3a",
"type": "invoice.out.canceled",
"created_at": "2026-11-09T12:10:00+03:00",
"data": {
"object": {
"status": "CANCELED",
"canceled_at": "2026-11-09T12:10:00+03:00",
"cancellation": {
"code": "REQUISITES_NOT_WORKING",
"message": "Банк получателя отклонил перевод",
"file_name": "error.png",
"file_url": "https://api.parallel-pay.com/files/cm3k9g8h90008z8j4b9c0d1e2"
}
},
"previous": {
"status": "IN_PROGRESS",
"pay_until": "2026-11-09T14:00:00+03:00",
"canceled_at": null,
"cancellation": null
}
}
}Диспут
В случае недостачи откройте диспут.
Укажите, какую сумму получил клиент и что хотите сделать с заявкой: пересчитать или перевыплатить. Приложите выписку из банка.
curl https://api.parallel-pay.com/api/v2/invoices/cm3k9a1b20005z8j4p6q7r8s9/dispute \
-H "Authorization: Bearer $PARALLEL_TOKEN" \
-F received_amount=7000 \
-F resolution=REPAY \
-F file=@statement.pdfreceived_amountstringСколько, по словам клиента, пришло получателю; "0" — ничего
resolution"RECALCULATE" | "REPAY"Что сделать с заявкой: REPAY — перевести получателю недостающее, RECALCULATE — пересчитать заявку
fileфайлВыписка получателя из банка за день перевода: PDF или изображение, до 10 МБ
messagestringнеобязательноеКомментарий, если нужен
Заявка переходит в статус DISPUTE, приходит Webhook invoice.out.dispute.opened.
Статус диспута
Статус указан в поле dispute.status:
REVIEW. Parallel проверяет выписку доdispute.review_until.STATEMENT_REQUIRED. Выписка не подошла. Загрузите другую выписку по указаниям вdispute.requestдоdispute.statement_until.ACCEPTED. Недостача подтвердилась. Заявка возвращается вIN_PROGRESSна перевыплату или переходит вPAIDс пересчётом.REJECTED. Недостача не подтвердилась, заявка возвращается вPAIDбез изменений.
Запрос актуальной выписки
Если выписка вызывает сомнения, например сформирована раньше перевода, Parallel может попросить новую выписку или другое доказательство оплаты.
Следите за Webhook invoice.out.dispute.statement_required: в dispute.request
написано, какая выписка нужна и почему не подошла прежняя.
Загрузите выписку до dispute.statement_until. Диспут вернётся в статус REVIEW, выписка добавится в
dispute.statements, приходит Webhook invoice.out.dispute.statement_received.
curl https://api.parallel-pay.com/api/v2/invoices/cm3k9a1b20005z8j4p6q7r8s9/dispute/statements \
-H "Authorization: Bearer $PARALLEL_TOKEN" \
-F file=@statement.pdffileфайлВыписка получателя из банка: PDF или изображение, до 10 МБ
messagestringнеобязательноеКомментарий, если нужен
Примеры событий. В data.object для краткости показаны только изменившиеся поля, на ваш адрес заявка приходит
целиком:
{
"event_id": "3a4b5c6d-7e8f-4a9b-8c0d-2e3f4a5b6c7d",
"type": "invoice.out.dispute.statement_required",
"created_at": "2026-11-12T10:40:00+03:00",
"data": {
"object": {
"status": "DISPUTE",
"dispute": {
// …поля диспута, без изменений
"status": "STATEMENT_REQUIRED",
"request": "Выписка сформирована до перевода. Пришлите выписку за 09.11, сформированную после 12:45",
"statement_until": "2026-11-12T12:40:00+03:00"
}
},
"previous": {
"dispute": {
"status": "REVIEW",
"review_until": "2026-11-12T12:00:00+03:00",
"request": null,
"statement_until": null
}
}
}
}Итог диспута
Когда диспут закрыт, приходит Webhook invoice.out.dispute.closed. В dispute.status указано ACCEPTED или
REJECTED, в dispute.decision — объяснение Parallel.
Если диспут принят, с заявкой происходит то, что вы выбрали в dispute.resolution:
REPAY, перевыплата. Заявка возвращается вIN_PROGRESSс новым срокомpay_until,paid_amountуменьшается доreceived_amount. Parallel переводит недостающее по обычным правилам выплаты.RECALCULATE, пересчёт. Заявка переходит вPAID,paid_amountуменьшается доreceived_amount, USDT за разницу возвращаются на баланс.
Если Parallel не проверил выписку до dispute.review_until, диспут принимается с пересчётом в вашу пользу. Если вы не
прислали выписку до dispute.statement_until, диспут отклоняется.
Пример
Выплата 12 000 ₽ прошла двумя переводами, клиент говорит, что получил 7 000 ₽, вы просите REPAY. В
data.object для краткости показаны только изменившиеся поля.
{
"event_id": "2f3a4b5c-6d7e-4f8a-9b0c-1d2e3f4a5b6c",
"type": "invoice.out.dispute.opened",
"created_at": "2026-11-12T10:00:00+03:00",
"data": {
"object": {
"status": "DISPUTE",
"dispute": {
"received_amount": "7000",
"resolution": "REPAY",
"statements": [
{
"file_name": "statement.pdf",
"file_url": "https://api.parallel-pay.com/files/disputes/cm3k9j0k10009z8j4f0g1h2i3/statement.pdf",
"received_at": "2026-11-12T10:00:00+03:00"
}
],
"opened_at": "2026-11-12T10:00:00+03:00",
"status": "REVIEW",
"review_until": "2026-11-12T12:00:00+03:00"
}
},
"previous": {
"status": "PAID",
"dispute": null
}
}
}Поля диспута:
received_amountstringСколько, по словам клиента, пришло получателю; "0" — ничего
resolution"RECALCULATE" | "REPAY"Что вы просите сделать с заявкой
messagestringнеобязательноеВаш комментарий
statementsStatement[]Выписки, которые вы приложили, в порядке загрузки
Поля statements
file_namestringfile_urlstringСсылка на выписку, действует 7 дней
messagestringнеобязательноеВаш комментарий к выписке
received_atstringopened_atstringstatus"REVIEW" | "STATEMENT_REQUIRED" | "ACCEPTED" | "REJECTED"REVIEW— Parallel проверяет выпискуSTATEMENT_REQUIRED— Parallel просит другую выписку: что нужно, написано вrequestACCEPTED— Недостача подтвердилась: заявка перевыплачивается или пересчитана, как вы выбрали вresolutionREJECTED— Выписка не подтвердила недостачу, заявка не изменилась
review_untilstringДо этого времени Parallel решит диспут или попросит другую выписку. Если не успеет, диспут примется и заявка пересчитается на received_amount
Есть в статусе REVIEW.
requeststringКакая выписка нужна и почему не подошла прежняя
Есть в статусе STATEMENT_REQUIRED.
statement_untilstringДо этого времени загрузите выписку. Если её не будет, диспут отклонится
Есть в статусе STATEMENT_REQUIRED.
decisionstringРешение Parallel текстом
Есть в статусе ACCEPTED или REJECTED.
closed_atstringЕсть в статусе ACCEPTED или REJECTED.
Получить заявку
Заявку можно запросить в любой момент: ответ совпадает с data.object последнего события.
curl https://api.parallel-pay.com/api/v2/invoices/cm3k9a1b20005z8j4p6q7r8s9 \
-H "Authorization: Bearer $PARALLEL_TOKEN"Список заявок, например пять последних. Фильтры по статусу и дате — в справочнике API.
curl "https://api.parallel-pay.com/api/v2/invoices?direction=OUT&limit=5" \
-H "Authorization: Bearer $PARALLEL_TOKEN"Условия магазина (SLA)
Возвращает условия вашего магазина и текущий курс. Условия выплат находятся в поле out.
curl https://api.parallel-pay.com/api/v2/sla \
-H "Authorization: Bearer $PARALLEL_TOKEN"{
"shop_id": "cm2abc123def456ghi789jkl0",
"shop_name": "Мой магазин",
"testnet": false,
"out": {
"rate": "93.1",
"pay_minutes": 120,
"dispute_days": 30,
"dispute_minutes": 120
},
"in":
}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.out.receipt_added | Новый чек перевода | IN_PROGRESS |
invoice.out.paid | Переводы закончены: переведена вся сумма или часть | PAID |
invoice.out.expired | Срок вышел, не переведено ничего | EXPIRED |
invoice.out.canceled | Реквизиты не принимают перевод, не переведено ничего | CANCELED |
invoice.out.dispute.opened | Вы открыли диспут | DISPUTE |
invoice.out.dispute.statement_required | Parallel просит другую выписку | DISPUTE |
invoice.out.dispute.statement_received | Вы загрузили выписку, которую попросили | DISPUTE |
invoice.out.dispute.closed | Parallel решил диспут: принял или отклонил | PAID или IN_PROGRESS |