Страница оплаты
Ссылка на страницу оплаты платежа, поля плательщика на странице, адрес возврата и что видит плательщик.
Страница оплаты показывает плательщику один уже созданный платёж: собирает поля плательщика, показывает реквизит или отправляет к провайдеру, а потом исход. Платёж создаёт сервер мерчанта, страница его не создаёт и способ оплаты не выбирает. Как собрать кассу на странице оплаты по шагам: Руководство по странице оплаты.
Ссылка на страницу
Ссылка приходит полем 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. Когда у установки есть страница оплаты, адрес возврата принимается, только если его источник, то есть схема, имя узла и порт, есть в списке разрешённых источников мерчанта. Список ведёт администратор Paydex по вашей просьбе, в нём до двадцати источников; http годится только в тестовом контуре. Адрес вне списка получает отказ 400 с правилом return_url_not_allowed.
К адресу возврата страница ничего не дописывает: ни статуса, ни номера платежа. Возврат плательщика не говорит об исходе, исход узнают чтением платежа или из уведомления. Если адреса возврата нет или его источник сняли из списка, на последнем экране страница предлагает её закрыть.
Что видит плательщик
| Платёж | Экран |
|---|---|
Ждёт полей (fieldsOnPage) | Форма полей сервиса и время, которое осталось |
| Реквизит выписан | Реквизит, сумма к оплате и срок; при переводе по реквизитам и при изменённой сумме «переведите ровно эту сумму» |
| Переход к провайдеру | Кнопка перехода на страницу провайдера |
CREATED, PROCESSING, разбор, реквизит ещё не выписан | Ожидание: страница сама проверяет платёж |
SUCCEEDED без разбора | Оплачено |
PARTIALLY_PAID, OVERPAID | Сумма отличается от запрошенной, платить повторно не нужно |
| Отказ | Оплата не прошла |
CANCELLED, REJECTED | Платёж отменён |
| Срок вышел | Срок оплаты вышел |
У тестового платежа страница показывает полосу «тестовый платёж». Номера заказа и платежа, данные плательщика и метки страница не показывает.
Ограничения
- Страницу открывают переходом, в той же вкладке или в новой. Показать её во фрейме нельзя: страница запрещает встраивание.
- Страница не меняет того, как узнают исход: зачисляйте по прочитанному платежу, Когда зачислять.
- Боевой приём закрыт, поэтому страница работает с платежами тестового контура.