Parallel

Выплаты клиентам (OUT)

Parallel переводит рубли вашему клиенту и списывает USDT с вашего баланса

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

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

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

  1. Подпишитесь на события Webhook.
  2. Создайте заявку с реквизитами клиента.
  3. Получайте чеки переводов на 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. Список событий — в конце статьи.

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_number
  • TO_CARD — Перевод на карту card_number
bankstring

Банк получателя: код или название, как узнать код

Обязательное, когда method — SBP.

full_namestring

Имя получателя, как в банке: "Иван Иванович И."

phone_numberstring

Телефон получателя: "+79001234567"

Есть, когда method — SBP.

card_numberstring

Номер карты получателя: только цифры, "2200700012345673"

Есть, когда method — TO_CARD.

В ответе приходит заявка в статусе IN_PROGRESS. USDT за её сумму замораживаются на балансе.

Ответ 201
{
  "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 для краткости показаны только изменившиеся поля, на ваш адрес заявка приходит целиком:

Webhook
{
  "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_namestring
file_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 возвращаются на баланс.
Webhook
{
  "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.pdf
₽ пришлоВставьте тестовый токен в начале страницы
received_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.pdf
Вставьте тестовый токен в начале страницы
fileфайл

Выписка получателя из банка: PDF или изображение, до 10 МБ

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

Комментарий, если нужен

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

Webhook
{
  "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 для краткости показаны только изменившиеся поля.

Webhook
{
  "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_namestring
file_urlstring

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

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

Ваш комментарий к выписке

received_atstring
opened_atstring
status"REVIEW" | "STATEMENT_REQUIRED" | "ACCEPTED" | "REJECTED"
  • REVIEW — Parallel проверяет выписку
  • STATEMENT_REQUIRED — Parallel просит другую выписку: что нужно, написано в request
  • ACCEPTED — Недостача подтвердилась: заявка перевыплачивается или пересчитана, как вы выбрали в resolution
  • REJECTED — Выписка не подтвердила недостачу, заявка не изменилась
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"
Ответ 200
{
  "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

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

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.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_requiredParallel просит другую выпискуDISPUTE
invoice.out.dispute.statement_receivedВы загрузили выписку, которую попросилиDISPUTE
invoice.out.dispute.closedParallel решил диспут: принял или отклонилPAID или IN_PROGRESS

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