Создать заявку
Создаёт заявку на вход или на выход: их различает поле direction. Повторный запрос с тем же internal_id не
создаёт новую заявку, а возвращает уже созданную.
bearerАвторизацияBearer <токен>Токен магазина: заголовок Authorization: Bearer <токен>
application/json- body
internal_id*stringНомер заявки в вашей системе. Защищает от случайного повторного создания: повтор с тем же internal_id вернёт уже созданную заявку
direction*"IN"Направление: IN — заявка на вход: клиент переводит рубли на реквизиты Parallel
"IN"amount*stringСумма в рублях: "1000"
currency*"RUB""RUB"method?stringСпособ оплаты: SBP — по СБП, TO_CARD — на карту. Без него подойдёт любой. Выбирать способ оплаты можно, только если это разрешено вашему магазину, иначе — 403 METHOD_CHOICE_DISABLED
"SBP""TO_CARD"bank?stringБанк реквизитов. Без него подойдёт любой доступный. Выбирать банк можно, только если это разрешено вашему магазину, иначе — 403 BANK_CHOICE_DISABLED
receipt_delivery?stringКак к нам попадёт чек: BANK_EMAIL — с почты Т-Банка, UPLOAD — вы загрузите сами. Без него — default_receipt_delivery из GET /api/v2/sla
"BANK_EMAIL""UPLOAD"Заявка с этим internal_id уже есть: в ответе она
application/json- response
internal_id*stringНомер заявки в вашей системе
invoice_id*stringНомер заявки в Parallel
direction*"OUT"OUT — заявка на выход
"OUT"created_at*stringupdated_at*stringВремя последнего изменения. Webhook по одной заявке приходят по порядку; если сравниваете сами, сравнивайте по этому полю
amount*stringСумма заявки
currency*"RUB""RUB"deal_rate*stringКурс USDT/RUB заявки: столько рублей стоит 1 USDT на вашем балансе
requisites*|Реквизиты получателя
paid_amount*stringСколько рублей получатель получил по этой заявке. Растёт с каждым чеком; после диспута может быть уменьшена
max_receipts*numberМаксимальное число переводов по заявке
receipts*array<>Чеки наших переводов в порядке оплаты. Сумму можем перевести частями, тогда чеков несколько
status*stringIN_PROGRESS— Переводим деньги получателю доpay_until. На каждый новый чек приходитinvoice.out.receipt_addedPAID— Оплачена: получателю переведеноpaid_amountрублей, USDT за эту сумму списаны с баланса. Если переведена только часть,paid_amountменьшеamount, причина указана вpartial, а USDT за остаток возвращены на балансDISPUTE— Вы открыли диспут: получателю пришло меньше, чем в чеках. Чей ход и до какого срока — вdispute.statusEXPIRED— Кpay_untilне переведено ничего, USDT возвращены на баланс. Окончательный статусCANCELED— Мы не смогли перевести ничего: реквизиты получателя не принимают перевод. USDT возвращены на баланс. Окончательный статус. Отменить заявку на выход сами вы не можете
"IN_PROGRESS""PAID""DISPUTE""EXPIRED""CANCELED"pay_until?stringДо этого времени мы переведём деньги: pay_minutes из GET /api/v2/sla с создания заявки или с решения диспута
Есть в статусе IN_PROGRESS.
dispute?Есть, если диспут принят с REPAY: переводим недостающее, paid_amount — сколько получатель получил
Есть, если по заявке был диспут
Есть в статусе IN_PROGRESS, PAID или DISPUTE.
paid_at?stringЕсть в статусе PAID или DISPUTE.
partial?Есть, если мы перевели меньше суммы заявки
Есть в статусе PAID.
expired_at?stringЕсть в статусе EXPIRED.
canceled_at?stringЕсть в статусе CANCELED.
cancellation?Есть в статусе CANCELED.
curl -X POST 'https://api.parallel-pay.com/api/v2/invoices' \ -H 'Content-Type: application/json' \ -d '{ "internal_id": "string", "direction": "IN", "amount": "1000", "currency": "RUB"}'{ "internal_id": "string", "invoice_id": "string", "direction": "OUT", "created_at": "string", "updated_at": "string", "amount": "string", "currency": "RUB", "deal_rate": "string", "requisites": { "method": "TO_CARD", "bank": "string", "bank_name": "string", "full_name": "string", "card_number": "string" }, "paid_amount": "string", "max_receipts": 0, "receipts": [ { "receipt_id": "string", "amount": "string", "file_name": "string", "file_url": "string", "paid_at": "string" } ], "status": "IN_PROGRESS", "pay_until": "string", "dispute": { "received_amount": "string", "resolution": "RECALCULATE", "message": "string", "statements": [ { "file_name": "string", "file_url": "string", "message": "string", "received_at": "string" } ], "opened_at": "string", "status": "REVIEW", "review_until": "string", "request": "string", "statement_until": "string", "decision": "string", "closed_at": "string" }, "paid_at": "string", "partial": { "code": "OTHER", "message": "string", "file_name": "string", "file_url": "string" }, "expired_at": "string", "canceled_at": "string", "cancellation": { "code": "OTHER", "message": "string", "file_name": "string", "file_url": "string" }}