Developers

API and connection documentation

Возврат покупателя на сайт продавца

После завершения платежа в online платежной системе покупатель перенаправляется на страницу продавца Success URL или Failure URL, в зависимости от результата платежа. Перенаправление происходит методом Success URL Method или Failure URL Method, указанным при инициации платежа.

На страницу передаются следующие параметры:

pg_order_id Идентификатор платежа в системе продавца
pg_payment_id Внутренний идентификатор платежа в системе paybox.money
pg_card_brand Бренд карты: CA – MasterCard и их продукты, VI – Visa, AX – AmericanExpress. Этот параметр передается только в случае успешной оплаты банковской картой.
pg_card_pan Маскированный номер карты (часть цифр номера карты скрыты). Этот параметр передается только в случае успешной оплаты банковской картой.
pg_auth_code Код авторизации. Этот параметр передается только в случае успешной оплаты банковской картой.
pg_captured 0 или 1. Передается только в случае успешной оплаты банковской картой и показывает, был ли произведен клиринг в момент авторизации (что зависит только от настроек магазина). Если значение этого поля равно 0, магазин должен в последующем дать команду на клиринг (см. раздел Запрос на клиринг транзакций по банковским картам) или дождаться когда PayBox сделает это сам.
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=1265&pg_order_id=654&pg_payment_id=8976867865&uservar1=7894 5&pg_sig=d52f52379bfc5f96bd602d28096e05c7

Если Success URL или Failure URL уже содержат параметры в query string, то дополнительные параметры pg_order_id, pg_payment_id и пользовательские переменные продавца дописываются в конец query string. Магазин должен следить за тем, чтобы имена дополнительных параметров не совпадали с именами уже имеющимися параметров. Необходимо четко понимать разницу между Result URL и Success URL. Result URL вызывается напрямую с сервера PayBoxа, в то время как Success URL вызывается браузером пользователя, когда пользователь перенаправляется PayBoxом обратно на сайт магазина. Неправильно использовать Success URL как единственный способ узнать о завершении оплаты, потому что пользователь может по разным причинам (например, прерывание связи) не дойти до Success URL после оплаты. Самый надежный способ узнавать о завершении платежа – это реализовать Result URL, который PayBox обязуется вызывать повторно в течение 2 часов после оплаты, если первая попытка по любым причинам не удалась.

Need a consultation?

Send an enquiry and our managers will contact you in 15 minutes.