Создание заявок на прием
Создание заявок на прием платежей от клиентов через Parallel API
Клиент платит только из Т-Банка, чек присылаете вы
- Клиент переводит деньги только из приложения Т-Банка — на реквизиты любого банка.
- PDF чека из приложения Т-Банка вы загружаете к заявке: Чеки клиента.
Без зачтённого чека заявка не будет оплачена.
Создание заявки
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);Пример ответа
HTTP Status: 201 Created
Ответ с реквизитами для оплаты:
{
"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\"}",
"dealRate": "95.50",
"createdAt": "2025-11-03T15:00:00.000Z",
"updatedAt": "2025-11-03T15:00:00.000Z",
"internalId": "order-12345",
"merchantName": "MerchantName"
}Объект заявки
Этот же объект приходит в ответе на создание заявки в H2H-режиме, в проверке статуса и в теле webhook-уведомления.
Поле
Тип
Реквизиты для оплаты
dealRequisites — JSON-строка. После JSON.parse в ней реквизиты получателя (вид зависит от paymentMethod).
Пример для СБП:
{
"bankName": "Сбербанк",
"fullName": "Ivan I.",
"phoneNumber": "79001234567"
}СБП (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"