Подписки по H2H
Авторизация
| Заголовок | Значение |
|---|---|
X-MerchantId | Идентификатор мерчанта, UUID |
X-Secret | Секретный ключ мерчанта |
Content-Type | application/json |
X-Secret передавать в браузер нельзя.Шаг 1. Создать подписку
POST /transaction/process| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
paymentMethod | number | да | 6 — подписка |
paymentDetails.amount | number | да | Сумма регулярного списания |
paymentDetails.currency | string | да | Код валюты, например RUB |
paymentDetails.interval | number | да | Единица периода: 1 — день, 2 — неделя, 3 — месяц, 4 — год |
paymentDetails.intervalCount | number | нет | Сколько единиц периода между списаниями, по умолчанию 1 |
description | string | нет | Описание подписки |
intervalCount зависят от interval: для дня — от 1 до 730, для недели — от 1 до 4, для месяца — от 1 до 12, для года — от 1 до 99. Нестандартные периоды доступны только при согласованном тарифе, уточняйте у менеджера.return, failedUrl и siteLink в этом сценарии не применяются.Пример запроса
{
"paymentMethod": 6,
"paymentDetails": {
"amount": 1000,
"currency": "RUB",
"interval": 3,
"intervalCount": 1
},
"description": "Подписка на сервис"
}Пример ответа, 200
{
"paymentMethod": "Subscription",
"transactionId": "3f1a2b4c-5e6d-4a7b-9c8d-1e2f3a4b5c6d",
"redirect": "https://pay.platega.io/subscription/3f1a2b4c-5e6d-4a7b-9c8d-1e2f3a4b5c6d",
"status": "pending",
"merchantId": "8b2f1c3a-0d4e-4f51-9a62-7c8d9e0f1a2b"
}transactionId — идентификатор подписки, он же {id} на шаге 2. Сохраните его.redirect — ссылка на платёжную форму. В сценарии H2H она не нужна, открывать её не требуется.Failed.Ошибка валидации периода, 400
{
"errorId": "WRONG_INPUT_PARAMETERS",
"additionalInfo": [
{
"key": "paymentDetails.interval",
"message": "Subscription requires interval: 1=daily, 2=weekly, 3=monthly, 4=yearly."
}
]
}intervalCount, ключ в additionalInfo будет paymentDetails.intervalCount, а в сообщении — допустимый диапазон для выбранного interval.Шаг 2. Активировать подписку
POST /subscription/{id}/starttransactionId, полученный на шаге 1.| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
email | string | да | Электронная почта плательщика, передаётся для оформления подписки |
Пример запроса
{
"email": "customer@example.com"
}Пример ответа, 200
{
"subscriptionId": "3f1a2b4c-5e6d-4a7b-9c8d-1e2f3a4b5c6d",
"confirmationUrl": "https://example.com/confirm/xyz123"
}confirmationUrl — страница подтверждения. Направьте плательщика на неё: там он подтверждает согласие на регулярные списания. Дальше списания выполняются по расписанию без участия мерчанта.confirmationUrl.Нет доступных реквизитов
{
"subscriptionId": "3f1a2b4c-5e6d-4a7b-9c8d-1e2f3a4b5c6d",
"confirmationUrl": null,
"error": "No available subscription cascades.",
"allProvidersUnavailable": true
}Подписка отменена, 400
{
"errorId": "WRONG_INPUT_PARAMETERS",
"additionalInfo": [
{ "key": "subscriptionId", "message": "Subscription is cancelled" }
]
}Истекло окно согласия, 400
Failed, активировать её уже нельзя — создайте новую.{
"errorId": "WRONG_INPUT_PARAMETERS",
"additionalInfo": [
{ "key": "subscriptionId", "message": "Subscription agreement window has expired" }
]
}Modified at 2026-10-29 16:28:15