Общие принципы взаимодействия
Правила формирования запроса:
- Используемая кодировка — UTF-8.
- Имена всех параметров, которые касаются взаимодействия Platron и магазина, имеют префикс pg_. Все прочие параметры его не имеют.
- Во всех денежных суммах:
- для отделения дробной части используется точка.
- если число целое, то указание дробной части необязательно.
- число знаков после точки – не более двух.
- тысячи не отделяются никакими знаками.
- Любые сообщения (запросы и ответы) между Platron и магазином подписываются.
Формирование подписи
Пример вызова http://domain.com/path/to/script.php
<?xml version="1.0" encoding="utf-8"?>
<request>
<pg_salt>9imM909TH820jwk387</pg_salt>
<pg_t_param>value3</pg_t_param>
<pg_a_param>value1</pg_a_param>
<pg_z_param>
<pg_q_subparam>subvalue2</pg_q_subparam>
<pg_m_subparam>subvalue1</pg_m_subparam>
</pg_z_param>
<pg_b_param>value2</pg_b_param>
<pg_sig>a8a4d5a9188f24038a14a4d65c387bf7</pg_sig>
</request>
В данном примере pg_sig вычисляется по формуле:
pg_sig = md5('script.php' + ';' + pg_a_param + ';' + pg_b_param + ';' + pg_salt + ';' + pg_t_param + ';' + pg_m_subparam + ';' + pg_q_subparam + ';' + secret_key);
Если в настройках было указано, что secret_key равен mypasskey, то после подстановки значений получится:
pg_sig = md5('script.php;value1;value2;9imM909TH820jwk387;value3;subvalue1;subvalue2;mypasskey')
pg_sig = 'a8a4d5a9188f24038a14a4d65c387bf7'
Для обеспечения безопасности все сообщения между Platron и сторонними магазинами подписываются специальным образом. Для формирования подписи необходимо выполнить следующие шаги:
- Получить имя вызываемого скрипта. Это часть URL от последнего слеша “/" до конца или вопросительного знака “?".
- Получить все параметры сообщения. Если сообщение в формате XML, то параметры берутся из всех вложенных тегов в алфавитном порядке. Параметры с одинаковыми именами берутся в том порядке, в котором они присутствуют в сообщении.
- Получить случайную строку pg_salt. Это строка, состоящая из произвольного количества цифр и букв латинского алфавита.
- Конкатенировать полученные значения с разделителем “;". Порядок конкатенации следующий: имя скрипта, все поля сообщения, pg_salt и платежный пароль secret_key, который задается в настройках магазина.
- Вычислить MD5-хэш от полученной строки.
- Записать полученный MD5-хэш в виде шестнадцатеричной строки в нижнем регистре длиной 32 символа (pg_sig).
- Добавить параметр pg_sig в запрос или ответ.
Любая сторона может добавлять в запрос или ответ дополнительные параметры, не указанные в документации. Эти параметры также участвуют в вычислении подписи.
Если Platron не может идентифицировать магазин (мерчанта), поэтому он не знает его секретный ключ (secret_key), то сообщение не подписывается и, следовательно, параметры pg_salt и pg_sig отсутствуют. В этом случае поле pg_error_code, которое содержит числовой код ошибки, принимает значение 101. Для проверки корректности формирования подписи рекомендуется использовать специальный инструмент в личном кабинете магазина: Проверка подписи к запросу.
Прямое взаимодействие
При передаче через GET сложных структурированных данных, таких как многомерные массивы, используется следующий формат записи:
https://www.platron.ru/script.php?param_1=val1&m_2[subparam_1]=val2&m_2[subparam_2]=val3&m_3=val4
Пример xml запроса:
<?xml version="1.0" encoding="utf-8"?>
<request>
<pg_param1>value1</pg_param1>
<pg_param2>value2</pg_param2>
<pg_param3>value3</pg_param3>
</request>
Пример успешного ответа:
<?xml version="1.0" encoding="utf-8"?>
<response>
<pg_status>ok</pg_status>
<pg_param1>value1</pg_param1>
<pg_param2>value2</pg_param2>
<pg_param3>value3</pg_param3>
</response>
Пример ответа с ошибкой:
<?xml version="1.0" encoding="utf-8"?>
<response>
<pg_salt>19imfwM909TH820jwk387</pg_salt>
<pg_status>error</pg_status>
<pg_error_code>200</pg_error_code>
<pg_error_description>amount not specified</pg_error_description>
<pg_sig>ccde41a4f425d124a23c3a53a3140bdc158ac</pg_sig>
</response>
Используются три способа прямой передачи информации между магазином и Platron:
- Методом GET – данные передаются в параметрах методом GET.
- Методом POST – данные передаются в параметрах методом POST.
- Через XML – запросы передаются методом POST в единственном параметре pg_xml:
Независимо от способа формирования запроса (GET, POST или XML) ответ всегда выдается в формате XML.
Ответ всегда содержит параметр pg_status, указывающее на результат выполнения запроса. Оно принимает значение ok в
случае
успешного выполнения запроса и error – при возникновении ошибки. В последнем случае в ответе будут
присутствовать поля:
- pg_error_code – числовой код ошибки (возможные значения перечислены в разделе Справочнике кодов ошибок)
- pg_error_description – описание ошибки (необязательное поле).
Через браузер пользователя
Platron и магазин могут передавать информацию друг другу одновременно с передачей управления покупателем. Передача может происходить по действию покупателя или автоматически.
Передача информации по действию покупателя
Передача покупателя и информации между Platron и магазином возможна следующими способами:
- Ссылка, ведущая на другой сайт
- Форма, действие которой перенаправляет на другой ресурс. Пользователь сам нажимает кнопку.
Автоматическая передача информации
Пример авто-самбит формы
<html>
<body onload="document.forms[0].submit()">
<form method="POST" action="https://www.platron.ru/payment.php">
<input type="hidden" name="pg_param1" value="value1"/>
<input type="hidden" name="pg_param2" value="value2"/>
<input type="hidden" name="pg_param3" value="value3"/>
<input type="hidden" name="pg_param4" value="value4"/>
</form>
</body>
</html>
Автоматическая передача покупателя и информации между Platron и магазином возможна следующими способами:
- Использование HTTP редиректа 302 (заголовок Location) - только для метода GET.
- Автоматическая отправка формы. Поддерживаются методы GET и POST. Веб-сайт предоставляет пользователю страницу, содержащую форму, действие которой перенаправляет на другой ресурс. Форма содержит только скрытые поля и автоматически отправляется при событии onload, поэтому пользователь не видит эту страницу.
Настройки электронного магазина
Перед началом работы необходимо заполнить следующие настройки магазина в Platron.
| Параметр | Описание |
|---|---|
| Название магазина | Название магазина, будет отображаться на страницах platron.ru при взаимодействии с покупателем |
| Логотип магазина | Логотип магазина, будет отображаться на страницах platron.ru при взаимодействии с покупателем |
| Метод передачи данных магазину (Request Method) | Этот параметр определяет метод передачи данных при прямых обращениях Platron к вашему магазину. Возможные значения: GET, POST и XML. |
| URL проверки (Check URL) | URL скрипта вашего магазина, который вызывает Platron для проверки возможности совершения платежа. Это необходимо для предотвращения оплаты по просроченным заказам (например, если срок брони на билеты истек). Если вы не указали URL скрипта проверки, то проверка производиться не будет. |
| URL результата (Result URL) | URL скрипта вашего магазина, на который Platron отправляет результаты платежей. Если вы не указали адрес этого скрипта, результаты не будут отправляться. |
| URL отмены (Refund URL) | URL скрипта вашего магазина, на который Platron отправляет уведомление об отмене платежей. Если вы не указали адрес этого скрипта, уведомления отправляться не будут. |
| URL клиринга (Capture URL) | URL скрипта вашего магазина, на который Platron отправляет уведомление о проведении клиринга платежа по банковской карте. Если вы не указали адрес этого скрипта, уведомления отправляться не будут. |
| Success URL | URL скрипта вашего магазина, на который пользователь перенаправляется после успешного совершения платежа. |
| Метод вызова Success URL (Success URL Method) | Возможные значения: GET, POST, AUTOGET, AUTOPOST. В зависимости от выбранного значения, пользователю либо отображается страница на сайте platron.ru и предлагается нажать кнопку для возврата на сайт магазина (GET, POST), либо он автоматически перенаправляется обратно на сайт магазина без просмотра этой страницы (AUTOGET, AUTOPOST) |
| Failure URL | URL скрипта вашего магазина, на который пользователь перенаправляется в случае неуспешной оплаты. |
| Метод вызова Failure URL (Failure URL Method) | См. Метод вызова Success URL |
| State URL | URL скрипта вашего магазина, на который пользователь перенаправляется для ожидания ответа от платежной системы. |
| Метод вызова State URL (State URL Method) | См. Метод вызова Success URL |
| Site URL | URL скрипта вашего магазина, на который пользователь может вернуться после создания счета. Применяется для offline ПС (наличные). |
| Брать переплату | Во всех платежных системах, где это возможно, Платрон позволяет клиенту заплатить только ровно ту сумму, которую от него ожидают. Однако некоторые платежные системы, например, оплата через банковский перевод, не позволяют предотвратить переплату. Эта настройка говорит, готов ли магазин брать переплату на себя. |
| Отправлять уведомления по смс покупателю | Настройка отвечает за то – будут ли посылаться уведомления клиенту о статусе транзакции по смс (если услуга смс оповещений подключена). По умолчанию клиент уведомляется. |
| Отправлять уведомления по email покупателю | Настройка отвечает за то – будут ли посылаться уведомления клиенту о статусе транзакции по email. По умолчанию клиент уведомляется. |
| Платежный пароль (secret_key) | Используется для защиты данных, передаваемых Platron магазину и магазином Platron |
Все указанные параметры, кроме информации о магазине и secret_key, могут переопределяться для каждого конкретного платежа в момент инициализации платежа.
Список ПС
https://www.platron.ru/ps_list.php?pg_salt=123&pg_merchant_id=456&pg_amount=800.45&pg_currency=RUB&pg_sig=aec5f9d237952f83bd05c602d287098d
<?xml version="1.0" encoding="utf-8"?>
<request>
<pg_salt>123</pg_salt>
<pg_merchant_id>456</pg_merchant_id>
<pg_amount>800.45</pg_amount>
<pg_currency>RUB</pg_currency>
<pg_sig>aec5f9d237952f83bd05c602d287098d</pg_sig>
</request>
Этот метод позволяет получить информацию о доступных платежных системах и итоговых суммах с учетом комиссий.
URL запроса
https://www.platron.ru/ps_list.php
Параметры запроса
Обязательные параметры выделены жирным
| Параметр | Значение по умолчанию | Описание |
|---|---|---|
| pg_merchant_id | (string[16]) идентификатор продавца | |
| pg_amount | (decimal) сумма счета в системе продавца в валюте pg_currency. | |
| pg_currency | RUB | (string[3]) валюта счета |
| pg_testing_mode | 0 | Флаг, принимает значение 0 или 1. Подробное описание см. в разделе Тестирование. |
| pg_salt | Случайная строка | |
| pg_sig | Подпись |
Параметры ответа
Пример ответа:
<?xml version="1.0" encoding="utf-8"?>
<response>
<pg_salt>9938745</pg_salt>
<pg_status>ok</pg_status>
<pg_payment_system>
<pg_name>MIXPLATMTS</pg_name>
<pg_description>Оплата со счета мобильного телефона МТС</pg_description>
<pg_payment_scenario>offline</pg_payment_scenario>
<pg_amount_to_pay>808.67</pg_amount_to_pay>
<pg_amount_to_pay_currency>RUB</pg_amount_to_pay_currency>
<pg_category>mobile</pg_category>
</pg_payment_system>
<pg_payment_system>
<pg_name>CASH</pg_name>
<pg_description>Наличные: Евросеть, ОСМП, Элекснет</pg_description>
<pg_payment_scenario>offline</pg_payment_scenario>
<pg_amount_to_pay>830.00</pg_amount_to_pay>
<pg_amount_to_pay_currency>RUB</pg_amount_to_pay_currency>
<pg_category>cash</pg_category>
<pg_sub_payment_systems>
<pg_sub_payment_system>
<pg_sub_name>ELECSNET</pg_sub_name>
<pg_sub_description>Elecsnet</pg_sub_description>
</pg_sub_payment_system>
<pg_sub_payment_system>
<pg_sub_name>EUROSET</pg_sub_name>
<pg_sub_description>Евросеть</pg_sub_description>
</pg_sub_payment_system>
<pg_sub_payment_system>
<pg_sub_name>QIWI</pg_sub_name>
<pg_sub_description>QIWI</pg_sub_description>
</pg_sub_payment_system>
</pg_sub_payment_systems>
</pg_payment_system>
<pg_payment_system>
<pg_name>WEBMONEYRBANK</pg_name>
<pg_description>Система WebMoney</pg_description>
<pg_payment_scenario>online</pg_payment_scenario>
<pg_amount_to_pay>810.35</pg_amount_to_pay>
<pg_amount_to_pay_currency>RUB</pg_amount_to_pay_currency>
<pg_category>wallet</pg_category>
</pg_payment_system>
<pg_payment_system>
<pg_name>YANDEXMONEY</pg_name>
<pg_description>Система Яндекс-деньги</pg_description>
<pg_payment_scenario>online</pg_payment_scenario>
<pg_amount_to_pay>812.15</pg_amount_to_pay>
<pg_amount_to_pay_currency>RUB</pg_amount_to_pay_currency>
<pg_category>wallet</pg_category>
</pg_payment_system>
<pg_sig>73daf9d237952f56bd05c602d2878dc2</pg_sig>
</response>
В теге response находится список платежных систем и подпись. Описание каждой платежной системы находится внутри тега pg_payment_system с уникальным идентификатором в атрибуте pg_name – именем платежной системы. Для каждой системы могут быть возвращены параметры:
| Параметр | Описание |
|---|---|
| pg_name | (string[32]) имя платежной системы |
| pg_description | (string[256]) описание системы, можно показывать пользователю |
| pg_payment_scenario | Сценарий приема платежа: offline или online |
| pg_amount_to_pay | (decimal) сумма, которую заплатит пользователь |
| pg_amount_to_pay_currency | валюта, которую заплатит пользователь |
| pg_category | Категория платежной системы для удобства вывода списка ПС на стороне магазина. Возможные значения см. в разделе Справочник платежных систем и групп |
| pg_required | (string[32]) имя обязательного для заполнения параметра, если таковой имеется. Если обязательных параметров несколько, то каждый выводится в отдельной тэге pg_required. |
| pg_additional | (string[32]) Не обязательный параметр аналогично pg_required |
| pg_sub_payment_systems | контейнер для платежных систем в группе |
| pg_sub_name | (string[32]) имя платежной системы в группе |
| pg_sub_description | (string[256]) описание платежной системы в группе, можно показывать пользователю вместо или в дополнение к pg_description платежной системы |
| pg_salt | Случайная строка |
| pg_sig | Подпись |
Ответ на запрос представляет собой XML (в кодировке utf-8), содержащий список доступных для этого магазина платежных систем и их атрибутов. Атрибутами являются сумма и валюта платежа, имя и описание ПС, а также список дополнительных параметров pg_required, обязательных для данной ПС. Так же в ответе присутствует список параметров, которые можно присылать дополнительно для платежных систем pg_additional.
Магазин должен контролировать заполнение этих параметров. Если выбрана платежная система, для которой есть обязательный к заполнению параметр, но этот параметр не передан, то оно будет запрошено у покупателя на сайте www.platron.ru.
Список платежных систем в ответе отсортирован по параметру pg_name, а внутри группы по pg_sub_name. Если платежная система представляет собой группу платежных систем, то список платежных систем, входящих в группу, представлен в теге pg_sub_payment_systems.
Пример построения списка для выбора платежной системы можно увидеть на сайте www.platron.ru, если не передавать идентификатор ПС при инициализации платежа.
Инициализация платежа
Общее
Для создания платежной транзакции (инициализации платежа) магазин должен выполнить два действия:
- передать данные о платеже Platron
- передать покупателя в управление Platron
Это возможно сделать двумя способами:
- передать информацию о платеже через браузер пользователя, при этом одновременно пользователь переходит на сайт Platron.
- передать информацию о платеже напрямую в Platron, в ответ получить идентификатор платежной транзакции и URL для последующего перенаправления покупателя, а затем перенаправить покупателя на этот URL.
В обоих случаях состав передаваемых данных совершенно идентичен, различаются лишь способ передачи и формат ответа.
Обязательные параметры:
| Параметр | Описание |
|---|---|
| pg_merchant_id | Идентификатор продавца в Platron. Выдается при подключении. |
| pg_amount | Сумма платежа в валюте pg_currency |
| pg_description | (string[1024]) Описание товара или услуги. Отображается покупателю в процессе платежа. |
| pg_salt | Случайная строка |
| pg_sig | Подпись |
Не обязательные параметры:
| Параметр | Значение по умолчанию | Описание |
|---|---|---|
| pg_order_id | (string[50]) Идентификатор платежа в системе продавца. Рекомендуется поддерживать уникальность этого поля. | |
| pg_currency | RUB | (string[3]) Валюта, в которой указана сумма. Возможные варианты: RUB, USD, EUR. В случае выбора покупателем способа платежа в другой валюте, производится пересчет по курсу ЦБ на день платежа. Полный список возможных значений см. в разделе Справочник валют. |
| 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, POST, AUTOGET, AUTOPOST. В зависимости от выбранного значения, пользователю либо отображается страница на сайте platron.ru и предлагается нажать кнопку для возврата на сайт магазина (GET, POST), либо он автоматически перенаправляется обратно на сайт магазина без просмотра этой страницы (AUTOGET, AUTOPOST) |
| pg_failure_url_method | Из настроек магазина Failure URL Method | См. Метод вызова Success URL |
| pg_payment_system | Идентификатор выбранной ПС или группы ПС. Примеры: webmoney yandexmoney EUROSET cyberplat CASH cash Полный список возможных значений см. в разделе Справочник платежных систем и групп. Этот параметр передается только если выбор платежной системы совершается на сайте продавца. Если параметр не указан, то выбор ПС совершается на сайте platron.ru[1] | |
| pg_lifetime | 86400 (сутки) | Время в секундах в течение которого платеж должен быть завершен, в противном случае заказ при проведении платежа Platron откажет платежной системе в проведении. Этот параметр контролируется Platron, а также, если платежная система поддерживает такую возможность, и платежной системой. См. Справочник платежных систем и групп. Минимально допустимое значение: 300 секунд (5 минут). Максимально допустимое значение: 604800 секунд (7 суток). В случае выхода за пограничные значения будет присвоено минимальное или максимальное значение, соответственно |
| pg_user_phone | (int[14]) телефон пользователя (для России начиная с цифр 79..), необходим для идентификации покупателя. Если не указан, выбор будет предложен пользователю на сайте платежного гейта. | |
| pg_user_contact_email | (string[100]) Контактный адрес электронной почты пользователя. Если указан, на этот адрес будут высылаться уведомления об изменении статуса транзакции. | |
| pg_user_ip | IPv4 адрес клиента. Необходим для разбора спорных ситуаций в случае подозрения на мошенничество. Параметр можно не передавать при передаче информации через браузер пользователя, в этом случае будет записан тот IP, с которого пользователь перешёл на страницу инициализации платежа. | |
| pg_user_ipv6 | IPv6 адрес клиента (если есть). Необходим для разбора спорных ситуаций в случае подозрения на мошенничество. Параметр можно не передавать при передаче информации через браузер пользователя, в этом случае будет записан тот IP, с которого пользователь перешёл на страницу инициализации платежа. | |
| pg_testing_mode | Из настроек магазина | Флаг, принимает значение 0 или 1. Подробное описание см. в разделе Тестирование. |
| pg_recurring_start | 0 | Флаг, принимает значение 0 или 1. Подробное описание см. в разделе Рекуррентные платежи. |
| pg_items | Позиции чека для отправки в ОФД. Формат данных такой же как в параметре pg_items в запросе на отправку чека в ОФД. Услуга должна быть подключена, за настройкой необходимо обратиться к менеджеру. | |
| Дополнительные параметры продавца | Можно передавать произвольные дополнительные параметры, имена которых не начинаются на pg_. Все эти параметры будут переданы на pg_check_url, pg_result_url, pg_success_url, pg_failure_url. Имена дополнительных параметров продавца должны быть уникальны. |
| Параметр | Значение по умолчанию | Описание |
|---|---|---|
| pg_check_url | Из настроек магазина Check URL | (string[1024]) URL для проверки возможности платежа. Вызывается перед платежом, если платежная система предоставляет такую возможность. Если параметр не указан, то берется из настроек магазина. Если параметр установлен равным пустой строке, то проверка возможности платежа не производится. |
| pg_state_url | Из настроек магазина State URL | (string[1024]) URL скрипта на сайте магазина, куда перенаправляется покупатель для ожидания ответа от платежной системы. |
| pg_state_url_method | Из настроек магазина State URL Method | См. Метод вызова Success URL |
| pg_site_url | Из настроек магазина Site URL | URL сайта магазина для показа покупателю ссылки, по которой он может вернуться на сайт магазина после создания счета. Применяется для offline ПС (наличные). |
| pg_need_phone_notification | 1 | Необходимость оповещения клиента (если услуга подключена) по смс о статусе транзакции. 0 – не уведомлять. |
| pg_need_email_notification | 1 | Необходимость оповещения клиента (если услуга подключена) по email о статусе транзакции. 0 – не уведомлять. |
| pg_language | ru | Язык платежных страниц на сайте Platron и (если возможно) платежных систем. Значение ru устанавливает русский язык, en – английский. |
| pg_recurring_lifetime | Время на продолжении которого продавец рассчитывает использовать профиль рекуррентных платежей. Минимально допустимое значение 1 (1 месяц). Максимально допустимое значение: 156 (13 лет). В случае выхода за пограничные значения будет присвоено минимальное или максимальное значение, соответственно. Подробное описание см. в разделе Рекуррентные платежи. | |
| pg_postpone_payment | Создание платежа с отложенной оплатой, если в этом параметре передано «1». В таком случае покупатель будет перенаправлен на страницу с информацией о том, что ему было выслано письмо со ссылкой на страницу для продолжения проведения платежа. Если этот параметр присутствует в запросе, то должен быть указан также pg_user_contact_email, иначе пользователь будет перенаправлен на уточнение платежных параметров, где он сможет, указать email и попробовать отложить платеж ещё раз. |
Host-To-Host
При прямой передаче данных от магазина в Platron магазин должен посылать данные на URL
URL запроса
https://www.platron.ru/init_payment.php
Параметры ответа
Пример ответа:
<?xml version="1.0" encoding="utf-8"?>
<response>
<pg_salt>ijoi894j4ik39lo9</pg_salt>
<pg_status>ok</pg_status>
<pg_payment_id>15826</pg_payment_id>
<pg_redirect_url>
https://www.platron.ru/payment_params.php?customer=ccaa41a4f425d124a23c3a53a3140bdc15826
</pg_redirect_url>
<pg_redirect_url_type>need data</pg_redirect_url_type>
<pg_sig>af8e41a4f425d124a23c3a53a3140bdc17ea0</pg_sig>
</response>
Ответ в случае ошибки:
<?xml version="1.0" encoding="utf-8"?>
<response>
<pg_status>error</pg_status>
<pg_error_code>101</pg_error_code>
<pg_error_description>Empty merchant</pg_error_description>
</response>
| Параметр | Описание |
|---|---|
| pg_payment_id | Уникальный идентификатор платежной транзакции в Platron. Служит ключом для всей дальнейшей работы с транзакцией. |
| pg_redirect_url | URL для перенаправления пользователя. Может быть как на сайте www.platron.ru , так и на сайте платежной системы |
| pg_redirect_url_type | Тип страницы, на которую происходит перенаправление. Возможные значения: need data – диалог с покупателем с целью уточнения параметров: платежной системы, номера телефона, обязательных для данной платежной системы параметров; payment system – страница сайта платежной системы либо страница с инструкциями оплаты через данную платежную систему. Страница с инструкциями может располагаться как на сайте platron.ru, так и на сайте магазина. |
| pg_receipt_id | Номер созданного чека. Возвращается, если были переданы позиции чека в pg_items |
| pg_salt | Случайная строка |
| pg_sig | Подпись |
| pg_error_code | Код ошибки |
| pg_error_description | Описание ошибки |
В случае получения магазином ответа с pg_redirect_url_type="need data", магазин может не перенаправлять покупателя по полученному URL, а уточнить недостающие параметры у себя на сайте. В этом случае после уточнения параметров и повторного запроса на создание платежной транзакции будет создана новая транзакция.
Через браузер пользователя
https://www.platron.ru/payment.php?pg_merchant_id=111&pg_amount=1000&pg_order_id=123&pg_check_url=http://www.shop.ru/check.php&pg_result_url=http://www.shop.ru/result.php&pg_success_url=http://www.shop.ru/thankyou.php&pg_failure_url=http://www.shop.ru/failed.php&pg_description=Ticket+SU1234+Moscow-Berlin+1+Jun+2008&custom_param1=gagaga&custom_param2=gugugu&pg_sig=af8e41a4f425d124a23c3a53a3140bdc17ea0
При передаче информации через браузер пользователя, пользователь должен передаваться методом POST или GET.
URL запроса
https://www.platron.ru/payment.php
В случае ошибки сообщение об ошибке выводится на экран пользователя.
В случае если магазином переданы не все параметры, необходимые для создания платежной транзакции (платежная система, телефон пользователя и параметры, необходимые для выбранной платежной системы), они запрашиваются у пользователя на сайте www.platron.ru
Рекуррентные платежи
Для использования профиля рекуррентных платежей магазину следует инициализировать платеж обычным способом c передачей дополнительного параметра pg_recurring_start, обозначающий требование создания рекуррентного профиля и указанием платежной системы, поддерживающей рекуррентные платежи, в параметре pg_payment_system ( см. Справочник платежных систем). Номер профиля для повторения платежа будет передан при оповещении о результате платежа в параметре pg_recurring_profile. Перед использованием рекуррентных платежей необходимо обратиться к менеджеру для уточнения деталей.
Повторение платежа
https://www.platron.ru/make_recurring_payment.php?pg_merchant_id=82&pg_recurring_profile=109642&pg_description=example&pg_salt=my_salt&pg_sig=3fe59db16e24d78bfecfd8d72324b83c
Ответ
<?xml version="1.0" encoding="UTF-8"?>
<response>
<pg_salt>my_salt</pg_salt>
<pg_status>ok</pg_status>
<pg_payment_id>22241128</pg_payment_id>
<pg_amount>1</pg_amount>
<pg_currency>RUB</pg_currency>
<pg_recurring_profile_id>109642</pg_recurring_profile_id>
<pg_recurring_profile_expiry_date>2029-01-29 00:00:00</pg_recurring_profile_expiry_date>
<pg_sig>5b2ff43cfa1b7588e5844484f0843b11</pg_sig>
</response>
Магазин может повторять платежи по рекуррентному профилю в любой момент по своему усмотрению.
URL запроса
https://www.platron.ru/make_recurring_payment.php
Параметры запроса
| Параметр | Значение по умолчанию | Описание |
|---|---|---|
| pg_merchant_id | Идентификатор продавца в Platron. Выдается при подключении. | |
| pg_order_id | Идентификатор платежа в системе продавца. Рекомендуется поддерживать уникальность этого поля. | |
| pg_recurring_profile | Идентификатор рекуррентного профиля. Был получен продавцом при создании профиля рекуррентных платежей | |
| pg_amount | Значение первоначального платежа | Сумма платежа в валюте pg_currency. В случае если не была передана сумма, в качестве суммы для повторения платежа, будет использовано значение первоначального платежа. |
| pg_result_url | Из настроек магазина Result URL | (string[256]) URL для сообщения о результате платежа. Вызывается после платежа в случае успеха или неудачи. Если параметр не указан, то берется из настроек магазина. Если параметр установлен равным пустой строке, то Platron не сообщает магазину о результате платежа. |
| pg_refund_url | Из настроек магазина Refund URL | (string[256]) URL для сообщения об отмене платежа. Вызывается после платежа в случае отмены платежа на стороне Platron или ПС. Если параметр не указан, то берется из настроек магазина. |
| pg_request_method | Из настроек магазина Request Method | (string[4]) GET, POST или XML – метод вызова скриптов магазина Check URL, Result URL, Refund URL, Capture URL для передачи информации от платежного гейта. |
| pg_description | (string[1024]) Описание товара или услуги. Отображается покупателю в процессе платежа. | |
| Дополнительные параметры продавца | Можно передавать произвольные дополнительные параметры, имена которых не начинаются на pg_. Все эти параметры будут переданы на pg_check_url, pg_result_url, pg_success_url, pg_failure_url. Имена дополнительных параметров продавца должны быть уникальны. | |
| pg_salt | Случайная строка | |
| pg_sig | Подпись |
Параметры ответа
| Параметр | Описание |
|---|---|
| pg_payment_id | Уникальный идентификатор платежной транзакции в Platron. Служит ключом для всей дальнейшей работы с транзакцией. |
| pg_amount | Сумма платежа в валюте pg_currency. |
| pg_currency | Валюта, в которой указана сумма. |
| pg_recurring_profile_id | Идентификатор профиля рекуррентных платежей |
| pg_recurring_profile_expiry_date | Дата, до которой рекуррентный профиль доступен к использованию |
| pg_salt | Случайная строка |
| pg_sig | Подпись |
| pg_error_code | Код ошибки |
| pg_error_description | Описание ошибки |
О результате платежа, Platron оповестит продавца на Result URL
По расписанию
Для рекуррентного профиля можно указать расписание платежей. В этом случае платежи будут совершаться по указанному расписанию автоматически. Указать расписание можно либо в виде шаблона, либо в виде простого списка дат.
Создание расписания
Пример с указанием шаблона.
Для лучшей читаемости в примере не экранированы служебные символы.
https://www.platron.ru/index.php/api/recurring/set-schedule?pg_merchant_id=82&pg_recurring_profile=337146&pg_amount=21.23&pg_template[pg_start_date]=2018-08-15 15:30:00&pg_template[pg_interval]=week&pg_template[pg_period]=2&pg_template[pg_max_periods]=5&pg_salt=salt&pg_sig=5036eda9b1a31d5d8ed825c5d658ad43
<?xml version="1.0" encoding="UTF-8"?>
<request>
<pg_merchant_id>82</pg_merchant_id>
<pg_recurring_profile>337146</pg_recurring_profile>
<pg_amount>12.41</pg_amount>
<pg_template>
<pg_start_date>2018-08-15 15:30:00</pg_start_date>
<pg_interval>week</pg_interval>
<pg_period>2</pg_period>
<pg_max_periods>5</pg_max_periods>
</pg_template>
<pg_salt>salt</pg_salt>
<pg_sig>458a8161df06e21bcc6967c44e9965qw</pg_sig>
</request>
Пример со списком дат.
Для лучшей читаемости в примере не экранированы служебные символы.
https://www.platron.ru/index.php/api/recurring/set-schedule?pg_merchant_id=82&pg_recurring_profile=337146&pg_amount=21.23&pg_dates[]=2018-08-15 14:00:00&pg_dates[]=2018-08-15 14:30:00&pg_dates[]=2018-08-15 15:00:00&pg_salt=salt&pg_sig=0d32e1bfb8795a7c2a7ff86973vct5er
<?xml version="1.0" encoding="UTF-8"?>
<request>
<pg_merchant_id>82</pg_merchant_id>
<pg_recurring_profile>337146</pg_recurring_profile>
<pg_amount>12.41</pg_amount>
<pg_dates>2018-08-15 14:00:00</pg_dates>
<pg_dates>2018-08-15 14:30:00</pg_dates>
<pg_dates>2018-08-15 15:00:00</pg_dates>
<pg_salt>salt</pg_salt>
<pg_sig>b71988a7cc47ae411d9292a0933944ac</pg_sig>
</request>
URL запроса
https://www.platron.ru/index.php/api/recurring/set-schedule
Параметры запроса
| Параметр | Описание |
|---|---|
| pg_merchant_id | Идентификатор продавца |
| pg_recurring_profile | Идентификатор рекуррентного профиля |
| pg_amount | Сумма рекуррентного платежа |
| pg_template* | Данные шаблона (описание параметров ниже) |
| pg_dates* | Список дат в формате YYYY-MM-DD HH:MM:SS |
| pg_salt | Случайная строка |
| pg_sig | Подпись |
*Для создания расписания необходимо указать либо данные шаблона, либо список дат. Если одновременно будут указаны данные шаблона и список дат, для создания расписания будет использован список дат.
Параметры шаблона (pg_template):
| Параметр | Описание |
|---|---|
| pg_start_date | Дата и время первого платежа в формате YYYY-MM-DD HH:MM:SS |
| pg_interval* | Интервал. Возможные значения: day, week, month |
| pg_period* | Период. |
| pg_max_periods | Максимальной кол-во платежей. |
*Период используется в сочетании с интервалом. Например, 1 month означает раз в месяц, 2 week означает раз в две недели.
Ответ при удачном создании расписания.
<?xml version="1.0" encoding="UTF-8"?>
<response>
<pg_status>ok</pg_status>
<pg_recurring_profile>337146</pg_recurring_profile>
<pg_salt>salt</pg_salt>
<pg_sig>a764fb36af2e607ee2e841989adr65ty</pg_sig>
</response>
Закрытие рекуррентного профиля
Необходимо удалить расписание в Платроне, если оно создавалось, и пометить такой профиль как закрытый в своей системе учета.
Статус платежа
https://www.platron.ru/get_status.php?pg_salt=9865&pg_merchant_id=82&pg_payment_id=765432&pg_sig=a1b7ccc945c0a60949f6bd6383f5f768
<?xml version="1.0" encoding="utf-8"?>
<request>
<pg_salt>9865</pg_salt>
<pg_merchant_id>82</pg_merchant_id>
<pg_payment_id>765432</pg_payment_id>
<pg_sig>a1b7ccc945c0a60949f6bd6383f5f768</pg_sig>
</request>
Магазин может запрашивать Platron о статусе любого платежа, инициированного магазином. Это может быть полезно, например, в случае если вызов Result URL не был получен магазином из-за временного сбоя связи, а покупатель уже был передан на Success URL, однако статус транзакции магазину еще не известен.
URL запроса
https://www.platron.ru/get_status.php
Параметры запроса
Все параметры обязательные
| Параметр | Описание |
|---|---|
| pg_merchant_id | Идентификатор магазина |
| pg_payment_id* | Идентификатор платежа в Платрон. |
| pg_order_id* | Идентификатор платежа в системе магазина. |
| pg_salt | Случайная строка |
| pg_sig | Подпись |
*Требуется либо pg_payment_id, либо pg_order_id. В случае с pg_order_id, если он не уникальный, то будет выдана информация для последнего платежа с данным order_id.
Параметры ответа
<?xml version="1.0" encoding="utf-8"?>
<response>
<pg_salt>9865</pg_salt>
<pg_status>ok</pg_status>
<pg_payment_id>1234567</pg_payment_id>
<pg_transaction_status>ok</pg_transaction_status>
<pg_can_reject>1</pg_can_reject>
<pg_create_date>2009-01-12 10:22:30</pg_create_date>
<pg_result_date>2009-01-12 10:25:07</pg_result_date>
<pg_payment_system>RUSSIANSTANDARD</pg_payment_system>
<pg_card_brand>CA</pg_card_brand>
<pg_card_pan>527594******4984</pg_card_pan>
<pg_card_hash>022380c107141f7e11f4271d7f6412a715222c32</pg_card_hash>
<pg_auth_code>014318</pg_auth_code>
<pg_captured>0</pg_captured>
<pg_sig>8380d43c7719e6ce48da0c79aa7eb2ba</pg_sig>
</response>
<?xml version="1.0" encoding="utf-8"?>
<response>
<pg_salt>9865</pg_salt>
<pg_status>ok</pg_status>
<pg_payment_id>1234567</pg_payment_id>
<pg_transaction_status>pending</pg_transaction_status>
<pg_can_reject>1</pg_can_reject>
<pg_create_date>2009-01-12 10:22:30</pg_create_date>
<pg_sig>8380d43c7719e6ce48da0c79aa7eb2ba</pg_sig>
</response>
| Параметр | Описание |
|---|---|
| pg_status | Результат обработки запроса (не путать со статусом платежа) ok, если платеж найден и действительно принадлежит данному магазину error в любом другом случае. |
| pg_payment_id | Внутренний идентификатор платежа в системе Platron |
| pg_transaction_status | Статус платежа. См. Справочник статусов платежа |
| pg_can_reject | 0 или 1 – может ли платеж быть отменен. Значение 1 возможно только если статус платежа равен ok и платежная система предоставляет возможность отзыва платежа. В этом случае магазин может вызвать revoke.php как описано разделе Отмена счета после оплаты |
| pg_create_date | Дата и время создания платежной транзакции |
| pg_result_date | Дата и время успешного (ok) или неуспешного (failed) завершения платежа. Это дата вызова Result URL. Параметр заполняется только когда статус транзакции равен ok, failed или revoked. |
| pg_revoke_date | Дата и время отмены платежа. Параметр заполняется только когда статус транзакции равен revoked. |
| pg_payment_system | Идентификатор платежной системы, через которую прошел (должен пройти) платеж. |
| pg_card_issuer | Название эмитента. Этот параметр передается только в случае успешной оплаты банковской картой. |
| pg_card_brand | Бренд карты: CA – MasterCard и их продукты, VI – Visa, AX – AmericanExpress. Этот параметр передается только в случае успешной оплаты банковской картой. |
| pg_card_pan | Маскированный номер карты (часть цифр номера карты скрыты). Этот параметр передается только в случае успешной оплаты банковской картой. |
| pg_card_hash | Хешированный номер карты (номер карты, зашифрованный необратимым алгоритмом шифрования). Этот параметр передается только в случае успешной оплаты банковской картой. |
| pg_is_3ds | 0 или 1. Передается только в случае успешной оплаты банковской картой и показывает проходила ли оплата с использованием 3-D Secure. |
| pg_auth_code | Код авторизации. Этот параметр передается только в случае успешной оплаты банковской картой. |
| pg_rrn | RRN. Этот параметр передается только в случае успешной оплаты банковской картой. |
| pg_captured | 0 или 1. Передается только в случае успешной оплаты банковской картой и показывает, был ли произведен клиринг в момент авторизации (что зависит только от настроек магазина). Если значение этого параметра равно 0, магазин должен в последующем дать команду на клиринг (см. раздел Клиринг) или дождаться когда Platron сделает это сам. |
| pg_recurring_profile_id | Идентификатор профиля рекуррентных платежей. |
| pg_recurring_profile_expiry_date | Дата, до которой рекуррентный профиль доступен к использованию. |
| pg_failure_code | Код причины отказа (список кодов и их описание см. в Справочнике причин отказа). Присутствует только в случае pg_transaction_status = failed или revoked. |
| pg_failure_description | Описание причины неудачи платежа. Передается на языке транзакции. Данное описание сформулировано в понятных пользователю терминах и может быть сообщено ему любым доступным способом. Присутствует только в случае pg_transaction_status = failed или revoked. |
| pg_error_description | Описание ошибки выполнения запроса в случае pg_status=error (не путать с неудачной оплатой) |
| pg_salt | Случайная строка |
| pg_sig | Подпись |
Все даты записываются в формате YYYY-MM-DD hh:mm:ss.
Параметры ответа, которые больше не возвращаются
| Параметр | Описание |
|---|---|
| pg_accepted_payment_systems | Список платежных систем, в которые удалось выставить платеж. Присутствует в случае статуса платежа pendind |
| pg_overpayment | Сумма переплаты в валюте платежной системы. Параметр передается только в случае когда клиент оплатил больше, чем от него ожидалось, и переплата разрешена в настройках магазина. Если оплачено ровно столько, сколько ожидалось, или статус транзакции отличен от ok, этот параметр не передается. |
| pg_qr_code | QR ссылка на оплату транзакции |
Клиринг
https://www.platron.ru/do_capture.php?pg_salt=123&pg_merchant_id=456&pg_payment_id=1234567&pg_sig=7f3af9d237952f56bd05c602d2879a3c
<?xml version="1.0" encoding="utf-8"?>
<request>
<pg_salt>123</pg_salt>
<pg_merchant_id>456</pg_merchant_id>
<pg_payment_id>1234567</pg_payment_id>
<pg_sig>7f3af9d237952f56bd05c602d2879a3c</pg_sig>
</request>
Магазин может самостоятельно запрашивать клиринг у банка через Platron, если в банке настроено проведение платежей в два шага – авторизация и клиринг.
В случае соответствующей настройки системы, после проведения транзакции, транзакция будет авторизована, но не рассчитана. Максимальное время авторизации регулируется на стороне Платрон и может составлять до 5 календарных дней. Возможность настройки отложенного клиринга необходимо уточнять у вашего курирующего менеджера.
URL запроса
https://www.platron.ru/do_capture.php
Параметры запроса
| Параметр | Описание |
|---|---|
| pg_merchant_id | Идентификатор магазина |
| pg_payment_id | Идентификатор платежа |
| pg_long_record | Длинная запись, см. дополнительной документации. Ее можно получить у сотрудников технического отдела. |
| pg_amount | Сумма клиринга. Может быть меньше или равно суммы авторизации. |
| pg_salt | Случайная строка |
| pg_sig | Подпись |
Параметры ответа
Пример ответа
<?xml version="1.0" encoding="utf-8"?>
<response>
<pg_salt>1111</pg_salt>
<pg_status>ok</pg_status>
<pg_sig>c38ebf6a6b7f5e30316bc984dc69ce37</pg_sig>
</response>
| Параметр | Описание |
|---|---|
| pg_status | Результат обработки запроса. ok если запрос принят на обработку. По результату будет вызван Capture URL магазина. error в любом другом случае. |
| pg_error_description | Описание ошибки в случае pg_status=error |
| pg_salt | Случайная строка |
| pg_sig | Подпись |
Параметры ответа, которые больше не возвращаются
| Параметр | Описание |
|---|---|
| pg_clearing_refund_id | id операции возврата при клиринге на сумму, меньше чем сумма авторизации. Необходим для создания чека возврата на разницу суммы авторизации и клиринга |
Отмена счета
До оплаты
https://www.platron.ru/cancel.php?pg_salt=123&pg_merchant_id=456&pg_payment_id=1234567&pg_sig=628e300c3204c8ee398d878a5109b520
<?xml version="1.0" encoding="utf-8"?>
<request>
<pg_salt>123</pg_salt>
<pg_merchant_id>456</pg_merchant_id>
<pg_payment_id>1234567</pg_payment_id>
<pg_sig>628e300c3204c8ee398d878a5109b520</pg_sig>
</request>
Магазин может отменить выставленный, но ещё не оплаченный счёт. После совершения этой операции Platron будет отказывать в проведении платежа на этапе проверки возможности проведения платежа. Отмена счета на стороне платежной системы возможна в случае, если такой функционал ей поддерживается. (См. Справочник платежных систем))
URL запроса
https://www.platron.ru/cancel.php
Параметры запроса
| Параметр | Описание |
|---|---|
| pg_merchant_id | Идентификатор магазина |
| pg_payment_id | Идентификатор счёта |
| pg_salt | Случайная строка |
| pg_sig | Подпись |
Параметры ответа
Пример ответа:
<?xml version="1.0" encoding="utf-8"?>
<response>
<pg_salt>9865</pg_salt>
<pg_status>ok</pg_status>
<pg_sig>48caf9d237952f56bd05c602d28762da</pg_sig>
</response>
В случае ошибки:
<?xml version="1.0" encoding="utf-8"?>
<response>
<pg_salt>9865</pg_salt>
<pg_status>error</pg_status>
<pg_error_code>200</pg_error_code>
<pg_error_description>
transaction not found
</pg_error_description>
<pg_sig>ac08f9d237952f5bc4e5c602d2873481</pg_sig>
</response>
| Параметр | Описание |
|---|---|
| pg_status | Результат обработки запроса. |
| pg_error_code | Код ошибки |
| pg_error_description | Описание причины ошибки |
| pg_salt | Случайная строка |
| pg_sig | Подпись |
Ответ «ok» означает, что заявка на отмену счёта принята. Счёт всё же может быть оплачен, если ПС, в которую был выставлен счёт, не поддерживает операции аннулирования счёта и не делает предварительных запросов на подтверждение возможности проведения платежа.
После оплаты
https://www.platron.ru/revoke.php?pg_salt=123&pg_merchant_id=456&pg_payment_id=1234567&pg_refund_amount=800&pg_sig=6dd2a9d237952f56bd05c602d2872af8
<?xml version="1.0" encoding="utf-8"?>
<request>
<pg_salt>123</pg_salt>
<pg_merchant_id>456</pg_merchant_id>
<pg_payment_id>1234567</pg_payment_id>
<pg_refund_amount>800</pg_refund_amount>
<pg_sig>6dd2a9d237952f56bd05c602d2872af8</pg_sig>
</request>
Магазин может отменить успешно завершившийся платеж, если платежная система это позволяет (например, Банковские карты). В этом случае деньги возвращаются покупателю. Вернуть можно как полную сумму платежа, так и часть суммы. Можно делать несколько частичных возвратов до тех пор, пока общая сумма возвратов не достигнет суммы первоначального платежа.
URL запроса
https://www.platron.ru/revoke.php
Параметры запроса
| Параметр | Описание |
|---|---|
| pg_merchant_id | Идентификатор магазина |
| pg_payment_id | Идентификатор платежа |
| pg_refund_amount | Сумма возврата. Если параметр не передан или передан 0, то возвращается вся сумма. |
| pg_items | Позиция чека для отправки в ОФД. Формат данных такой же, как в параметре pg_items в запросе на отправку чека в ОФД. |
| pg_salt | Случайная строка |
| pg_sig | Подпись |
Параметры запроса, которые больше не используются
| Параметр | Описание |
|---|---|
| pg_description | Описание. Если данный параметр не указан, то устанавливается значение по умолчанию: «from revoke.php» |
Параметры ответа
Пример ответа:
<?xml version="1.0" encoding="utf-8"?>
<response>
<pg_salt>9865</pg_salt>
<pg_status>ok</pg_status>
<pg_sig>48caf9d237952f56bd05c602d28762da</pg_sig>
</response>
В случае ошибки:
<?xml version="1.0" encoding="utf-8"?>
<response>
<pg_salt>9865</pg_salt>
<pg_status>error</pg_status>
<pg_error_code>490</pg_error_code>
<pg_error_description>this transaction can’t be revoked</pg_error_description>
<pg_sig>4df0f9d237952f56bd05c602d2873ed0</pg_sig>
</response>
| Параметр | Описание |
|---|---|
| pg_status | Результат обработки запроса. ok если запрос принят на обработку. По результату будет вызван Refund URL магазина. error в любом другом случае. |
| pg_error_code | Код ошибки |
| pg_error_description | Описание причины ошибки |
| pg_salt | Случайная строка |
| pg_sig | Подпись |
Чеки (ФЗ-54)
Перед настройкой необходимо связаться с менеджером.
Создание чека
https://www.platron.ru/receipt.php?pg_merchant_id=123&pg_salt=your_salt&pg_sig=generated_sig&pg_operation_type=payment&pg_payment_id=payment_id&pg_customer_name=customer_name&pg_customer_inn=12345678901&pg_items[0][pg_label]=item1&pg_items[0][pg_price]=1.1&pg_items[0][pg_quantity]=2&pg_items[0][pg_vat]=20&pg_items[0][pg_type]=product&pg_items[0][pg_payment_type]=full_payment&pg_items[0][pg_agent_type]=agent&pg_items[0][pg_agent_name]=name&pg_items[0][pg_agent_inn]=12345678902&pg_items[0][pg_agent_phone]=79999999999
<?xml version="1.0" encoding="utf-8"?>
<request>
<pg_merchant_id>123</pg_merchant_id>
<pg_salt>your_salt</pg_salt>
<pg_sig>generated_sig</pg_sig>
<pg_operation_type>payment</pg_operation_type>
<pg_payment_id>payment_id</pg_payment_id>
<pg_customer_name>customer_name</pg_customer_name>
<pg_customer_inn>12345678901</pg_customer_inn>
<pg_items>
<pg_label>item1</pg_label>
<pg_price>1.1</pg_price>
<pg_quantity>2</pg_quantity>
<pg_vat>20</pg_vat>
<pg_type>product</pg_type>
<pg_payment_type>full_payment</pg_payment_type>
<pg_agent_type>agent</pg_agent_type>
<pg_agent_name>name</pg_agent_name>
<pg_agent_inn>12345678902</pg_agent_inn>
<pg_agent_phone>79999999999</pg_agent_phone>
</pg_items>
</request>
Формировать данные для чека необходимо сразу после создания операции. Чек в ОФД и покупателю отправится только после успешного завершения операции.
Для возможности тестирования функционала необходимо связаться с курирующим менеджером.
Если оплата производится в иностранной валюте или используется платежная система, которая взимает дополнительную комиссию сверх суммы платежа, чек должен быть выписан после получения уведомления на Result Url об успешном платеже.
URL запроса
https://www.platron.ru/receipt.php
Параметры запроса
| Параметр | Описание |
|---|---|
| pg_merchant_id | Идентификатор магазина |
| pg_operation_type | Тип операции (enum) payment — оплата, refund – возврат |
| pg_payment_id* | Номер платежной транзакции (int) |
| pg_order_id* | Номер заказа магазина |
| pg_salt | Случайная строка |
| pg_sig | Подпись |
| pg_items | Массив позиций в чеке. См. таблицу ниже |
| pg_customer_name | Имя покупателя (string). Заполняется вместе с pg_customer_inn. Обязательны только для определенных мерчантов. |
| pg_customer_inn | ИНН покупателя |
*Требуется либо pg_payment_id, либо pg_order_id. В случае, если pg_order_id не уникальный, то чек будет создан к последнему заказу.
Параметры запроса, которые больше не используются
| Параметр | Описание |
|---|---|
| pg_additional_payment_type | Дополнительная оплата. Возможные значения: prepayment credit |
| pg_additional_payment_amount | Сумма дополнительной оплаты. Параметр обязателен в случае, если передается параметр pg_additional_payment_type |
Параметры позиции в чеке:
| Параметр | Описание |
|---|---|
| pg_label | Наименование товара (string) Максимальная длина составляет 128 символов |
| pg_nomenclature_code | Маркировка товара по формату (string) |
| pg_price | Цена товара с учетом всех скидок и наценок (float, 2 знака после запятой) |
| pg_quantity | Количество (float) |
| pg_vat | Ставка НДС. Возможные значения см. ниже. По умолчанию используется значение none |
| pg_type | Тип услуги/товара. Возможные значения см. ниже. По умолчанию используется значение product |
| pg_payment_type | Способ расчета. Возможные значения см. ниже. По умолчанию используется значение full_payment |
| pg_agent_type | Тип платежного агента. Возможные значения см. ниже. |
| pg_agent_phone | Телефон поставщика (только цифры) |
| pg_agent_name | Имя поставщика |
| pg_agent_inn | ИНН поставщика (только цифры) |
Если передан хотя бы один из параметров pg_agent, необходимо заполнение всех оставшихся полей.
Если у магазина нет необходимости передавать дополнительные параметры, никаких изменений вносить не нужно.
| Ставка НДС | |
|---|---|
| 0 | ставка НДС 0% |
| 5 | ставка НДС 5% |
| 7 | ставка НДС 7% |
| 10 | ставка НДС 10% |
| 22* | ставка НДС 22% |
| 105 | ставка НДС 5/105 |
| 107 | ставка НДС 7/107 |
| 110 | ставка НДС 10/110 |
| 122* | ставка НДС 22/122 |
| none | не облагается НДС |
* Новые ставки НДС будут доступны начиная с 01.01.2026.
| Тип услуги/товара | |
|---|---|
| product | товар, за исключением подакцизного товара |
| product_practical | подакцизный товар |
| work | работа |
| service | услуга |
| gambling_bet | прием ставок при осуществлении деятельности по проведению азартных игр |
| gambling_win | выплата денежных средств в виде выигрыша при осуществлении деятельности по проведению азартных игр |
| lottery_bet | прием денежных средств при реализации лотерейных билетов, электронных лотерейных билетов, приеме лотерейных ставок при осуществлении деятельности по проведению лотерей |
| lottery_win | о выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению лотерей |
| rid | предоставление прав на использование результатов интеллектуальной деятельности или средств индивидуализации «ПРЕДОСТАВЛЕНИЕ РИД» или «РИД» |
| payment | об авансе, задатке, предоплате, кредите, взносе в счет оплаты, пени, штрафе, вознаграждении бонусе и ином аналогичном предмете расчета |
| commission | вознаграждении пользователя, являющегося платежным агентом (субагентом), банковским платежным агентом (субагентом), комиссионером, поверенным или иным агентом |
| composite | о предмете расчета, состоящем из предметов, каждому из которых может быть присвоено значение от «0» до «11» (0-11 — это вышеперечисленные) |
| other | о предмете расчета, не относящемуся к предметам расчета, которым может быть присвоено значение от «0» до «12» (0-12 — это вышеперечисленные) |
| Способ расчета | |
|---|---|
| pre_payment_full | полная предварительная оплата до момента передачи предмета расчета «ПРЕДОПЛАТА 100 %» |
| pre_payment_part | частичная предварительная оплата до момента передачи предмета расчета — «ПРЕДОПЛАТА» |
| full_payment | полная оплата, в том числе с учетом аванса (предварительной оплаты) в момент передачи предмета расчета — «ПОЛНЫЙ РАСЧЕТ» |
| advance | аванс |
| credit_part | частичная оплата предмета расчета в момент его передачи с последующей оплатой в кредит — «ЧАСТИЧНЫЙ РАСЧЕТ И КРЕДИТ» |
| credit_pay | оплата предмета расчета после его передачи с оплатой в кредит (оплата кредита) — «ОПЛАТА КРЕДИТА» |
| credit | передача предмета расчета без его оплаты в момент его передачи с последующей оплатой в кредит — «ПЕРЕДАЧА В КРЕДИТ» |
| Тип платежного агента | |
|---|---|
| commissionaire | осуществление расчета с покупателем (клиентом) пользователем, являющимся комиссионером |
| bank_payment_agent | оказание услуг покупателю (клиенту) пользователем, являющимся банковским платежным агентом |
| bank_payment_subagent | оказание услуг покупателю (клиенту) пользователем, являющимся банковским платежным субагентом |
| payment_agent | оказание услуг покупателю (клиенту) пользователем, являющимся платежным агентом |
| payment_subagent | оказание услуг покупателю (клиенту) пользователем, являющимся платежным субагентом |
| solicitor | осуществление расчета с покупателем (клиентом) пользователем, являющимся поверенным |
| agent | осуществление расчета с покупателем (клиентом) пользователем, являющимся агентом и не являющимся банковским платежным агентом (субагентом), платежным агентом (субагентом), поверенным, комиссионером |
Параметры ответа
Ответ на запрос представляет собой XML следующего вида в случае успешного выполнения запроса:
<?xml version="1.0" encoding="utf-8"?>
<response>
<pg_status>ok</pg_status>
<pg_receipt_id>135</pg_receipt_id>
<pg_salt>salt</pg_salt>
<pg_sig>60beff140b3c9c6dt87603522cc1c07f</pg_sig>
</response>
В случае ошибки:
<?xml version="1.0" encoding="utf-8"?>
<response>
<pg_salt>9865</pg_salt>
<pg_status>error</pg_status>
<pg_error_code>100</pg_error_code>
<pg_error_description>Incorrect signature</pg_error_description>
<pg_sig>4df0f9d237952f56bd05c602d2873ed0</pg_sig>
</response>
| Параметр | Описание |
|---|---|
| pg_receipt_id | Номер созданного чека |
| pg_status | Результат обработки запроса |
| pg_error_code | Код ошибки |
| pg_error_description | Описание причины ошибки |
| pg_salt | Случайная строка |
| pg_sig | Подпись |
Статус чека в ОФД
https://www.platron.ru/get_receipt_status.php?pg_merchant_id=82&pg_receipt_id=10000&pg_salt=aaaaaaaaaa&pg_sig=b2c010162d43d2ba98a7f68caee24761
<?xml version="1.0" encoding="utf-8"?>
<request>
<pg_merchant_id>82</pg_merchant_id>
<pg_receipt_id>10000</pg_receipt_id>
<pg_salt>aaaaaaaaaa</pg_salt>
<pg_sig>b2c010162d43d2ba98a7f68caee24761</pg_sig>
</request>
URL запроса
https://www.platron.ru/get_receipt_status.php
Параметры запроса
| Параметр | Описание |
|---|---|
| pg_merchant_id | Идентификатор магазина (int) |
| pg_receipt_id | Идентификатор чека полученный в ответе запроса на создание чека |
| pg_salt | Случайная строка |
| pg_sig | Подпись |
Параметры ответа
Ответ на запрос представляет собой XML следующего вида в случае успешного выполнения запроса:
<?xml version="1.0" encoding="utf-8"?>
<response>
<pg_status>ok</pg_status>
<pg_receipt_status>ok</pg_receipt_status>
<pg_fiscal_receipt_number>6</pg_fiscal_receipt_number>
<pg_shift_number>23</pg_shift_number>
<pg_receipt_date>2017-04-12 20:16:00</pg_receipt_date>
<pg_fn_number>1110000100238211</pg_fn_number>
<pg_ecr_registration_number>0000111118041361</pg_ecr_registration_number>
<pg_fiscal_document_number>133</pg_fiscal_document_number>
<pg_fiscal_document_attribute>3449555941</pg_fiscal_document_attribute>
<pg_salt>aaaaaa</pg_salt>
<pg_sig>531b7999c74d984fa8c9e1ff029a40d7</pg_sig>
</response>
В случае, если информации по чеку ещё нет:
<?xml version="1.0" encoding="utf-8"?>
<response>
<pg_salt>9865</pg_salt>
<pg_status>ok</pg_status>
<pg_receipt_status>pending</pg_receipt_status>
<pg_sig>75ed486aa0dfd5363e2e5a87e8e30634</pg_sig>
</response>
В случае ошибки:
<?xml version="1.0" encoding="utf-8"?>
<response>
<pg_salt>9865</pg_salt>
<pg_status>error</pg_status>
<pg_error_code>100</pg_error_code>
<pg_error_description>Incorrect signature</pg_error_description>
<pg_sig>4df0f9d237952f56bd05c602d2873ed0</pg_sig>
</response>
| Параметр | Описание |
|---|---|
| pg_status | Результат обработки запроса. |
| pg_error_code | Код ошибки |
| pg_error_description | Описание причины ошибки |
| pg_salt | Случайная строка |
| pg_sig | Подпись |
| pg_receipt_status | Статус чека (ok или pending) |
| pg_fiscal_receipt_number | Номер чека в смене. |
| pg_shift_number | Номер смены. |
| pg_receipt_date | Дата и время документа из ФН. |
| pg_fn_number | Номер ФН. |
| pg_ecr_registration_number | Регистрационный номер ККТ. |
| pg_fiscal_document_number | Фискальный номер документа. |
| pg_fiscal_document_attribute | Фискальный признак документа. |
Реестр Операций
Отправка на email
В параметрах магазина есть возможность задать e-mail, на который каждый день будет высылаться реестр платежей по предыдущему дню. Реестр формируется в 0:10 по московскому времени.
Заголовки письма содержат следующую информацию:
- X-Merchant-ID: Merchant ID, выданный магазину (пример: 14)
- X-Registry-Date: Дата, на которую составлен реестр, в формате ГГГГ-ММ-ДД (пример: 2009-12-02)
- Поле «От» письма содержит info@platron.ru
- Тема письма: Platron report for merchant #id [ГГГГ-ММ-ДД]
В целях обеспечения безопасности магазину рекомендуется проверять заголовки письма, чтобы убедиться в подлинности полученного реестра.
Реестр высылается в теле письма или во вложении, в зависимости от настроек в личном кабинете, представляет собой набор данных с разделителями «табуляция». Первая строка содержит названия полей. Если поле не определено, две табуляции следуют подряд.
Реестр высылается, даже если за прошедший день не было ни одной транзакции. В этом случае в теле письма присутствует только строка заголовка.
Описание полей реестра
| Код поля | Название поля | Описание |
|---|---|---|
| order_id | Номер заказа | Номер, переданный магазином как номер заказа |
| pg_payment_id | Номер операции | BILLNUMBER, номер платежа, сформированный Platron-ом. |
| op_date | Дата операции | |
| op_time | Время операции | |
| type | Тип операции | Трехбуквенный код операции: “pay" – операция оплаты счета, “ref" – возврат средств(через ту же платежную систему, через которую прошла транзакция) “rev" – reversal “mb" – возврат средств(через платежную систему отличающуюся от платежной системы транзакции) “rev_mb" – отмена возврата “par" – возврат при частичном клиринге |
| payment_system | Наименование платёжной системы | Наименование платёжной системы (из Справочника платёжных систем и групп). |
| payment_type | Тип платежа (direct или transit) | Тип контракта с Платёжной системой: direct – прямой контракт между магазином и ПС, transit – контракт между Platron и ПС |
| bill_amount | Сумма выставленного счета | Сумма счета, первоначально выставленного мерчантом, в валюте, в которой он первоначально выставлен |
| bill_cur_symbol | Валюта, в которой выставлен счет | Код валюты в международном стандарте (RUB, EUR, USD) |
| amount | Сумма | Сумма, уплаченная плательщиком в пользу магазина |
| pg_commission | Комиссионное вознаграждение Агента | Комиссионное вознаграждение Platron за операцию. |
| ps_commission | Комиссионное вознаграждение Платёжной системы | Комиссионное вознаграждение платёжной системы за операцию (отсутствует, если type="transit") |
| to_pay | К перечислению | Разница между суммой операции и комиссионным вознаграждением. |
| currency | Валюта | Код валюты в международном стандарте (RUB, EUR, USD) |
| description | Описание | Описание заказа, переданного при запросе на создание транзакции |
Пример реестра
| order_id | pg_payment_id | op_date | op_time | type | payment_system | payment_type | bill_amount | bill_cur_symbol | amount | pg_commission | ps_commission | to_pay | currency | description |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 289 | 79004 | 02.12.09 | 13:32:56 | pay | WEBMONEYE | direct | 0.13 | EUR | 0.1300 | 0.0003 | 0.0000 | 0.13 | EUR | Заказ №4077 |
| 291 | 79212 | 02.12.09 | 19:39:41 | pay | TEST | transit | 10 | RUB | 10.0000 | 0.0000 | 10.00 | RUB | Оплата за трансфер | |
| 293 | 79216 | 02.12.09 | 19:42:10 | pay | TEST | transit | 0.30 | USD | 10.0000 | 0.0000 | 10.00 | RUB | Комиссия агента | |
| 76392 | 78930 | 02.12.09 | 00:08:22 | pay | RAIFFEISEN | direct | 35.87 | USD | 1076.1400 | 2.5951 | 35.5100 | 1073.54 | RUB | Доплата за товар Б75540 |
| 76394 | 78932 | 02.12.09 | 00:15:02 | pay | RAIFFEISEN | direct | 994.26 | RUB | 994.2600 | 2.3976 | 32.8100 | 991.86 | RUB | Доставка |
Запрос реестра
https://www.platron.ru/get_registry.php?pg_merchant_id=1234&pg_date=2016-11-15&pg_salt=f387f3h3&pg_sig=bfc5f9d2379d287052f56bd05c60296e
URL запроса
https://www.platron.ru/get_registry.php
Параметры запроса
| Параметр | Описание |
|---|---|
| pg_merchant_id | Идентификатор магазина |
| pg_date | Дата, за которую вы получите операции. Формат yyyy-mm-dd |
| pg_salt | Случайная строка |
| pg_sig | Подпись |
Вы не можете совершить еще один запрос, пока не отработал первый запрос. В этом случае вы получите ошибку.
Параметры ответа
В случае успеха будет возвращен такой ответ:
<?xml version="1.0" encoding="utf-8"?>
<response>
<pg_status>ok</pg_status>
<operation>
<type>pay</type>
<payment_type>direct</payment_type>
<pg_payment_id>28236796</pg_payment_id>
<order_id>9789932</order_id>
<description>hotel reservetion description</description>
<merchant_id>82</merchant_id>
<payment_system>GDSHOTELWITHRUSSIANSTANDARD</payment_system>
<bill_amount>5138.0000</bill_amount>
<amount>0.0000</amount>
<currency>RUB</currency>
<bill_cur_symbol>RUB</bill_cur_symbol>
<op_date>15.11.2016</op_date>
<op_time>10:26:45</op_time>
<to_pay>0.0000</to_pay>
<pg_commission>0.0000</pg_commission>
<ps_commission>0.0000</ps_commission>
</operation>
<pg_salt>f387f3h3</pg_salt>
<pg_sig>cac84530938b7e51b2d272e1d0212457</pg_sig>
</response>
В случае ошибки ответ будет выглядеть следующим образом:
<?xml version="1.0" encoding="utf-8"?>
<response>
<pg_status>error</pg_status>
<pg_error_code>200</pg_error_code>
<pg_description>Отсутствует необходимый параметр</pg_description>
</response>
См. описание полей файла отправленного на email
Оповещения
Результат платежа
Пример GET вызова магазина гейтом, при оплате по обычной платежной системой:
http://store.ru/result.php?pg_salt=0bd68e&pg_order_id=654&pg_payment_id=765432&pg_amount=100.0000&pg_currency=RUB&pg_net_amount=100.00&pg_ps_amount=105.00&pg_ps_full_amount=105.00&pg_ps_currency=RUB&pg_payment_system=INPLATMTS&pg_result=1&pg_payment_date=2008-12-30+23:59:30&pg_can_reject=0&pg_user_phone=79818244116&pg_need_phone_notification=1&pg_user_contact_email=test@test.ru&pg_need_email_notification=1&uservar1=45363456&pg_sig=da61f9d237952f56bd05c602d28780b3
Пример xml вызова (POST с XML в параметре pg_xml) магазина гейтом, при оплате по обычной платежной системой:
<?xml version="1.0" encoding="utf-8"?>
<request>
<pg_salt>0bd68e</pg_salt>
<pg_order_id>654</pg_order_id>
<pg_payment_id>765432</pg_payment_id>
<pg_amount>100.0000</pg_amount>
<pg_currency>RUB</pg_currency>
<pg_net_amount>100.00</pg_net_amount>
<pg_ps_amount>105.00</pg_ps_amount>
<pg_ps_full_amount>105.00</pg_ps_full_amount>
<pg_ps_currency>RUB</pg_ps_currency>
<pg_payment_system>INPLATMTS</pg_payment_system>
<pg_result>1</pg_result>
<pg_payment_date>2008-12-30 23:59:30</pg_payment_date>
<pg_can_reject>0</pg_can_reject>
<pg_user_phone>79818244116</pg_user_phone>
<pg_need_phone_notification>1</pg_need_phone_notification>
<pg_user_contact_email>test@test.ru</pg_user_contact_email>
<pg_need_email_notification>1</pg_need_email_notification>
<uservar1>45363456</uservar1>
<pg_sig>da61f9d237952f56bd05c602d28780b3</pg_sig>
</request>
Пример GET вызова магазина гейтом, при оплате по карточной платежной системе:
http://store.ru/result.php?pg_salt=0bd68e&pg_order_id=654&pg_payment_id=765432&pg_amount=100.0000&pg_currency=RUB&pg_net_amount=100.00&pg_ps_amount=105.00&pg_ps_full_amount=105.00&pg_ps_currency=RUB&pg_payment_system=RUSSIANSTANDARD&pg_result=1&pg_payment_date=2008-12-30+23:59:30&pg_can_reject=1&pg_card_brand=CA&pg_card_pan=527594******4984&pg_card_hash=022380c107141f7e11f4271d7f6412a715222c32&pg_auth_code=014318&pg_captured=0&pg_user_phone=79818244116&pg_need_phone_notification=1&pg_user_contact_email=test@test.ru&pg_need_email_notification=1&uservar1=45363456&pg_sig=da61f9d237952f56bd05c602d28780b3
Пример xml вызова (POST с XML в параметре pg_xml) магазина гейтом, при оплате по карточной платежной системе:
<?xml version="1.0" encoding="utf-8"?>
<request>
<pg_salt>0bd68e</pg_salt>
<pg_order_id>654</pg_order_id>
<pg_payment_id>765432</pg_payment_id>
<pg_amount>100.0000</pg_amount>
<pg_currency>RUB</pg_currency>
<pg_net_amount>100.00</pg_net_amount>
<pg_ps_amount>105.00</pg_ps_amount>
<pg_ps_full_amount>105.00</pg_ps_full_amount>
<pg_ps_currency>RUB</pg_ps_currency>
<pg_payment_system>RUSSIANSTANDARD</pg_payment_system>
<pg_result>1</pg_result>
<pg_payment_date>2008-12-30 23:59:30</pg_payment_date>
<pg_can_reject>1</pg_can_reject>
<pg_card_brand>CA</pg_card_brand>
<pg_card_pan>527594******4984</pg_card_pan>
<pg_card_hash>022380c107141f7e11f4271d7f6412a715222c32</pg_card_hash>
<pg_auth_code>014318</pg_auth_code>
<pg_captured>0</pg_captured>
<pg_user_phone>79818244116</pg_user_phone>
<pg_need_phone_notification>1</pg_need_phone_notification>
<pg_user_contact_email>test@test.ru</pg_user_contact_email>
<pg_need_email_notification>1</pg_need_email_notification>
<uservar1>45363456</uservar1>
<pg_sig>da61f9d237952f56bd05c602d28780b3</pg_sig>
</request>
В случае если магазин принимает платеж, он должен ответить в виде XML со статусом ok:
<?xml version="1.0" encoding="utf-8"?>
<response>
<pg_salt>kdjdope983</pg_salt>
<pg_status>ok</pg_status>
<pg_description>Товар передан покупателю</pg_description>
<pg_sig>9bfc5f602d287096ed237952f56bd05c</pg_sig>
</response>
После приема денег от клиента или при невозможности совершить платеж Platron вызывает Result URL магазина и передает на него методом Request Method информацию о результате платежа. При получении данного запроса магазин должен произвести необходимые действия для передачи товара или услуги покупателю, в случае если платеж был успешным.
Если сервер продавца недоступен в момент вызова Result URL (нет ответа более 30 секунд) или его ответ не удалось интерпретировать, Platron будет предпринимать повторные попытки его вызвать в течение 2 часов, даже если время жизни счета pg_lifetime истечет. Магазин должен быть готов к тому, что Result URL будет вызван повторно для одного и того же платежа. Ответы на повторные вызовы должны совпадать с первоначальным ответом, даже если время жизни транзакции ( pg_lifetime) истекло.
Параметры запроса
| Параметр | Описание |
|---|---|
| pg_order_id | Идентификатор платежа в системе продавца |
| pg_payment_id | Внутренний идентификатор платежа в системе Platron |
| pg_amount | Сумма выставленного счета (в валюте pg_currency), совпадает с pg_amount в момент инициации платежа |
| pg_currency | Валюта выставленного счета, совпадает с pg_currency в момент инициации платежа |
| pg_ps_amount | Сумма счета (в валюте pg_ps_currency), выставленного в ПС. |
| pg_net_amount | Совпадает с pg_ps_amount |
| pg_ps_full_amount | Совпадает с pg_ps_amount |
| pg_ps_currency | Валюта, в которой был произведен платеж в платежной системе. |
| pg_payment_system | Идентификатор платежной системы |
| pg_result | 1 – успех, 0 – неудача |
| pg_payment_date | Дата и время совершения платежа в формате YYYY-MM-DD HH:MM:SS |
| pg_can_reject | 1 – платеж можно откатить назад (например, Банковские карты), 0 – платеж безотзывный. По умолчанию, pg_can_reject=0. |
| pg_card_issuer | Название эмитента. Этот параметр передается только в случае успешной оплаты банковской картой. |
| pg_card_brand | Бренд карты: CA – MasterCard и их продукты, VI – Visa, AX – AmericanExpress. Этот параметр передается только в случае успешной оплаты банковской картой. |
| pg_card_pan | Маскированный номер карты (часть цифр номера карты скрыты). Этот параметр передается только в случае успешной оплаты банковской картой. |
| pg_card_hash | Хешированный номер карты (номер карты, зашифрованный необратимым алгоритмом шифрования). Этот параметр передается только в случае успешной оплаты банковской картой. |
| pg_is_3ds | 0 или 1. Передается только в случае успешной оплаты банковской картой и показывает проходила ли оплата с использованием 3-D Secure. |
| pg_auth_code | Код авторизации. Этот параметр передается только в случае успешной оплаты банковской картой. |
| pg_rrn | RRN. Этот параметр передается только в случае успешной оплаты банковской картой. |
| pg_captured | 0 или 1. Передается только в случае успешной оплаты банковской картой и показывает, был ли произведен клиринг в момент авторизации (что зависит только от настроек магазина). Если значение этого параметра равно 0, магазин должен в последующем дать команду на клиринг (см. раздел Клиринг) или дождаться когда Platron сделает это сам. |
| pg_user_phone | Телефон покупателя (указанный при инициализации платежа) |
| pg_user_contact_email | Email покупателя, если был введен. Посылается только если есть email |
| pg_failure_code | Код причины отказа (список кодов и их описание см. в разделе Справочнике причин отказа). Параметр присутствует только в случае неудачного платежа. |
| pg_failure_description | Описание причины неудачи платежа. Передается на языке транзакции. Данное описание сформулировано в понятных пользователю терминах и может быть сообщено ему любым доступным способом. Параметр присутствует только в случае неудачного платежа |
| pg_recurring_profile_id | Идентификатор профиля рекуррентных платежей |
| pg_recurring_profile_expiry_date | Дата, до которой рекуррентный профиль доступен к использованию |
| Параметры продавца | Все поля, переданные с веб-сайта продавца, не имеющие префикса «pg_» |
| pg_salt | Случайная строка |
| pg_sig | Подпись |
Параметры запроса, которые не передаются
| Параметр | Описание |
|---|---|
| pg_overpayment | Сумма переплаты в валюте платежной системы. Параметр передается только в случае, когда клиент оплатил больше, чем от него ожидалось, и переплата разрешена в настройках магазина. Если оплачено ровно столько, сколько ожидалось, этот параметр не передается. |
| pg_need_phone_notification | Необходимость оповещения клиента (если услуга подключена) по смс о статусе транзакции. 0 – не уведомлять. |
| pg_need_email_notification | Необходимость оповещения клиента (если услуга подключена) по email о статусе транзакции. 0 – не уведомлять. Посылается только если есть pg_user_contact_email |
Параметры ответа (мерчанта)
Если магазин отказывается от платежа, и в запросе был передан параметр pg_can_reject=1, магазин должен ответить в виде XML со статусом rejected:
<?xml version="1.0" encoding="utf-8"?>
<response>
<pg_salt>kdjdope983</pg_salt>
<pg_status>rejected</pg_status>
<pg_description>Бронь истекла</pg_description>
<pg_sig>a3fc5f602d287096ed237952f56bd5fa</pg_sig>
</response>
| Параметр | Описание |
|---|---|
| pg_status | ok – платеж принят rejected – отказ от платежа (если pg_can_reject=1 ) error – ошибка в интерпретации данных |
| pg_description | (string[1024]) – В случае принятия платежа – параметр не передается. В случае отказа от приема платежа, описание причины отказа для клиента. В случае ошибки – описание ошибки, может дублировать параметр pg_error_description. |
| pg_error_description | описание ошибки, в случае pg_status=error |
| pg_salt | Случайная строка |
| pg_sig | Подпись |
Статус rejected может быть возвращен магазином только в случае, когда во входящем запросе от гейта был указан параметр pg_can_reject=1, в противном случае, вне зависимости от ответа магазина, платеж будет считаться совершенным. Если магазин отказался от платежа (ответил rejected), покупатель перенаправляется на Failure URL, иначе – на Success URL.
Результат клиринга
Пример GET вызова магазина гейтом:
http://store.ru/onCapture.php?pg_salt=gw41b38vc&pg_order_id=2614&pg_payment_id=825941&pg_sig=afaef9d237932f57bd05c602d287df34&uservar1=45363456
Пример xml вызова (POST с XML в параметре pg_xml) магазина гейтом:
<?xml version="1.0" encoding="utf-8"?>
<request>
<pg_salt>gw41b38vc</pg_salt>
<pg_order_id>2614</pg_order_id>
<pg_payment_id>825941</pg_payment_id>
<uservar1>45363456</uservar1>
<pg_sig>afaef9d237932f57bd05c602d287df34</pg_sig>
</request>
Если магазин настроен на проведение транзакций по банковским картам в две стадии – авторизация и клиринг, — Platron оповещает магазин об исполнении клиринга сразу после отправки соответствующей команды в банк.
Обычно клиринг выполняется по инициативе магазина, когда магазин дает Platron команду на клиринг (см. раздел Клиринг), однако если магазин не дал эту команду в течение срока, указанного в настройках магазина (не более 5 дней), после авторизации, Platron самостоятельно отправляет команду на клиринг в банк.
Для оповещения магазина о клиринге Platron вызывает скрипт магазина Capture URL с помощью метода Request Method. Platron передает информацию о номере заказа и ожидает ответ в течение 30 секунд. Если сервер продавца недоступен в момент вызова Capture URL (нет ответа более 30 секунд) или его ответ не удалось интерпретировать, Platron будет предпринимать повторные попытки его вызвать в течение 2 часов.
Параметры запроса
| Параметр | Описание |
|---|---|
| pg_order_id | Идентификатор платежа в системе продавца |
| pg_payment_id | Внутренний идентификатор платежа в системе Platron |
| Параметры продавца | Все поля, переданные с веб-сайта продавца, не имеющие префикса «pg_» |
| pg_salt | Случайная строка |
| pg_sig | подпись |
Параметры ответа (мерчанта)
Пример ответа магазина:
<?xml version="1.0" encoding="utf-8"?>
<response>
<pg_salt>eyhfh42za22h</pg_salt>
<pg_status>ok</pg_status>
<pg_sig>ea362f52d23770986bd05c6fc5f9427d</pg_sig>
</response>
| Параметр | Описание |
|---|---|
| pg_status | ok – информация принята error – ошибка в интерпретации данных |
| pg_error_description | Описание ошибки, в случае pg_status=error |
| pg_salt | Случайная строка |
| pg_sig | Подпись |
Возврат платежа
В случае полного или частичного возврата платежа на стороне Platron или платежной системы платежный гейт вызывает скрипт магазина Refund URL с помощью метода Request Method. Запрос будет производиться в кодировке, установленной магазином при инициализации платежа, по умолчанию utf-8. Гейт передает информацию о номере и свойствах заказа и ожидает ответ в течение 30 секунд. Если сервер продавца недоступен в момент вызова Refund URL (нет ответа более 30 секунд) или его ответ не удалось интерпретировать, Platron будет предпринимать повторные попытки его вызвать в течение 2 часов.
Параметры запроса
| Параметр | Описание |
|---|---|
| pg_order_id | Идентификатор платежа в системе продавца |
| pg_payment_id | Внутренний идентификатор платежа в системе Platron |
| pg_amount | Сумма выставленного счета (в валюте pg_currency), совпадает с pg_amount в момент инициации платежа |
| pg_currency | Валюта выставленного счета, совпадает с pg_currency в момент инициации платежа |
| pg_net_amount | Сумма (в валюте pg_ps_currency), которая будет списана с магазина |
| pg_ps_full_amount | Полная сумма (в валюте pg_ps_currency), которая будет возвращена покупателю |
| pg_ps_currency | Валюта, в которой будет произведен возврат платежа в платежной системе |
| pg_payment_system | Идентификатор платежной системы |
| pg_refund_date | Дата и время совершения отмены платежа в формате YYYY-MM-DD HH:MM:SS |
| pg_refund_type | Тип возврата: reversal – полный возврат до клиринга (для банковских карт) refund – полный или частичный возврат. Различать reversal и refund имеет смысл только для банковских карт. Reversal может произойти только до клиринга, refund только после клиринга. |
| pg_refund_system | Совпадает с pg_payment_system |
| pg_refund_id | Уникальный идентификатор возврата для фильтрации повторных оповещений об одном и том же возврате. В случае reversal передается пустое значение. |
| Параметры продавца | Все поля, переданные с веб-сайта продавца, не имеющие префикса «pg_» |
| pg_salt | Случайная строка |
| pg_sig | подпись |
Параметры ответа (мерчанта)
| Параметр | Описание |
|---|---|
| pg_status | ok – информация принята, error – ошибка в интерпретации данных |
| pg_error_description | описание ошибки, в случае pg_status=error |
| pg_salt | Случайная строка |
| pg_sig | подпись |
Возврат покупателя на сайт продавца
Пример 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, в зависимости от результата платежа. Перенаправление происходит методом Success URL Method или Failure URL Method, указанным при инициации платежа.
Параметры запроса
| Параметр | Описание |
|---|---|
| pg_order_id | Идентификатор платежа в системе продавца |
| pg_payment_id | Внутренний идентификатор платежа в системе platron.ru |
| pg_card_issuer | Название эмитента. Этот параметр передается только в случае успешной оплаты банковской картой. |
| pg_card_brand | Бренд карты: CA – MasterCard и их продукты, VI – Visa, AX – AmericanExpress. Этот параметр передается только в случае успешной оплаты банковской картой. |
| pg_card_pan | Маскированный номер карты (часть цифр номера карты скрыты). Этот параметр передается только в случае успешной оплаты банковской картой. |
| pg_card_hash | Хешированный номер карты (номер карты, зашифрованный необратимым алгоритмом шифрования). Этот параметр передается только в случае успешной оплаты банковской картой. |
| pg_is_3ds | 0 или 1. Передается только в случае успешной оплаты банковской картой и показывает проходила ли оплата с использованием 3-D Secure. |
| pg_auth_code | Код авторизации. Этот параметр передается только в случае успешной оплаты банковской картой. |
| pg_rrn | RRN. Этот параметр передается только в случае успешной оплаты банковской картой. |
| pg_captured | 0 или 1. Передается только в случае успешной оплаты банковской картой и показывает, был ли произведен клиринг в момент авторизации (что зависит только от настроек магазина). Если значение этого параметра равно 0, магазин должен в последующем дать команду на клиринг (см. раздел Клиринг) или дождаться когда Platron сделает это сам. |
| pg_failure_code | Код причины отказа (список кодов и их описание см. в Справочнике причин отказа). Передается только на Failure URL. |
| pg_failure_description | Описание причины неудачи платежа. Передается на языке транзакции. Данное описание сформулировано в понятных пользователю терминах и может быть сообщено ему любым доступным способом. Передается только на Failure URL. |
| pg_recurring_profile_id | Идентификатор профиля рекуррентных платежей |
| pg_recurring_profile_expiry_date | Дата, до которой рекуррентный профиль доступен к использованию |
| Параметры продавца | Все поля, переданные с веб-сайта продавца, не имеющие префикса «pg_» |
| pg_salt | Случайная строка |
| pg_sig | подпись |
Параметры запроса, которые больше не передаются
| Параметр | Описание |
|---|---|
| pg_overpayment | Сумма переплаты в валюте платежной системы. Параметр передается только в случае когда клиент оплатил больше, чем от него ожидалось, и переплата разрешена в настройках магазина. Если оплачено ровно столько, сколько ожидалось, этот параметр не передается. |
Если 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 часов после оплаты, если первая попытка по любым причинам не удалась.
Тестирование
Все новые магазины первоначально находятся в тестовом режиме. После завершения тестирования и отправки магазином в Platron подписанного Акта о подключении, его можно скачать по ссылке https://www.platron.ru/admin/documents.php, администрация Platron переводит магазин в рабочий режим.
Для отладки интеграции с Platron в тестовом режиме необходимо выбирать pg_payment_system=TEST или pg_payment_system=TESTCARD, в этом случае будет использоваться фиктивная тестовая ПС, ведущая расчеты в фиктивной валюте «тестики», а реальные средства переводиться не будут. В тестовом режиме можно использовать только тестовые платежные системы, а в рабочем режиме, наоборот, оплата тестовыми платежными системами невозможна. Для тестирования интеграции платежной системы TESTCARD, необходимо использовать валюту — RUB.
После перехода магазина в рабочий режим можно создавать отдельные транзакции в тестовом режиме, передавая параметр pg_testing_mode в запросах на создание платежа, повторение рекуррентного платежа и на получение списка платежных систем. Значение pg_testing_mode=1 включает тестовый режим для одной конкретной транзакции. Если сам магазин находится в тестовом режиме, то значение переданного флага pg_testing_mode не имеет значения. Включение и выключение тестового режима в настройках магазина осуществляется только администрацией Platron.
При заполнении данных для оплаты можно указать следующие специальные номера телефона:
- 79009999999 — для автоматической удачной оплаты
- 79008888888 — для автоматической неудачной оплаты
Если указать любой другой номер телефона, то после создания транзакции никаких автоматических действий с ней не происходит. Для того чтобы протестировать дальнейшее прохождение транзакции, нужно зайти в административную панель на страницу транзакции и управлять ее действиями с помощью тестовых кнопок.
Для эмуляции перехода пользователя на страницу прохождения 3DS при использовании платежной системы TESTCARD, необходимо попросить включить авторизацию клиента по 3DS у вашего менеджера.
В тестовой платежной системе возможно тестирование клиринга, PCI DSS, длинной записи и рекуррентных платежей.
При оплате через тестовую карточную платежную систему требуется ввести номер карты. Можете использовать настоящую карту (списания не происходит), подобрать номер карты (по правилу луна), а так же использовать тестовые карты. Тестовые карты не валидирует модуль фрод мониторинга. Список тестовых карт:
- 5285 0000 0000 0005 действительна до 01/2035
- 4276 0000 0000 0009 действительна до 01/2035
- 5241 0000 0000 0016 действительна до 01/2035
- 5326 0000 0000 0006 действительна до 01/2035
- 4257 0000 0000 0002 действительна до 01/2035
Анти-фрод
Задача. Интегрироваться к системе Platron только для анти-фрод решения.
Решение. Интеграция производится стандартным способом. Для передачи карточных реквизитов, магазин должен иметь сертификат PCI DSS. Дополнительную документацию по интеграции с наличием PCI DSS можно запросить у менеджера.
- Для создания транзакции необходимо использовать метод инициализации платежа — Host-to-host
- При создании транзакции должна быть указана платежная система ANTIFRAUD (pg_payment_system=ANTIFRAUD).
- В ответ (см. Результат платежа или Статус платежа) будет отдаваться дополнительный параметр fraud_filter_action
Возможные варианты ответа:
| fraud_filter_action | Описание |
|---|---|
| pass | Транзакция не считается мошеннической. |
| pass_and_warn | Магазину следует обратить внимание на заказ. Возможен подозрительный набор товаров в заказе |
| mpi3ds_or_block | При возможности провести транзакцию по терминалу с 3DS верификацией. Если по умолчанию используется терминал с 3DS, транзакция считается безопасной. |
| block | Необходимо заблокировать транзакцию |
| manual_check_or_block | Необходимо запросить у покупателя фотографию платежной карты. Если карта не предоставлена, заблокировать транзакцию. |
Обязательные параметры, помимо параметров из раздела Инициализация платежа, необходимые для корректной работы антифрода:
| Параметр | Описание |
|---|---|
| pg_user_phone | Номер телефона покупателя |
| pg_user_ip | IP-адрес покупателя |
| pg_card_number | Номер карты |
| pg_user_cardholder | Имя держателя карты, от 3 до 27 латинских букв (в зависимости от типа карты) |
| pg_exp_year | Год истечения срока действия карты, 4 цифры. |
| pg_exp_month | Месяц истечения срока действия карты, 2 цифры. |
| pg_cvv2 | Код CVV2/CVC2, 3 или 4 цифры. Может передаваться любое значение. |
| pg_user_contact_email | Адрес электронной почты |
Для магазинов сегмента e-travel, в дополнительных полях могут передаваться следующие данные:
| Параметр | Описание |
|---|---|
| airports (array) | Аэропорты вылета/прилета |
| airlines (array) | Авиакомпания, совершающая рейс |
| departure_time (YYYY-MM-DD HH:MM:SS) | Дата и время вылета |
| document_attributes_passengers (серия+номер+пробел+страна +пробел+тип документа, пример 77АУ666717 RU russian internal passport, IVAN IVANOV 16.03.1990 lastname firstname date of birth) * | Документы пассажиров. russian internal passport – внутренний паспорт РФ russian international passport – заграничный паспорт РФ foreign passport – иностранный паспорт birth certificate – свидетельство о рождении temporary certificate – временное свидетельство lastname firstname date of birth – фамилия и имя пассажира + дата рождения |
| passenger_names (имя + пробел + фамилия, только латинские буквы, пробел и тире) | Имена и фамилии пассажиров |
| point_countries (array) | Страна вылета и назначения. Для обозначения страны используется ISO Alpha 2 3166-1. |
Справочники
Платежные системы
Боевые платежные системы
| Идентификатор (pg_payment_system) | Валюта | Категория (pg_category) | Описание |
|---|---|---|---|
| BANKCARD | RUB | bankcard | Банковская карта |
| RUSSIANSTANDARD | RUB | bankcard | Банковские карты через процессинг банка Русский Стандарт |
| TINKOFFBANKCARD | RUB | bankcard | Банковские карты через процессинг Тиньков банка |
| YANDEXMONEY | RUB | wallet | ЭПС Юмани |
| YANDEXPAY | RUB | yandexpay | ЭПС Яндекс Пэй |
| SBP | RUB | sbp | Система быстрых платежей (СБП) |
| MIRPAY | RUB | mirpay | Mir Pay |
| SBERPAY | RUB | sberpay | SberPay |
| TPAY | RUB | tpay | T-Pay |
Тестовые платежные системы
| Идентификатор (pg_payment_system) | Валюта | Категория (pg_category) | Описание |
|---|---|---|---|
| TEST | тестик | wallet | Тестовая платежная система |
| TESTCARD | тестик | bankcard | Тестовая платежная система по картам |
| TESTELIXIRSBP | тестик | sbp | Тестовая платежная система для СБП |
Банковские карты
| Идентификатор (pg_payment_system) | Проверка возможности совершить платеж (вызывается ли Check URL) | Поддержка времени жизни счета платежной системой (pg_lifetime) | Возможность отзыва платежа (может ли быть pg_can_reject=1) | Возможность отмены счета до оплаты | Возможно использование рекуррентных платежей | Способ возврата |
|---|---|---|---|---|---|---|
| BANKCARD | нет | нет | Уточняйте у менеджера | на стороне Platron, reversal после оплаты | Уточняйте у менеджера | Уточняйте у менеджера |
| RUSSIANSTANDARD | нет | нет | да | на стороне Platron, reversal после оплаты | да | online, на карту |
| TINKOFFBANKCARD | нет | нет | да | на стороне Platron, reversal после оплаты | да | online, на карту |
| SBP | да | да | да | на стороне Platron, refund после оплаты | нет | online |
| SBERPAY | нет | да | да | на стороне Platron, refund после оплаты | нет | online |
| MIRPAY | нет | нет | да | на стороне Platron, reversal после оплаты | нет | online |
| YANDEXMONEY | да | нет | да | на стороне Platron, refund после оплаты | нет | online, на кошелек |
Тестовые платежные системы
| Идентификатор (pg_payment_system) | Название | Базовая валюта | Место комиссии ПС |
|---|---|---|---|
| TEST | Тестовая платежная система с переводами в виртуальной валюте, используется для отладки прохождения платежей | тестик | внутри |
| TESTCARD | Тестовая платежная система с переводами в виртуальной валюте, используется для отладки прохождения платежей по картам | тестик | внутри |
| TESTELIXIRSBP | Тестовая платежная система с переводами в виртуальной валюте, используется для отладки прохождения платежей по СБП | тестик | внутри |
Валюты
В настоящий момент поддерживаются все валюты, которые имеют официальный обменный курс ЦБ РФ.
| Идентификатор (pg_currency) | Название |
|---|---|
| AUD | Австралийский доллар |
| AZN | Азербайджанский манат |
| AMD | Армянский драм |
| BYN | Белорусский рубль |
| BGN | Болгарский лев |
| BRL | Бразильский реал |
| HUF | Венгерский форинт |
| KRW | Вон Республики Корея |
| HKD | Гонконгский доллар |
| DKK | Датская крона |
| USD | Доллар США |
| EUR | Евро |
| INR | Индийский рупий |
| KZT | Казахстанский тенге |
| CAD | Канадский доллар |
| KGS | Киргизский сом |
| CNY | Китайский юань |
| MDL | Молдавский лей |
| TMT | Новый туркменский манат |
| NOK | Норвежская крона |
| PLN | Польский злотый |
| RON | Румынский лей |
| XDR | СДР (специальные права заимствования) |
| SGD | Сингапурский доллар |
| TJS | Таджикский сомони |
| TRY | Турецкая лира |
| UZS | Узбекский сум |
| UAH | Украинская гривна |
| GBP | Фунт стерлингов Соединенного королевства |
| CZK | Чешская крона |
| SEK | Шведская крона |
| CHF | Швейцарский франк |
| ZAR | Южноафриканский рэнд |
| JPY | Японская иена |
Статусы платежа
Каждая платежная транзакция может находиться в одном из следующих состояний:
| Статус (pg_transaction_status) | Описание |
|---|---|
| partial | Платежная транзакция еще не до конца создана, например, не определена платежная система. Из этого состояния платеж может перейти только в состояние pending. |
| pending | Платежная транзакция создана и ждет оплаты. Из этого состояния платеж может перейти только в состояния ok или failed. |
| ok | Платеж завершился успешно. Из этого состояния платеж может перейти только в состояние revoked |
| failed | Платеж не прошел. Это окончательный статус. |
| revoked | Платеж прошел успешно, но затем был отозван. Это окончательный статус. |
Коды ошибок
| Код ошибки | Описание ошибки |
|---|---|
| 100 | Некорректная подпись запроса * |
| 101 | Неверный номер магазина |
| 110 | Отсутствует или не действует контракт с магазином |
| 120 | Запрошенное действие отключено в настройках магазина |
| 200 | Не хватает или некорректный параметр запроса |
| 340 | Транзакция не найдена |
| 350 | Транзакция заблокирована |
| 360 | Транзакция просрочена |
| 365 | Срок жизни рекуррентного профиля истек |
| 373 | Операция недоступна для текущего статуса транзакции |
| 400 | Платеж отменен покупателем или платежной системой |
| 420 | Платеж отменен по причине превышения лимита |
| 465 | Ошибка связи с платежной системой |
| 466 | Истек SSL сертификат |
| 470 | Ошибка на стороне платежной системы |
| 475 | Общий сбой платежной системы |
| 490 | Отмена платежа невозможна |
| 600 | Общая ошибка |
| 700 | Ошибка в данных введенных покупателем |
| 701 | Некорректный номер телефона |
| 711 | Номер телефона неприемлем для выбранной ПС |
| 850 | Ни одна из платежных систем не готова принять запрос |
| 1000 | Внутренняя ошибка сервиса (может не повториться при повторном обращении) |
*Чтобы проанализировать причины возникшей ошибки подписи, можно воспользоваться страницей «Проверка подписи к запросу» в Личном Кабинете.
Причины отказа
| Код отказа | Описание причины отказа |
|---|---|
| 0 | Нет ошибки (в описании придет пустая строка) |
| 1 | Неизвестная причина отказа |
| 2 | Общая ошибка |
| 3 | Ошибка на стороне платежной системы |
| 4 | Не удалось выставить счет ни в одну из платежных систем |
| 5 | Неправильный запрос в платежную систему |
| 40 | Превышение лимитов |
| 50 | Платеж отменен |
| 100 | Ошибка в данных покупателя |
| 101 | Некорректный номер телефона |
| 300 | Некорректная транзакция по карте |
| 301 | Неверный номер карты |
| 302 | Неверное имя держателя карты |
| 303 | Неверное значение CVV2/CVC2 |
| 304 | Неверный срок действия карты |
| 305 | Данный вид карты не поддерживается банком |
| 306 | Некорректная сумма |
| 310 | Карта клиента просрочена |
| 315 | Неверный платежный токен |
| 320 | Отказ по соображениям безопасности |
| 321 | Не пройдена аутентификация по 3ds |
| 329 | Карта украдена, утеряна или скомпрометирована. |
| 330 | Неизвестный банк эквайер |
| 340 | Неизвестный банк эмитент |
| 350 | Превышение количества использований карты клиента за определенный промежуток времени |
| 351 | Превышение установленного эмитентом лимита по карте. |
| 352 | На счете клиента не хватает средств |
| 353 | Отказ от банка эмитента без объяснения причины. |
| 354 | Транзакция не разрешена для банка эквайера |
| 355 | Эмитент запрещает online оплату для этой карты |
| 389 | Общая техническая ошибка системы |
| 390 | Ограничения по карте |
| 391 | Карта заблокирована |
| 392 | Повторный запрос не разрешен |
| 400 | Транзакция заблокирована по решению fraud-фильтров |
| 410 | Клиент не подтвердил свой номер телефона |