Создание подписки

Подписка создаётся при передаче значения SUBSCRIPTION в поле paymentGroup запроса инициализации checkout. После первого успешного 3D Secure платежа последующие списания выполняются по плану.

HTTP метод	URL
`POST`	`/payment/v1/checkout-payments/init`

Поля плана

Поле	Тип	Обязательное	Описание
`externalCustomerId`	`string`	Нет	Идентификатор клиента в системе мерчанта; максимум 255 символов.
`planCode`	`string`	Нет	Код плана; максимум 50 символов.
`periodType`	`integer`	Да	`7` (неделя), `30` (месяц) или `365` (год).
`price`	`decimal`	Условно	Положительная сумма за период.
`nochargeDayCount`	`integer`	Да	Бесплатные дни до первого списания; по умолчанию `0`.
`description`	`string`	Да	Описание подписки.
`paymentCount`	`integer`	Нет	Общее количество платёжных периодов.
`variablePayment`	`boolean`	Нет	Признак плана с переменной суммой.
`variablePaymentTriggerType`	`string`	Условно	`SCHEDULED` или `EXTERNAL`.
`paymentSteps`	`array`	Нет	Шаги цены и даты платежа по периодам.

Элемент paymentSteps содержит startPeriod (минимум 1), periodPrice (положительное значение), paymentDate (YYYY-MM-DD) и skipPaymentPeriod.

{
  "price": 99.90,
  "paidPrice": 99.90,
  "currency": "TRY",
  "paymentGroup": "SUBSCRIPTION",
  "callbackUrl": "https://merchant.example.com/payment/callback",
  "conversationId": "order-2026-001",
  "items": [{ "name": "Premium", "price": 99.90 }],
  "plan": {
    "externalCustomerId": "customer-42",
    "planCode": "PREMIUM-MONTHLY",
    "periodType": 30,
    "price": 99.90,
    "nochargeDayCount": 0,
    "description": "Ежемесячная подписка",
    "paymentCount": 12,
    "variablePayment": false
  }
}

Статусы подписки

ACTIVE (0), PASSIVE (1), PENDING (2), DELETED (3), PROCESSING (4), ANOMALY (5) и WAITING (6).