После завершения платежа в online платежной системе покупатель перенаправляется на страницу продавца Success URL или Failure URL, в зависимости от результата платежа. Перенаправление происходит методом Success URL Method или Failure URL Method, указанным при инициации платежа.
На страницу передаются следующие параметры:
| Параметр | Описание |
| pg_order_id | Идентификатор платежа в системе продавца |
| pg_payment_id | Внутренний идентификатор платежа в системе platron.ru |
| pg_card_brand |
Бренд карты: CA – MasterCard и их продукты, VI – Visa, AX – AmericanExpress.
Этот параметр передается только в случае успешной оплаты банковской картой. |
| pg_card_pan |
Маскированный номер карты (часть цифр номера карты скрыты).
Этот параметр передается только в случае успешной оплаты банковской картой. |
| pg_card_hash |
Хешированный номер карты (номер карты, зашифрованный необратимым алгоритмом шифрования).
Этот параметр передается только в случае успешной оплаты банковской картой. |
| pg_auth_code |
Код авторизации.
Этот параметр передается только в случае успешной оплаты банковской картой. |
| pg_captured |
0 или 1.
Передается только в случае успешной оплаты банковской картой и показывает, был ли произведен клиринг в момент авторизации (что зависит только от настроек магазина). Если значение этого поля равно 0, магазин должен в последующем дать команду на клиринг (см. раздел Запрос на клиринг транзакций по банковским картам) или дождаться когда Platron сделает это сам. |
| pg_overpayment |
Сумма переплаты в валюте платежной системы.
Параметр передается только в случае когда клиент оплатил больше, чем от него ожидалось, и переплата разрешена в настройках магазина. Если оплачено ровно столько, сколько ожидалось, этот параметр не передается. |
| pg_failure_code |
Также как аналогичное поле в вызове Result URL (см. выше).
Передается только на Failure URL. |
| pg_failure_description |
Также как аналогичное поле в вызове Result URL (см. выше).
Передается только на Failure URL. |
| pg_recurring_profile_id | Идентификатор профиля рекуррентных платежей |
| pg_recurring_profile_expiry_date | Дата, до которой рекуррентный профиль доступен к использованию |
| Параметры продавца | Все поля, переданные с веб-сайта продавца, не имеющие префикса «pg_» |
| pg_salt | Случайная строка |
| pg_sig | подпись |
В случае оплаты через offline платежную систему возврат покупателя на сайт магазина не происходит.
Пример GET или AUTOGET перехода в случае успеха:
https://store.ru/success.php?pg_salt=54c6a8786f19e&pg_order_id=654&pg_payment_id=765432&uservar1=45363456&pg_card_brand=CA&pg_card_pan=527594******4984&pg_card_hash=022380c107141f7e11f4271d7f6412a715222c32&pg_auth_code=014318&pg_auth_code=014318&pg_sig=20bcedd8320ac8868b97706abedec0b4
Если Success URL или Failure URL уже содержат параметры в query string, то дополнительные параметры pg_order_id, pg_payment_id и пользовательские переменные продавца дописываются в конец query string. Магазин должен следить за тем, чтобы имена дополнительных параметров не совпадали с именами уже имеющимися параметров.
Необходимо четко понимать разницу между Result URL и Success URL. Result URL вызывается напрямую с сервера Platron, в то время как Success URL вызывается браузером пользователя, когда пользователь перенаправляется ом обратно на сайт магазина.
Неправильно использовать Success URL как единственный способ узнать о завершении оплаты, потому что пользователь может по разным причинам (например, прерывание связи) не дойти до Success URL после оплаты. Самый надежный способ узнавать о завершении платежа – это реализовать Result URL, который обязуется вызывать повторно в течение 2 часов после оплаты, если первая попытка по любым причинам не удалась.