--- metadata: - name: generator content: Diplodoc Platform v5.56.0 alternate: - https://pay.yandex.ru/docs/ru/custom/split-cooling-period.md - href: ru/custom/split-cooling-period.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt title: "Период «охлаждения» в супер Сплите при оплате через Яндекс\_Пэй | Документация" description: Как в интеграции поддержать обязательное время ожидания. --- > **Documentation Index:** Fetch the complete configuration index at https://pay.yandex.ru/docs/ru/llms.txt # Период «охлаждения» в супер Сплите {% note info %} Период «охлаждения» не подключен по умолчанию. Чтобы подключить и настроить, обратитесь к вашему менеджеру интеграции. {% endnote %} ## О периоде «охлаждения» { #about } ### Что это такое { #about__what-is-it } С 1 сентября 2025 года по Федеральному закону №9 «О внесении изменений в отдельные законодательные акты Российской Федерации» все банки обязаны выдерживать период «охлаждения». Период «охлаждения» — это дополнительный временной интервал между подписанием договора и фактическим зачислением кредита. В Яндекс Пэй период «охлаждения» действует для пользователей [супер Сплита](https://pay.yandex.ru/split) — кредитного продукта от ОФС Яндекса, улучшенной версии Сплита с большим лимитом и гибкими условиями. ### Зачем он нужен { #about__why-needed } Покупателю: открывает доступ к [супер Сплиту](https://pay.yandex.ru/split), защищая от импульсивных решений — в течение этого периода пользователь может отменить операцию без последствий. Бизнесу: поддержка периода «охлаждения» помогает увеличивать средний чек — клиентам становятся доступны покупки на большие суммы, больше вариантов графиков платежей и более высокие лимиты. ### Сколько длится период «охлаждения» { #about__duration } Период «охлаждения» активируется при улучшении Сплита на форме оплаты для покупателей, которые ранее не улучшали Сплит. Длительность периода «охлаждения» — **4 часа** для заказов от 49 000 до 200 000 рублей. ## Как подключить период «охлаждения» { #how-to-integrate } ### Шаг 1. Проверка соответствия { #how-to-integrate__step-1 } Чтобы понять, подходит ли период «охлаждения» вашему бизнесу: 1. Проверьте, что ваш бизнес соответствует [требованиям](#requirements) для подключения периода «охлаждения». 1. Изучите [как работает период «охлаждения» для покупателя](#user-flow). #### Список требований { #requirements } 1. **Интеграция через API.** Проверьте, что ваш магазин интегрируется через [Yandex Pay API](https://pay.yandex.ru/docs/ru/custom/back-index.yaml). 2. **Механика оплаты совместима с периодом «охлаждения».** Период «охлаждения» поддерживается только следующими механиками: #| || Механика оплаты | Поддержка периода «охлаждения» || || [Базовая механика](https://pay.yandex.ru/docs/ru/payments/basic.md) | ![][yes] || || [Двухстадийные платежи](https://pay.yandex.ru/docs/ru/hold/index.md) | ![][yes] || || [Сплит с оплатой при «получении»](https://pay.yandex.ru/docs/ru/payments/mechanics/split-two-stage.md) | ![][yes] Есть ограничения, например, не подходит для магазинов с экспресс-доставкой. Согласуйте подключение с менеджером интеграции. || |# 1. **Только онлайн-процесс.** Период «охлаждения» работает только при оформлении заказа с оплатой на сайте или в мобильном приложении. Не подходит для: - Оффлайн-оплат. - Онлайн-оформления в оффлайн-точке с забором заказа сразу (например, онлайн-терминал в магазине). 1. **Нет экспресс-доставки.** Промежуток в 4 часа задерживает получение конечного статуса заказа, что несовместимо с экспресс-доставкой. 1. **Бэкенд магазина поддерживает увеличенное время жизни заказа.** Если в вашей системе есть TTL (время резервирования заказа) менее 4 часов, нужно будет [доработать процесс](#new-scenarios): - Увеличьте время жизни заказов по Сплиту. Определяйте такие заказы методом [/orders/{order_id}](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/order/merchant_v1_order-get.md) по полю `methodType` со значениями `SPLIT` или `SPLIT_SBP`. Увеличивайте для них время, ориентируясь на поле `coolingPeriodExpiresAt`. - Проверьте, что нет автоматизаций, которые отменяют заказ или возвращают деньги при долгом ожидании статуса `CAPTURED`. ### Шаг 2. Подготовка API и выход в тестовую среду { #how-to-integrate__step-2 } 1. Запросите включение функциональности в тестовой среде у менеджера интеграции. 1. Изучите [изменения в обработке заказов](#new-scenarios) и настройте ваш бэкенд. 1. [Протестируйте](#testing) все сценарии в тестовой среде. ### Шаг 3. Выход в боевую среду { #how-to-integrate__step-3 } 1. Запросите включение функциональности в боевой среде у менеджера интеграции. 1. [Протестируйте](#testing) все сценарии в боевой среде. ## Как это выглядит для покупателя { #user-flow } Покупатель проходит процесс улучшения Сплита на форме оплаты: 1. Покупатель выбирает график платежей, доступный только в супер Сплите, и нажимает кнопку **Перейти на супер Сплит**: ![Подключение супер Сплита](./_assets/split-cooling-period_01_registration.png){.screenshot} {.screenshot-wrapper} 1. Происходит редирект на Госуслуги. Покупатель подтверждает передачу дополнительных данных. 1. Происходит редирект на Яндекс Пэй. Покупатель разрешает доступ к бюро кредитных историй и проходит [кредитный скоринг](*scoring). 1. В случае успешного прохождения скоринга покупатель привязывает карту и подтверждает оплату: ![Привязка карты](./_assets/split-cooling-period_02_card-binding.png){.screenshot} {.screenshot-wrapper} 1. Покупателю отображается страница подтвержденной оплаты, где он видит таймер с окончанием периода «охлаждения». По истечении периода «охлаждения» автоматически совершается оплата по заказу и заказ переходит в успешный статус. **Если покупатель передумал:** он обращается в поддержку, и заказ завершается неуспешно. ![Результат периода охлаждения](./_assets/split-cooling-period_03_cooling-period-result.png){.screenshot} {.screenshot-wrapper} ## Как меняется обработка заказов { #new-scenarios } ### Активация периода «охлаждения» { #new-scenarios__activation } При улучшении Сплита в ответе метода [/orders/{order_id}](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/order/merchant_v1_order-get.md) появляется новое поле `coolingPeriodExpiresAt`: #| || `coolingPeriodExpiresAt` | **Тип:** `string` \| `null` Дата и время окончания периода «охлаждения» (ISO 8601). Доступен только в статусе `PENDING` — покупатель улучшил Сплит (вошел в процесс «охлаждения»), ожидается окончание «охлаждения» и оплата. После перехода заказа в другие статусы — значение `null`. **Пример:** `"2025-09-26T14:55:10.390377+03:00"` || |# {% note tip "Совет" %} Начните опрашивать статус заказа методом [/orders/{order_id}](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/order/merchant_v1_order-get.md) примерно через 20 секунд после нажатия кнопки «Оплатить», чтобы получить значение `coolingPeriodExpiresAt` и отобразить информацию покупателю. {% endnote %} На стороне Яндекс Пэй время жизни заказа автоматически увеличивается до значения `coolingPeriodExpiresAt`. Если в вашей системе есть TTL (время резервирования заказа) менее 4 часов, доработайте процесс: - Увеличьте время жизни заказов по Сплиту. Определяйте такие заказы методом [/orders/{order_id}](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/order/merchant_v1_order-get.md) по полю `methodType` со значениями `SPLIT` или `SPLIT_SBP`. Увеличивайте время, ориентируясь на поле `coolingPeriodExpiresAt`. - Проверьте, что нет автоматизаций, которые отменяют заказ или возвращают деньги при долгом ожидании статуса `CAPTURED`. Если TTL отсутствует — ограничений нет. ### Успешное завершение { #new-scenarios__success } Если покупатель не отменяет операцию в течение периода «охлаждения», заказ (платеж) переходит из статуса `PENDING` в успешный статус: #| || [Базовая механика](https://pay.yandex.ru/docs/ru/payments/basic.md) | Заказ автоматически переходит в статус `CAPTURED`. || || [Двухстадийные платежи](https://pay.yandex.ru/docs/ru/hold/index.md) | Заказ автоматически переходит в статус `AUTHORIZED`. Вы можете перевести его в статус `CAPTURED` методом [/capture](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/order/merchant_v1_capture-post.md). || || [Сплит с оплатой при «получении»](https://pay.yandex.ru/docs/ru/payments/mechanics/split-two-stage.md) | Заказ автоматически переходит в статус `CONFIRMED`. Вы можете перевести его в статус `CAPTURED` методом [/orders/{order_id}/submit](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/order/merchant_v1_submit-post.md). || |# ### Отмена покупателем { #new-scenarios__cancellation } Покупатель может отменить заказ в течение периода «охлаждения» через поддержку. Заказ переходит в статус `FAILED` практически сразу после отмены. Максимальная задержка — 5 минут. ### Нотификации { #new-scenarios__notifications } Подробнее о том, как получать нотификации, читайте в разделе [/webhook](https://pay.yandex.ru/docs/ru/custom/backend/merchant-api/webhook.md). #| || [Базовая механика](https://pay.yandex.ru/docs/ru/payments/basic.md) | 1. После истечения периода «охлаждения» приходит нотификация `OPERATION_STATUS_UPDATED` с типом `SUBMIT` — произошло списание средств. Эту нотификацию можно не обрабатывать — отвечайте [200 OK](https://pay.yandex.ru/docs/ru/custom/backend/merchant-api/webhook.md#200-ok). 1. Сразу после нее приходит нотификация `ORDER_STATUS_UPDATED` с `paymentStatus: "CAPTURED"` или `paymentStatus: "FAILED"`. Ориентируйтесь на эту нотификацию для получения конечного статуса заказа. || || [Двухстадийные платежи](https://pay.yandex.ru/docs/ru/hold/index.md) | 1. После истечения периода «охлаждения» приходит нотификация `OPERATION_STATUS_UPDATED` с типом `SUBMIT` — произошло списание средств. Эту нотификацию можно не обрабатывать — отвечайте [200 OK](https://pay.yandex.ru/docs/ru/custom/backend/merchant-api/webhook.md#200-ok). 1. Сразу после нее приходит нотификация `ORDER_STATUS_UPDATED` с `paymentStatus: "AUTHORIZED"`. Вызовите метод [/capture](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/order/merchant_v1_capture-post.md) для [списания средств (клир)](https://pay.yandex.ru/docs/ru/hold/index.md#clear). 1. Приходит нотификация `ORDER_STATUS_UPDATED` с `paymentStatus: "CAPTURED"` или `paymentStatus: "FAILED"`. Ориентируйтесь на эту нотификацию для получения конечного статуса заказа. || || [Сплит с оплатой при «получении»](https://pay.yandex.ru/docs/ru/payments/mechanics/split-two-stage.md) | 1. После истечения периода «охлаждения» приходит нотификация `ORDER_STATUS_UPDATED` с `paymentStatus: "CONFIRMED"`. Вызовите метод [/orders/{order_id}/submit](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/order/merchant_v1_submit-post.md) для [подтверждения заказа](https://pay.yandex.ru/docs/ru/payments/mechanics/split-two-stage.md#submit). 1. Приходит нотификация `OPERATION_STATUS_UPDATED` с типом `SUBMIT` — произошло списание средств. 1. Приходит нотификация `ORDER_STATUS_UPDATED` с `paymentStatus: "CAPTURED"` или `paymentStatus: "FAILED"`. Ориентируйтесь на эту нотификацию для получения конечного статуса заказа. || |# #### Примеры нотификаций { #new-scenarios__notifications-examples } - `OPERATION_STATUS_UPDATED` с `operationType: "SUBMIT"`. Приходит после успешного списания средств по окончании периода «охлаждения»: ```json { "event": "OPERATION_STATUS_UPDATED", "eventTime": "2025-12-10T23:36:19.083322+00:00", "merchantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "operation": { "operationId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "operationType": "SUBMIT", "orderId": "12345", "status": "SUCCESS" } } ``` - `ORDER_STATUS_UPDATED` c `paymentStatus: "CAPTURED"` или `FAILED`. Основная нотификация для отслеживания конечного статуса заказа: ```json { "event": "ORDER_STATUS_UPDATED", "eventTime": "2025-12-10T23:38:29.083322+00:00", "merchantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "order": { "orderId": "12345", "paymentStatus": "CAPTURED" } } ``` ```json { "event": "ORDER_STATUS_UPDATED", "eventTime": "2026-01-19T07:24:33.342595+00:00", "merchantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "order": { "orderId": "1768807460_484", "paymentStatus": "FAILED" } } ``` ## Тестирование { #testing } {% note info %} В тестовой среде для удобства период «охлаждения» сокращен до 1-2 минут. {% endnote %} Протестируйте создание заказа с периодом «охлаждения» в зависимости от механики: - [Базовая механика](#testing__base) - [Двухстадийные платежи](#testing__hold) - [Сплит с оплатой при «получении»](#testing__split-hold) ### Базовая механика { #testing__base } {% list tabs %} - Успешное оформление 1. Вызовите метод [/orders](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/order/merchant_v1_orders-post.md) с суммой **10007** рублей. 1. Перейдите по полученной ссылке, выберите Сплит и нажмите **Оплатить**. Отобразится страница периода «охлаждения» с таймером. 1. Вызовите метод [/orders/{order_id}](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/order/merchant_v1_order-get.md) и проверьте поля: ```json "paymentStatus": "PENDING", "coolingPeriodExpiresAt": "2026-01-19T07:14:03.157565+00:00" ``` Нотификация по статусу `PENDING` не отправляется. 1. Дождитесь окончания периода «охлаждения». 1. Вызовите метод [/orders/{order_id}](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/order/merchant_v1_order-get.md) и проверьте поля: ```json "paymentStatus": "CAPTURED", "coolingPeriodExpiresAt": null ``` Также придет нотификация `ORDER_STATUS_UPDATED` с `paymentStatus: "CAPTURED"`: ```json { "event": "ORDER_STATUS_UPDATED", "eventTime": "2026-01-19T07:14:03.380523+00:00", "merchantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "order": { "orderId": "1768806798_921", "paymentStatus": "CAPTURED" } } ``` **Результат:** Заказ в статусе `CAPTURED` — оплата завершилась успешно после периода «охлаждения». - Неуспешное оформление (отказ пользователя) 1. Вызовите метод [/orders](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/order/merchant_v1_orders-post.md) с суммой **10008** рублей. 1. Перейдите по полученной ссылке, выберите Сплит и нажмите **Оплатить**. Отобразится страница периода «охлаждения» с таймером. 1. Вызовите метод [/orders/{order_id}](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/order/merchant_v1_order-get.md) и проверьте поля: ```json "paymentStatus": "PENDING", "coolingPeriodExpiresAt": "2026-01-19T07:24:32.620821+00:00" ``` Нотификация по статусу `PENDING` не отправляется. 1. Дождитесь окончания периода «охлаждения». 1. Вызовите метод [/orders/{order_id}](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/order/merchant_v1_order-get.md) и проверьте поля: ```json "paymentStatus": "FAILED", "coolingPeriodExpiresAt": null ``` Также придет нотификация `ORDER_STATUS_UPDATED` с `paymentStatus: "FAILED"`: ```json { "event": "ORDER_STATUS_UPDATED", "eventTime": "2026-01-19T07:24:33.342595+00:00", "merchantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "order": { "orderId": "1768807460_484", "paymentStatus": "FAILED" } } ``` **Результат:** Заказ в статусе `FAILED` — оплата завершилась неуспешно после периода «охлаждения». {% endlist %} ### Двухстадийные платежи { #testing__hold } {% note warning "Ограничения тестовой среды" %} В тестовой среде в двухстадийных платежах не работает [автоклир](https://pay.yandex.ru/docs/ru/hold/index.md#auto-clear). Списывайте средства вручную методом [/capture](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/order/merchant_v1_capture-post.md). {% endnote %} {% list tabs %} - Успешное оформление 1. Вызовите метод [/orders](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/order/merchant_v1_orders-post.md) с суммой **10007** рублей. 1. Перейдите по полученной ссылке, выберите Сплит и нажмите **Оплатить**. Отобразится страница периода «охлаждения» с таймером. 1. Вызовите метод [/orders/{order_id}](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/order/merchant_v1_order-get.md) и проверьте поля: ```json "paymentStatus": "PENDING", "coolingPeriodExpiresAt": "2026-01-19T07:14:03.157565+00:00" ``` Нотификация по статусу `PENDING` не отправляется. 1. Дождитесь окончания периода «охлаждения». 1. Вызовите метод [/orders/{order_id}](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/order/merchant_v1_order-get.md) и проверьте поля: ```json "paymentStatus": "AUTHORIZED", "coolingPeriodExpiresAt": null ``` Также придет нотификация `ORDER_STATUS_UPDATED` с `paymentStatus: "AUTHORIZED"`: ```json { "event": "ORDER_STATUS_UPDATED", "eventTime": "2026-01-19T07:33:38.320397+00:00", "merchantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "order": { "orderId": "1768808133_623", "paymentStatus": "AUTHORIZED" } } ``` 1. Вызовите метод [/capture](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/order/merchant_v1_capture-post.md) для списания средств. 1. Вызовите метод [/orders/{order_id}](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/order/merchant_v1_order-get.md) и проверьте поля: ```json "paymentStatus": "CAPTURED", "coolingPeriodExpiresAt": null ``` Также придет нотификация `ORDER_STATUS_UPDATED` с `paymentStatus: "CAPTURED"`: ```json { "event": "ORDER_STATUS_UPDATED", "eventTime": "2026-01-19T07:36:04.432032+00:00", "merchantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "order": { "orderId": "1768808133_623", "paymentStatus": "CAPTURED" } } ``` **Результат:** Заказ в статусе `CAPTURED` — оплата завершилась успешно после периода «охлаждения» и вызова [/capture](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/order/merchant_v1_capture-post.md). - Неуспешное оформление (отказ пользователя) 1. Вызовите метод [/orders](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/order/merchant_v1_orders-post.md) с суммой **10008** рублей. 1. Перейдите по полученной ссылке, выберите Сплит и нажмите **Оплатить**. Отобразится страница периода «охлаждения» с таймером. 1. Вызовите метод [/orders/{order_id}](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/order/merchant_v1_order-get.md) и проверьте поля: ```json "paymentStatus": "PENDING", "coolingPeriodExpiresAt": "2026-01-19T07:24:32.620821+00:00" ``` Нотификация по статусу `PENDING` не отправляется. 1. Дождитесь окончания периода «охлаждения». 1. Вызовите метод [/orders/{order_id}](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/order/merchant_v1_order-get.md) и проверьте поля: ```json "paymentStatus": "FAILED", "coolingPeriodExpiresAt": null ``` Также придет нотификация `ORDER_STATUS_UPDATED` с `paymentStatus: "FAILED"`: ```json { "event": "ORDER_STATUS_UPDATED", "eventTime": "2026-01-19T07:24:33.342595+00:00", "merchantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "order": { "orderId": "1768807460_484", "paymentStatus": "FAILED" } } ``` **Результат:** Заказ в статусе `FAILED` — оплата завершилась неуспешно после периода «охлаждения». {% endlist %} ### Сплит с оплатой при «получении» { #testing__split-hold } Эта механика не меняет поведение при подключенном периоде «охлаждения». Тестируйте так же, как описано в разделе [Сплит с оплатой при «получении»](https://pay.yandex.ru/docs/ru/payments/mechanics/split-two-stage.md#test-cases). [no]: ../_assets/no.svg [yes]: ../_assets/yes.svg [*scoring]: Кредитный скоринг — это анализ платежеспособности заемщика, который банки и другие финансовые организации используют для оценки рисков при выдаче кредитов.