Создание заявок на прием
Создание заявок на прием платежей от клиентов через Parallel API
Создание заявки
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\":\"Sberbank\",\"phoneNumber\":\"79001234567\",\"fullName\":\"Ivan Ivanov\"}",
"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. Реквизитов в нём нет: клиент получит их на странице оплаты.
Поле
Тип
Примеры ошибок
Ошибка: Нет доступных реквизитов
HTTP Status: 503 Service Unavailable
Эта ошибка возникает, когда все реквизиты на эту сумму и метод заняты. Повторите запрос позже или с другой суммой.
{
"error": "Нет доступных реквизитов"
}Объект заявки
Этот же объект приходит в ответе на создание заявки в H2H-режиме, в проверке статуса и в теле webhook-уведомления.
Поле
Тип
Реквизиты для оплаты
dealRequisites — JSON-строка. После JSON.parse в ней один из двух объектов, в зависимости от paymentMethod.
СБП (SBP)
Поле
Тип
Перевод на карту (TO_CARD)
Поле
Тип
Проверка статуса заявки
Возвращает заявку в том же формате, что и при создании, с текущим статусом. Используйте, если webhook-уведомление не дошло.
curl "https://api.parallel-pay.com/api/v1/invoices/cm3k8x7y80001z8j4k5m6n7o8" \
-H "Authorization: Bearer $PARALLEL_TOKEN"