Ограничение времени работы с платёжной формой

Общая информация

При работе с Payment Page поддерживается возможность указывать дату и время, до наступления которых пользователь может работать с платёжной формой для подтверждения целевого действия. Такая возможность позволяет контролировать предоставление пользователям услуг с привязкой ко времени и может быть актуальна, например, при продаже билетов или распродаже товаров. Эти данные указываются в запросах на открытие Payment Page, и при их указании на страницах формы используется дополнительная панель, на которой отображаются:

Дата и время завершения работы с платёжной формой указываются в запросах на открытие Payment Page и для подключения этой возможности не требуется никаких дополнительных действий. Если ограничение задано, на страницах Payment Page используется дополнительная информационная панель, на которой отображаются:

  • запись о времени завершения работы с формой в формате hh:mm;
  • запись об остающемся времени работы с формой с использованием таймера mm:ss;
  • индикатор остающегося времени, отображаемый в последние пять минут из числа отведённых.
Прим.: Следует учитывать, что ограничение времени работы с платёжной формой не должно превышать 30 суток с момента отправки в платформу запроса на открытие Payment Page, иначе указанные в таком запросе дата и время завершения работы игнорируются и соответствующие ограничения не применяются.

Пользовательский сценарий

Со стороны пользователя проведение оплаты с ограничением времени работы с Payment Page выглядит следующим образом:

  1. На стороне веб-сервиса мерчанта пользователь подтверждает готовность перейти к оплате и перенаправляется к платёжной форме.
  2. Пользователь выполняет необходимые действия для оплаты и получает информацию о результате.

    В случае, если пользователь не подтверждает выполнение целевого действия до истечения отведённого времени, ему отображается страница с уведомлением об истечении этого времени.

Рис. 1. 1 — Открытие платёжной формы


Рис. 2. 2 а — Проведение оплаты


Рис. 3. 2 б — Отклонение оплаты из-за истечения времени


Особенности

При использовании возможности ограничения времени работы с Payment Page следует учитывать некоторые особенности:

  • при проведении отдельных платежей со стороны платёжных систем или провайдеров могут запрашиваться дополнительные данные о пользователе, что может увеличивать время работы пользователей с платёжной формой (подробнее);
  • ограничение времени работы с формой для отдельного платежа актуально и при выполнении всех повторных попыток в рамках этого платежа, независимо от их количества (подробнее);
  • при необходимости можно добавлять и использовать индивидуальные формулировки для информирования пользователей об остающемся времени работы с формой (подробнее).

Формат запроса

Чтобы задать ограничение на время работы с платёжной формой, в запросе на открытие Payment Page необходимо передать дату, время, а также часовой пояс в формате YYYY-MM-DDThh:mm:ss±hh (или YYYY-MM-DDThh:mm:ss±hh:mm) в значении параметра best_before, при этом допустимое время работы с формой должно составлять не более 30 суток с момента отправки запроса на открытие Payment Page.

{  
    // обязательные параметры для проведения оплаты
   "project_id": 42,
   "payment_id": "7654321777",
   "payment_currency": "USD",
   "payment_amount": 131970,
   "customer_id": "customer_12",
   "signature": "TSzdE5rJZaA9TYAKoGpfXriFf82MxF...",

    // дата и время завершения работы с платёжной формой —
    // 12 апреля 2021 года в 10:15:30, GMT+3
   "best_before": "2021-04-12T10:15:30+03"  
 
}