Создание заявок на прием
Создание заявок на прием платежей от клиентов через Parallel API
Клиент платит только из Т-Банка и отправляет чек из приложения на почту
- Клиент переводит деньги только из приложения Т-Банка — на реквизиты любого банка.
- После перевода клиент отправляет чек из приложения Т-Банка на
receiptEmail— почта своя у каждой заявки.
Без чека из приложения банка заявка не будет выполнена. В H2H-режиме покажите клиенту рядом с реквизитами текст
payerWarning из dealRequisites.
Создание заявки
Endpoint для создания заявки на прием платежа:
Параметры
Поле
Тип
Пример запроса
const response = await fetch('https://api.parallel-pay.com/api/v1/invoices', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': `Bearer ${process.env.PARALLEL_TOKEN}`
},
body: JSON.stringify({
internalId: 'order-12345',
direction: 'in',
amount: 1000,
currency: 'RUB',
startDeal: true,
paymentMethod: 'SBP',
notificationUrl: 'https://your-site.com/webhooks/parallel',
notificationToken: 'your-secret-webhook-token-min-32-chars'
})
});
const result = await response.json();
console.log(result);Пример ответа (H2H интеграция)
HTTP Status: 201 Created
При создании заявки без successUrl, cancelUrl и errorUrl — стандартный H2H-ответ с реквизитами:
{
"id": "cm3k8x7y80001z8j4k5m6n7o8",
"direction": "in",
"status": "new",
"paymentMethod": "SBP",
"paymentOption": "sberbank",
"amount": "1000",
"currency": "RUB",
"expireAt": "2025-11-03T15:15:00.000Z",
"requisiteId": "req_abc123xyz789",
"dealRequisites": "{\"bankName\":\"Сбербанк\",\"fullName\":\"Ivan I.\",\"phoneNumber\":\"79001234567\",\"receiptEmail\":\"inbox+k7m9q2@example.com\",\"payerWarning\":\"Оплачивайте только из приложения Т-Банка. После оплаты отправьте чек из приложения на inbox+k7m9q2@example.com: без него оплата не зачтётся.\"}",
"dealRate": "95.50",
"createdAt": "2025-11-03T15:00:00.000Z",
"updatedAt": "2025-11-03T15:00:00.000Z",
"internalId": "order-12345",
"merchantName": "MerchantName"
}Пример ответа (Redirect интеграция)
HTTP Status: 201 Created
При создании заявки с successUrl, cancelUrl и errorUrl — ответ содержит paymentUrl для редиректа клиента на hosted-страницу оплаты:
{
"id": "cm3k8x7y80001z8j4k5m6n7o8",
"direction": "in",
"status": "new",
"amount": "1000",
"currency": "RUB",
"dealRate": "95.50",
"createdAt": "2025-11-03T15:00:00.000Z",
"updatedAt": "2025-11-03T15:00:00.000Z",
"internalId": "order-12345",
"merchantName": "MerchantName",
"paymentUrl": "https://payment.parallel-pay.com/V1StGXR8_Z5jdHi6B-myT9a2xHplkR4w"
}Поля Redirect-ответа — подмножество объекта заявки плюс paymentUrl. Реквизитов в нём нет: клиент получит их на странице оплаты.
Поле
Тип
Объект заявки
Этот же объект приходит в ответе на создание заявки в H2H-режиме, в проверке статуса и в теле webhook-уведомления.
Поле
Тип
Реквизиты для оплаты
dealRequisites — JSON-строка. После JSON.parse в ней реквизиты получателя (вид зависит от paymentMethod),
receiptEmail и payerWarning. Пример для СБП:
{
"bankName": "Сбербанк",
"fullName": "Ivan I.",
"phoneNumber": "79001234567",
"receiptEmail": "inbox+k7m9q2@example.com",
"payerWarning": "Оплачивайте только из приложения Т-Банка. После оплаты отправьте чек из приложения на inbox+k7m9q2@example.com: без него оплата не зачтётся."
}СБП (SBP)
Поле
Тип
Перевод на карту (TO_CARD)
Поле
Тип
Примеры ошибок
Ошибка: Нет доступных реквизитов
HTTP Status: 503 Service Unavailable
Эта ошибка возникает, когда все реквизиты на эту сумму и метод заняты. Повторите запрос позже или с другой суммой.
{
"error": "Нет доступных реквизитов"
}Ошибка: Курс недоступен
HTTP Status: 503 Service Unavailable
Курс USDT/RUB сейчас получить не удалось, заявка не создана. Повторите запрос позже с тем же internalId.
{
"error": "Курс USDT/RUB временно недоступен, повторите позже"
}Проверка статуса заявки
Возвращает заявку в том же формате, что и при создании, с текущим статусом. Используйте, если webhook-уведомление не дошло.
curl "https://api.parallel-pay.com/api/v1/invoices/cm3k8x7y80001z8j4k5m6n7o8" \
-H "Authorization: Bearer $PARALLEL_TOKEN"