Страница оплаты

Ссылка на страницу оплаты платежа, поля плательщика на странице, адрес возврата и что видит плательщик.

Страница оплаты показывает плательщику один уже созданный платёж: собирает поля плательщика, показывает реквизит или отправляет к провайдеру, а потом исход. Платёж создаёт сервер мерчанта, страница его не создаёт и способ оплаты не выбирает. Как собрать кассу на странице оплаты по шагам: Руководство по странице оплаты.

Ссылка на страницу

Ссылка приходит полем pageUrl в ответе создания и чтения платежа. Пока ссылка жива, она одна и та же в каждом ответе, поэтому её не нужно хранить отдельно от номера платежа.

  • Срок ссылки: срок платежа expiresAt плюс сутки, но не больше семи суток от создания. Продлить ссылку нельзя.
  • pageUrl равен null, если страница оплаты недоступна или срок ссылки вышел. Тогда плательщику показывают action своей формой: Что показать плательщику.
  • Ссылка это адрес страницы и токен после #. Токен не меняйте и не обрезайте: такая ссылка не откроется.
  • Язык страницы задаёт параметр lang перед #: en, pt-BR, es, ru. Без него страница берёт язык браузера, а если его нет среди этих, английский.
Ссылка с языком
https://pay.example/?lang=es#<токен>

Просроченная ссылка показывает плательщику, что она больше не действует, и что платить повторно не нужно, если деньги уже отправлены.

Поля плательщика на странице

Если сервис требует поля плательщика (payer.tax_id, payer.name, payer.email, payer.phone, payer.iban), их может собрать страница вместо вашей формы. Для этого платёж создают с fieldsOnPage: true и без fields.

  • Платёж создаётся в статусе CREATED без попытки, а action ведёт на pageUrl.
  • Первая попытка начинается, когда плательщик отправит поля. После этого статус и action такие же, как у платежа с полями из запроса.
  • Заполнить поля можно до срока платежа без одной минуты, потом платёж истекает обычным порядком.
  • У сервиса без полей плательщика fieldsOnPage ничего не меняет: попытка идёт сразу.
  • Если клиент заблокирован, ответ создания сразу REJECTED с причиной customer_blocked: action равен null, формы полей нет.
  • После отправки полей платёж, как и любой другой, может закончиться без попытки: REJECTED (антифрод, правило маршрутизации) или FAILED.

Когда этим нельзя пользоваться, ответ создания говорит отказом: fields_on_page_conflict (передан и fields), pay_page_unavailable (страницы оплаты нет), fields_on_page_ttl_too_short (срок платежа мерчанта короче пяти минут). Все три описаны в справочнике.

Адрес возврата

После оплаты страница может вернуть плательщика на returnUrl. Когда у установки есть страница оплаты, адрес возврата принимается, только если его источник, то есть схема, имя узла и порт, есть в списке разрешённых источников мерчанта. Список ведёт администратор Target по вашей просьбе, в нём до двадцати источников; http годится только в тестовом контуре. Адрес вне списка получает отказ 400 с правилом return_url_not_allowed.

К адресу возврата страница ничего не дописывает: ни статуса, ни номера платежа. Возврат плательщика не говорит об исходе, исход узнают чтением платежа или из уведомления. Если адреса возврата нет или его источник сняли из списка, на последнем экране страница предлагает её закрыть.

Что видит плательщик

ПлатёжЭкран
Ждёт полей (fieldsOnPage)Форма полей сервиса и время, которое осталось
Реквизит выписанРеквизит, сумма к оплате и срок; при переводе по реквизитам и при изменённой сумме «переведите ровно эту сумму»
Переход к провайдеруКнопка перехода на страницу провайдера
CREATED, PROCESSING, разбор, реквизит ещё не выписанОжидание: страница сама проверяет платёж
SUCCEEDED без разбораОплачено
PARTIALLY_PAID, OVERPAIDСумма отличается от запрошенной, платить повторно не нужно
ОтказОплата не прошла
CANCELLED, REJECTEDПлатёж отменён
Срок вышелСрок оплаты вышел

У тестового платежа страница показывает полосу «тестовый платёж». Номера заказа и платежа, данные плательщика и метки страница не показывает.

Ограничения

  • Страницу открывают переходом, в той же вкладке или в новой. Показать её во фрейме нельзя: страница запрещает встраивание.
  • Страница не меняет того, как узнают исход: зачисляйте по прочитанному платежу, Когда зачислять.
  • Боевой приём закрыт, поэтому страница работает с платежами тестового контура.

API v1 · собрано 18.11.2026 · выпуск f13e6bf

Справочник методов собирается из кода сервера: он не описывает адрес, которого нет.