Для создания платежной транзакции (инициализации платежа) магазин должен выполнить два действия:
1. передать данные о платеже Platron
2. передать покупателя в управление Platron
Это возможно сделать двумя способами:
1. передать информацию о платеже через браузер пользователя, при этом одновременно пользователь переходит на сайт Platron.
2. передать информацию о платеже напрямую в Platron, в ответ получить идентификатор платежной транзакции и URL для последующего перенаправления покупателя, а затем перенаправить покупателя на этот URL.
В обоих случаях состав передаваемых данных совершенно идентичен, различаются лишь способ передачи и формат ответа.
| Поле | Описание |
| pg_merchant_id | Идентификатор продавца в Platron. Выдается при подключении. |
| pg_amount | Сумма платежа в валюте pg_currency |
| pg_description | (string[1024]) Описание товара или услуги. Отображается покупателю в процессе платежа. |
| pg_salt | Случайная строка |
| pg_sig | Подпись |
| Поле | Значение по умолчанию | Описание |
| pg_order_id | Идентификатор платежа в системе продавца. Рекомендуется поддерживать уникальность этого поля. Максимальная длина составляет 50 символов в UTF-8 | |
| pg_currency | RUB | Валюта, в которой указана сумма.
Возможные варианты:
RUB USD EUR В случае выбора покупателем способа платежа в другой валюте, производится пересчет по курсу ЦБ на день платежа. Полный список возможных значений см. в разделе Справочник валют. |
| pg_check_url | Из настроек магазина Check URL | (string[1024]) URL для проверки возможности платежа. Вызывается перед платежом, если платежная система предоставляет такую возможность. Если параметр не указан, то берется из настроек магазина. Если параметр установлен равным пустой строке, то проверка возможности платежа не производится. |
| pg_result_url | Из настроек магазина Result URL | (string[1024]) URL для сообщения о результате платежа. Вызывается после платежа в случае успеха или неудачи. Если параметр не указан, то берется из настроек магазина. Если параметр установлен равным пустой строке, то Platron не сообщает магазину о результате платежа. |
| pg_refund_url | Из настроек магазина Refund URL | (string[1024]) URL для сообщения об отмене платежа. Вызывается после платежа в случае отмены платежа на стороне Platron или ПС. Если параметр не указан, то берется из настроек магазина. |
| pg_capture_url | Из настроек магазина Capture URL | (string[1024]) URL для сообщения о проведении клиринга платежа по банковской карте. Если параметр не указан, то берется из настроек магазина. |
| pg_request_method | Из настроек магазина Request Method | (string[4]) GET, POST или XML – метод вызова скриптов магазина Check URL, Result URL, Refund URL, Capture URL для передачи информации от платежного гейта. |
| pg_success_url | Из настроек магазина Success URL | (string[1024]) url, на который отправляется пользователь в случае успешного платежа (только для online систем) |
| pg_failure_url | Из настроек магазина Failure URL | (string[1024]) url, на который отправляется пользователь в случае не успешного платежа (только для online систем) |
| pg_success_url_method | Из настроек магазина Success URL Method |
GET – кнопка, которая сабмитится методом GET. POST – кнопка, которая сабмитится методом POST. AUTOGET – 302 редирект. См. Автоматическая передача информации, п.1. AUTOPOST – форма, которая автоматически сабмитится. См. Автоматическая передача информации, п.1. Если выбран метод GET или POST, то страница с подтверждением оплаты показывается пользователю на сайте platron.ru, и предлагается нажать кнопку, чтобы вернуться на сайт магазина. Если выбран метод AUTOGET или AUTOPOST, то страница с подтверждением оплаты не показывается пользователю, и пользователь сразу передается магазину. |
| pg_failure_url_method | Из настроек магазина Failure URL Method |
GET – кнопка, которая сабмитится методом GET. POST – кнопка, которая сабмитится методом POST. AUTOGET – 302 редирект. См. Автоматическая передача информации, п.1. AUTOPOST – форма, которая автоматически сабмитится. См. Автоматическая передача информации, п.1. Если выбран метод GET или POST, то страница с сообщением о неудавшейся оплате показывается пользователю на сайте platron.ru, и предлагается нажать кнопку, чтобы вернуться на сайт магазина. Если выбран метод AUTOGET или AUTOPOST, то страница с сообщением о неудавшейся оплате не показывается пользователю, и пользователь сразу передается магазину. |
| pg_state_url | Из настроек магазина State URL | (string[1024]) URL скрипта на сайте магазина, куда перенаправляется покупатель для ожидания ответа от платежной системы. |
| pg_state_url_method | Из настроек магазина State URL Method |
GET – кнопка, которая сабмитится методом GET. POST – кнопка, которая сабмитится методом POST. AUTOGET – 302 редирект. См. Автоматическая передача информации, п.1. AUTOPOST – форма, которая автоматически сабмитится. См. Автоматическая передача информации, п.1. Если выбран метод GET или POST, то страница с сообщением о неудавшейся оплате показывается пользователю на сайте platron.ru, и предлагается нажать кнопку, чтобы вернуться на сайт магазина. Если выбран метод AUTOGET или AUTOPOST, то страница с сообщением о неудавшейся оплате не показывается пользователю, и пользователь сразу передается магазину. |
| pg_site_url | Из настроек магазина Site URL | URL сайта магазина для показа покупателю ссылки, по которой он может вернуться на сайт магазина после создания счета. Применяется для offline ПС (наличные). |
| pg_payment_system | Идентификатор выбранной ПС или группы ПС. Примеры:webmoney yandexmoney EUROSET cyberplatCASH cash Полный список возможных значений см. в разделе Справочник платежных систем и групп. Этот параметр передается только если выбор платежной системы совершается на сайте продавца. Если параметр не указан, то выбор ПС совершается на сайте platron.ru[1] | |
| pg_lifetime | сутки | Время (в секундах) в течение которого платеж должен быть завершен, в противном случае заказ при проведении платежа Platron откажет платежной системе в проведении.
Этот параметр контролируется Platron, а также, если платежная система поддерживает такую возможность, и платежной системой. См. Справочник платежных систем и групп. Минимально допустимое значение: 300 секунд (5 минут). Максимально допустимое значение: 604800 секунд (7 суток). В случае выхода за пограничные значения будет безакцептно присвоено минимальное или максимальное значение, соответственно |
| pg_user_phone | (int[14]) телефон пользователя (для России начиная с цифр 79..), необходим для идентификации покупателя. Если не указан, выбор будет предложен пользователю на сайте платежного гейта. | |
| pg_need_phone_notification | 1 | Необходимость оповещения клиента (если услуга подключена) по смс о статусе транзакции. 0 – не уведомлять. |
| pg_user_contact_email | (string[100]) Контактный адрес электронной почты пользователя. Если указан, на этот адрес будут высылаться уведомления об изменении статуса транзакции. | |
| pg_need_email_notification | 1 | Необходимость оповещения клиента (если услуга подключена) по email о статусе транзакции. 0 – не уведомлять. |
| pg_user_ip | IP-адрес клиента. Необходим для разбора спорных ситуаций в случае подозрения на мошенничество. Параметр можно не передавать при передаче информации через браузер пользователя, в этом случае будет записан тот IP, с которого пользователь перешёл на страницу инициализации платежа. | |
| pg_postpone_payment | Создание платежа с отложенной оплатой, если в этом параметре передано «1». В таком случае покупатель будет перенаправлен на страницу с информацией о том, что ему было выслано письмо со ссылкой на страницу для продолжения проведения платежа. Если этот параметр присутствует в запросе, то должен быть указан также pg_user_contact_email, иначе пользователь будет перенаправлен на уточнение платежных параметров, где он сможет, указать email и попробовать отложить платеж ещё раз. | |
| pg_language | ru | Язык платежных страниц на сайте Platron и (если возможно) платежных систем. Значение ru устанавливает русский язык, en – английский. |
| pg_testing_mode | Из настроек магазина | Флаг, принимает значение 0 или 1. Подробное описание см. в разделе Тестирование. |
| pg_recurring_start | 0 | Флаг, принимает значение 0 или 1. Подробное описание см. в разделе Рекуррентные платежи. |
| pg_recurring_lifetime | Время на продолжении которого продавец рассчитывает использовать профиль рекуррентных платежей.
Минимально допустимое значение 1 (1 месяц). Максимально допустимое значение: 156 (13 лет). В случае выхода за пограничные значения будет безакцептно присвоено минимальное или максимальное значение, соответственно. Подробное описание см. в разделе Рекуррентные платежи. |
|
| pg_items | Позиции чека для отправки в ОФД. Формат данных такой же как в поле pg_items в запросе на отправку чека в ОФД. Услуга должна быть подключена, за настройкой необходимо обратиться к менеджеру. | |
| Дополнительные параметры продавца | Можно передавать произвольные дополнительные параметры, имена которых не начинаются на pg_. Все эти параметры будут переданы на pg_check_url, pg_result_url, pg_success_url, pg_failure_url. Имена дополнительных параметров продавца должны быть уникальны. |
1. Для банковских платежных систем ввод данных карты осуществляется на стороне магазина только при наличии сертификата PCI DSS и договоренности с менеджером. 2. Параметр учитывается во фрод мониторинге при оплате банковской картой. Для корректной работы фрод-мониторинга нужны настоящие данные пользователя.