Партнерка на США и Канаду по недвижимости, выплаты в крипто

  • 30% recurring commission
  • Выплаты в USDT
  • Вывод каждую неделю
  • Комиссия до 5 лет за каждого referral

Заключение

Не смотря на кажущуюся сложность протокола, магазину среднего уровня по силам самостоятельно реализовать данный протокол взаимодействия, используя приведенную документацию, утилиту checker для формирования подписанной строки данных, и - в качестве образца -. дистрибутив ПО магазина. Вкупе с использованием возможности отправки транзакций Reversal (void) это даст магазину гибкий и удобный механизм интеграции с нашей платёжной системой.

____________________________________________________________________________

2. Общие сведения о программном обеспечении .

Устанавливаемое на стороне магазина программное обеспечение (ПО) представляет собой CGI (Common Gate Interface) приложение, написанное на языке Perl. ПО CyberPOS реализует протокол взаимодействия (ссылка) с платёжной системой CyberPlat и предназначено для проведения электронными магазинами платежей и транзакций reversal (отмены платежей до их отправки на финансовую авторизацию). ПО представляет собой набор cgi-приложений (скриптов) и шаблонов в виде html-файлов, а также включает утилиту checker. exe для UNIX платформ или com – объект для WINDOWS платформ, обеспечивающие аутентификацию при передачи данных. ПО имеет интерфейс для ввода данных платежа и для отображения его результатов в браузере покупателя.

1. ПО магазина должно вызвать скрипт cybercard. cgi, передав ему необходимые данные о покупке. Скрипт осуществляет корректность и достаточность данных, подписывает их с помощью утилиты checker. exe и выдаёт клиенту страницу перенаправления с этими данными. При вызове скрипта следует придерживаться определённых правил безопасности во избежание возможности

НЕ нашли? Не то? Что вы ищете?

2. Авторизационный Сервер (АС), получив вызов от клиента, проверяет IP-адрес магазина, подпись под данными, их полноту. В случае ошибки АС возвращает клиента на сервер магазина с соответствующим сообщением.

3. После успешных проверок клиенту выдаётся страница выбора платёжного средства. Список кредитных, скретч-карт зависит от принимаемых магазином карт. В случае, если магазин предоставил выбор платёжного средства на своём сервере и передал АС его код, эта страница не выводится и клиенту предлагается сразу следующий этап.

4. После выбора типа платёжного средства клиент вводит параметры платёжного средства.

5. АС, получив и обработав карточные данные, возвращает клиенту страницу перенаправления на сервер магазина с подписанными результатами авторизации. Параллельно Авторизационный Сервер формирует электронное письмо в адрес магазина, указанный при регистрации.

6. Скрипт магазина result. cgi проверяет корректность данных, электронно-цифровую подпись (ЭЦП), обрабатывает полученные данные, сохраняет результат и выдаёт сообщение на экран в зависимости от результата. При положительном ответе скрипт выдаёт клиенту электронный чек. Если магазин использует терминалы, то оформление результирующей страницы может быть различным для каждого терминала.

Соответствующие настройки ПО позволяют сохранять данные запроса и ответа в специальных файлах для последующей обработки или ссылки в случае каких-либо разногласий между магазином и CyberPlat. Возможно ведение log-файла с различным уровнем детализации.

Процедура установки ПО описана в документе «Установка и настройка», а детальное описание логики работы и всех файлов – в «Детальное описание ПО».

Для использования возможности отмены транзакций, прошедших только on-line авторизацию, в дистрибутиве ПО существует отдельное приложение, описание которого находится в соответствующем документе.

_____________________________________________________________________________________________

3. Установка и настройка программного обеспечения .

Устанавливаемое на стороне магазина программное обеспечение (ПО) представляет собой CGI (Common Gate Interface) приложение, написанное на языке Perl. Оно выполняет следующие задачи:

Обеспечение защищенного обмена данными между АС и магазином. Безопасный способ передачи данных платёжного средства клиента: интерфейс для перенаправления броузера клиента на страницу АС, собирающую данные о кредитной карте клиента по защищенному каналу. Визуализацию процесса обработки кредитной карты.

Для работы ПО магазина требуется наличие установленного интерпретатора языка PERL и дополнительных модулей CPAN (см. Приложение).

Распакуйте инсталляционный архив ПО магазина во временный каталог на сервере. Скопируйте папку shop, входящую в дистрибутив ПО магазина в некий каталог пространства web-сайта магазина, настройте каталог таким образом, чтобы в нем могли выполняться файлы-скрипты ‘cgi’ по запросу вида: http://<URL магазина>/shop/test. cgi

Проверьте, чтобы пользователь, с правами которого работает магазин (под Unix), имел право на чтение из каталога, в которой находятся ключи, право на запуск утилиты checker. exe и права на запись в подкаталог Sessions.

Для правильной работы ПО магазина под Unix необходимо установить права доступа к папке /shop такие же, как у web-сервера, который будет с ней работать (команда: chown –R nobody /shop, где /shop – корневой каталог ПО магазина).

Проверьте правильность указания пути к интерпретатору Perl для Вашей Unix операционной системы в первой строке следующих файлов: cybercrd. cgi, setshop. pl, test. cgi, result. cgi

Для определения пути к интерпретатору пользуйтесь командой which perl.

Обязательно для UNIX-систем:

Перед началом установки ПО магазина необходимо скомпилировать программу checker. exe, которая осуществляет криптозащиту передаваемой и принимаемой информации. Для этого нужно:

Скомпилировать библиотеку ipriv, которая находится в каталоге /Shop/ipriv/ дистрибутива. Для компиляции библиотеки нужно воспользоваться поставляемыми вместе с исходными текстами библиотеки make-файлами для разных операционных систем (например: make - f makefile. linux). Собрать checker. exe, выполнив команду make в каталоге /Shop/checker/.
Для ОС Linux, BSD, Solaris, HP-UX в службе поддержки есть готовые скомпилированные варианты этой программы. Переместите checker. exe в каталог /Shop.

Для инициации процесса установки ПО магазина выполните команду: perl setshop. pl (для Windows-платформы – команда setshop. bat под учетной записью «Администратор»). Этот файл содержит Perl-скрипт, результатом выполнения которого будут настроенные скрипты магазина. Перед запуском setshop. pl поместите файлы Random. bin, Secret. key и Pubkeys. key в каталог Keys (подкаталоги Real или Test, в зависимости от цели работы ПО) магазина.

Проверьте наличие в каталоге файлов checker. exe и checker. ini. Ответьте на задаваемые программой инсталляции вопросы (первые три пункта требуются для предоставления электронного чека клиенту):

    Режим работы магазина (тестовый, реальный) Торговое наименование предприятия Латинское наименование магазина в процессинге (необходимо уточнить в коммерческом отделе CyberPlat после регистрации магазина) Контактные координаты (например, e-mail) URL АС – card. *****/cgi-bin/GetForm. cgi для реальной системы и payment. *****/cgi-bin/GetForm. cgi для тестовой Путь к каталогу ключей (например: /Shop/Keys ) Ключевую фразу-пароль для подписания сообщений от магазина, которую Вы использовали при создании криптографических ключей магазина

Примечание: Если Вы неверно ответили на вопросы, Вы можете сделать это еще раз, запустив файл setshop. pl(.bat). В случае, если меняется только комплект ключей, можно либо запустить этот файл, либо вручную изменить параметры в файле checker. ini (keypath, password, keynumber, bankkey), а также изменить некоторые параметры в Path. pm (пути в переменных $SIGN_TOOL (для UNIX платформ) и $SIGN_INI).

В результате будут созданы файлы Paths. pm, Data. pm и checker. ini. Эти файлы являются конфигурационными и допускают дополнительную настройку, описанную в разделе «Настройка дополнительных параметров».

Проверьте, чтобы пользователь, с правами которого работает магазин, имел право на чтение из каталога, в котором находятся ключи, право на запуск утилиты checker. exe и права на запись в подкаталог Sessions.

Теперь можно выполнить тестовый платеж: вызвать с любой клиентской машины скрипт test. cgi из дистрибутива ПО магазина. (например: http://<URL магазина>/shop/test. cgi).

Рекомендуется вынести каталог Keys из пространства web-сайта магазина (например, в корневой каталог) из соображений защиты ключей. В противном случае возможен несанкционированный доcтуп к ключам и конфигурационному файлу с кодовой фразой любого анонимного пользователя. Также рекомендуется выносить из web-пространства каталог Session, если магазин анализирует его для решения о предоставлении товара или услуги на основе неподписанных файлов сессий. Кроме того, следует озаботиться безопасной передачей входных параметров на скрипт cybercrd. cgi, дабы нерадивый клиент не мог исправить важные параметры.

Настройка дополнительных параметров

ПО магазина позволяет выполнять настройку дополнительных параметров, включать или отключать опции установленные по умолчанию.

Настраиваемые параметры файла Data. pm:

$EnterpriseName = 'ООО «Услуги Онлайн»';

Торговое наименование предприятия. Используется для отображения в электронном чеке

$MerchantName = 'Electronic books';

Латинское наименование магазина в процессинге. Используется для отображения в электронном чеке

$OperationType = 'e-commerce';

Тип операции. Не может быть изменено

$HelpDesk = '*****@***ru';

Контактный email магазина

$LogLevel = 1;

Уровень детализации лог файла (cybercrd. log). Режимы: 1 – отладка (записываются все сообщения), 2 – сохранение ключевых моментов транзакции, 3 – сохранение только критических ошибок приложения

$WillConvert = 1;

Будет ли вестись суммарный файл транзакций checks. inf. Файл имеет формат: SessionID|OrderID|Status

$TerminalID = ‘’;

Код терминала. Устанавливается, если магазин имеет несколько терминалов ($ManyTerminals=1)

$ManyTerminals = 0;

Устанавливается в 1 если магазин имеет более одного терминала. По умолчанию отключена

$ManyChecks = 1;

Сохранять ли результаты авторизации в разных каталогах /Sessions_<TerminalID> (используется при наличии нескольких терминалов)

$ManyTemplates = 1;

Использовать ли разные шаблоны для каждого терминала. Опция работает, если создан каталог /Templates_<TerminalID> с файлами шаблонов. По умолчанию отключена

$Language = 'ru';

Язык интерфейса, используемый по умолчанию. Может иметь значения ‘ru’ и ‘en’. По умолчанию ‘ru’

$CheckParams = 1;

Выполнять ли проверку корректности введенных пользователем данных. 1 – да, 0 – нет. Опция может быть отключена только в тестовых целях. По умолчанию включена

$SaveSignedRequest = 0;

Сохранять ли подписанный магазином запрос. Если да, то запрос сохраняется в каталоге /Sessions в файлах с расширением ‘.in’. По умолчанию опция отключена

$SaveChecks = 1;

Сохранять ли чеки (подписанный ответ АС). Если да, то чек сохраняется в каталоге /Sessions в файлах с расширением ‘.res’. По умолчанию опция включена

$SaveSession = 1;

Сохранять ли файлы сессий (ответ АС без подписи). Если да, то сессия сохраняется в каталоге /Sessions в файлах с расширением ‘.sta’. По умолчанию опция включена

Настраиваемые параметры файла Paths. pm:

$SIGN_TOOL = '/home/httpd/cgi-bin/shop/keys/checker_exe';

Путь к утилите checker. exe. Может быть модифицирован при изменении каталога ключей (вместе с $SIGN_INI) (для UNIX платформ)

$SIGN_INI = '/home/httpd/cgi-bin/shop/keys/ checker_ini';

Путь к файлу настроек утилиты checker. exe. Может быть модифицирован при каталога ключей (вместе с $SIGN_TOOL)

$FORM_URL = 'card. *****/cgi-bin/GetForm. cgi ';

URL скрипта АС, принимающего запрос на авторизацию. Может быть изменен только при переносе скрипта и по согласованию с группой технической поддержки CyberPlat

$SHOP_IP = $ENV{'SERVER_ADDR'};

IP адрес сервера магазина. Может быть задан явно в случае, если это необходимо

Настраиваемые параметры файла checker. ini:

keypath= /home/httpd/shop_keys/;

Путь к каталогу ключей

password=;

Кодовая фраза, использованная при генерации ключей магазина

keynumber=11206;

код клиента (из третьей строки файла карточки ключа K<shop_code>.dat)

bankkey=1;

Код банка, берется из файла CyberCard. iks

Трубуют изменения только при формировании нового комплекта ключей. Параметры, указанные в таблице изменяются либо при переносе каталога ключей (изменяется только keypath), либо после генерации нового комплекта ключей (изменяются остальные параметры). Проще всего внести подобные изменения, запустив скрипт setshop, который выполнит все настройки автоматически. В случае проблем при ручной настройке обращайтесь в службу технической поддержки CyberPlat.

Приложение: Интерпретатор языка Perl и дополнительные модули CPAN для Windows и Unix

Для работы ПО магазина необходимо иметь установленный интерпретатор языка Perl версии 5.005 и выше для Unix (его можно взять на официальном сайте Perl), и ActivePerl версии 522 и выше для Windows (его можно бесплатно взять на сайте ActiveState).

Описание настройки Microsoft Internet Information Server 4.0 и 5.0 для работы с Perl для Windows

Зайдите в меню Properties Вашего сайта и выберите закладку Home Directory. Нажмите кнопку Configuration... Нажмите кнопку Add. В строке Executable выберите файл perl. exe (по умолчанию устанавливается в каталог c:\perl\bin\) Добавьте к строке ввода “%s” %s, таким образом, окончательно она будет выглядеть следующим образом: c:\perl\bin\perl. exe “%s” %s. Введите в строку Extension расширение. cgi Выберите в меню Verbs радио-кнопку Limit to: и укажите GET, POST. Установите чек-бокс Check that file exist во включенное состояние.

Описание настройки Microsoft Internet Information Server 2.0 для работы с Perl для Windows

После установки ActivePerl необходимо настроить Microsoft IIS таким образом, чтобы на файлы с расширением. cgi вызывался Perl. Для IIS версии 2 для этого необходимо в системном реестре в аздел
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC
\Parameters\Script Map добавить поле с именем. cgi и присвоить ему значение соответствующее пути к файлу Perl. exe
(например: C:\Perl\bin\Perl. exe %s%s).

_____________________________________________________________________________________________

4. Логика работы ПО магазина .

1.  Запуск приложения происходит в момент вызова магазином скрипта cybercrd. cgi (для этого в качестве примера можно использовать скрипт test. cgi дистрибутива) с набором параметров, необходимых для инициации транзакции (см. приложение «Параметры запроса магазина»).Если параметры не получены или некорректны, или какая-либо операция не может быть выполнена, приложение сообщит об ошибке (шаблон error_xxx. htm) и прекратит работу.

Помимо обязательных параметров магазин может передать также дополнительную информацию о клиенте, совершающем оплату. Это позволит платёжной системе предоставлять более полный спектр услуг, как магазинам, так и клиентам. Полный список параметров находится в Приложении «Параметры запроса магазина».

Рекомендуется также самостоятельно формировать поле PaymentDetails - описание (назначение) платежа. Это поле отражается в выписке по счёту магазина, а также отображается клиенту в электронном чеке при успешном результате авторизации. По умолчанию это поле формируется автоматически в формате: «оплата заказа #<номер платежа>, <сумма платежа> <валюта платежа.

Пример формы магазина

<FORM ACTION=”http://<URL магазина>/cgi-bin/shop/cybercrd. cgi”

METHOD=”POST”>

<INPUT TYPE=”HIDDEN” NAME=”OrderID” VALUE=”279”>

<INPUT TYPE=”HIDDEN” NAME=”PaymentDetails”

VALUE=”оплата заказа #”>

<INPUT TYPE=”HIDDEN” NAME=”Amount” VALUE=”3.00”>

<INPUT TYPE=”HIDDEN” NAME=”Currency” VALUE=”2”>

<INPUT TYPE=”HIDDEN” NAME=”FirstName” VALUE=”Иван”>

<INPUT TYPE=”HIDDEN” NAME=”MiddleName” VALUE=”Иванович”>

<INPUT TYPE=”HIDDEN” NAME=”LastName” VALUE=”Иванов”>

<INPUT TYPE=”HIDDEN” NAME=”Email” VALUE=”*****@***ru”>

<INPUT TYPE=”SUBMIT” NAME=”Submit” VALUE=”Оплатить”>

</FORM>

Рекомендуется скрывать от клиента вызов скрипта cybercrd. cgi, осуществляя его интеграцию с собственным программным обеспечением.

Приложение проводит проверку данных клиента и формирует запрос к АС. Перед отправкой запроса будет вызвано приложение checker, которое подпишет запрос цифровой подписью. Существует параметр настройки ПО, позволяющий сохранять подписанный запрос в каталоге /Sessions в файлах с расширением ‘.in’ (см. «Настройка дополнительных параметров»).

Пример

<form method=post action="https://payment. *****/cgi-bin/

Version1.5/GetForm. cgi">

<input type=hidden name=version value="2.0">

<input type=hidden name=message

value="SM

0mt0

BEGIN

OrderID=&Amount=400&Currency=RUR&PaymentDetails=

оплата заказа #&Email=*****@***com&FirstName=

cyberplat&LastName=support&MiddleName=none&Phone=&Address=

Moscow, Kutuzovsky pr. 12&Language=ru&return_url=http:

//mike. /cgi-bin/cyberpos/result. cgi

END

BEGIN SIGNATURE

iQBRAwkBAAArxjyPLFgBARB4AgCRvBKq1eCmQ8Fh5Hr2NShLVbcRE0PqJTre0gd35M

hUk86jOy8JTqjxGp5WYTEsJ4JZaJYRWK5FLmtIRZ05/BWj=l/qV

END SIGNATURE">

</form>

2. Если магазин имеет несколько терминалов, то, в зависимости от настроек, для вывода сообщений об ошибках могут быть использованы различные шаблоны, а файлы запросов магазина могут быть сохранены в разных каталогах формата /Sessions_<TerminalID>.

4.  Приложение перенаправляет браузер клиента на страницу АС по сбору информации о кредитной карте, которая, в зависимости от переданных магазином данных, может иметь различный формат:

а. Если в запросе магазина передан тип кредитной карты, то будет загружена форма для данной карты, если нет – клиенту будет предложено сначала выбрать тип карты, а затем будет загружена соответствующая форма..

б. Если клиент выбрал опцию “Зарегистрирован в CyberPlatPay» при формировании заказа, ему будет предложено ввести персональный код на странице ввода параметров карты. Если магазин желает, чтобы осуществлял платёж зарегистрированный клиент, то необходимо передававать соответствующий параметр.

5.  После подтверждения ввода полученная от пользователя информация будет отправлена на Авторизационный сервер по защищенному SSL каналу.

5. При получении результата транзакции, АС передает управление магазину (скрипт result. cgi). В зависимости от результата авторизации result. cgi выдаст клиенту либо страницу успешного завершения транзакции (шаблон success_xxx. htm), либо страницу неудачного завершения транзакции (шаблон failure_xxx. htm), либо сообщение об ошибке самого приложения (шаблон error_xxx. htm). Имя шаблона имеет формат <статус платежа>_xxx. htm, где xxx - язык, выбранный клиентом в начале процесса оплаты. В настоящее время ПО поддерживает сообщения на русском и английском языках.

6. Если установлены опции сохранения чека ответа АС и состояния платежа, то эти данные будут сохранены соответственно в каталоге /Sessions в файлах с расширением ‘.res’ и ‘.sta’ (см. приложение «Настройка ПО магазина»).

7. Если магазин имеет несколько терминалов, то, в зависимости от настроек, для вывода результата могут быть использованы различные шаблоны, а файлы чеков и сессий магазина сохранены в разных каталогах формата /Sessions_<TerminalID>

Вся информация об этапах проведения транзакции пишется в корневой каталог магазина в лог-файл cybercrd. log, в формате:

<Статус(1)><Дата(mm/dd/yyyy)> <Время(hh:mm:ss)>: OID <Номер заказа> <Сообщение>

Кроме того, выписки по совершенным транзакциям за любой период оператор магазина может посмотреть на Авторизационном сервере: https://card. *****/cgi-bin/translog/translog. cgi

Описание файлов и каталогов дистрибутива

cybercrd. cgi

CGI скрипт, выполняющий проверку данных, введенных клиентом, их подпись ЭЦП магазина и передачу сформированного запроса на АС по https протоколу

result. cgi

CGI скрипт, выполняющий обработку результатов авторизации, полученных от АС, их отображение в браузере клиента и сохранение файлах чеков и сессий

Data. pm

настройки и переменные приложения (в инсталляционный комплект не включен, создается с помощью конфигурационной утилиты setshop. pl)

Log. pm

модуль ведения log-файла

Paths. pm

файл, содержащий адреса к файлам и URL обращений к АС (в инсталляционный комплект не включен, создается с помощью конфигурационной утилиты setshop. pl)

Util. pm

модуль дополнительных утилит

setshop. pl (setshop. bat)

утилита настройки ПО магазина

checker. exe

утилита для подписи запросов магазина и проверки подписи АС для UNIX платформ

checker. ini

файл конфигурации утилиты checker. exe. Создается при запуске скрипта setshop. bat (.pl)

test. cgi

CGI-приложение, предназначенное для тестирования работы программного комплекса. Эмулирует вызов механизма авторизации магазином

reversal. cgi

модуль для проведения reversal транзакций. Он описан в отдельном разделе

cybercrd. log

log-файл, содержащий информацию о каждой транзакции. Создаётся при первом запуске приложения cybercrd. cgi. Имеет несколько уровней детализации информации (задается переменной $LogLevel в файле Data. pm (после установки) дистрибутива ПО магазина, по умолчанию установлена равной 0 – полная деталировка):
0 - тестовые сообщения и сообщения о работе с самим лог-файлом
1 - сообщения о нормально завершенном действии, уровень 1
2 - сообщения о нормально завершенном действии, уровень 2
3 - серьезные ошибки

Подкаталог Templates

Предназначается для хранения html-шаблонов страниц, используемых приложением в процессе работы.

Success_xxx. htm

страница завершения работы при успешном окончании транзакции

Failure_xxx. htm

страница завершения работы при неудачном окончании транзакции

Error_xxx. htm

страница показа сообщения об ошибке в работе системы

Подкаталог Keys

Содержит подкаталоги /Real и /Test для реальных и тестовых ключей магазина. Утилита setshop. bat (.pl) при выборе режима работы магазина по умолчанию определяет один из этих каталогов каталогом ключей. Рекомендуется вынести этот каталог из пространства web-сайта магазина (например, в корневой каталог) из соображений защиты ключей. В противном случае возможен несанкционированный допуск к ключам и конфигурационному файлу с кодовой фразой любого анонимного пользователя.

Подкаталог Sessions

Предназначается для хранения файлов, содержащих финальный статус сессий, проходивших через магазин. В этом же каталоге находится файл checks. inf, содержащий список всех заказов и номера сессий, им соответствующих. Каждая строка этого файла имеет формат:
номер сессии | номер заказа | статус заказа

пример:
987987|| - 10

Финальный статус сессий содержится в файлах с расширением sta и res. Res-файл (чек) содержит полный ответ АС, включая электронно-цифровую подпись. Чек может служить в качестве документа при случаях разбора конфликтных ситуаций. Sta-файл содержит только одну строку – содержание ответа. Этот файл удобен для автоматической обработки результатов сессии программным обеспечением магазина, занесения результатов в самостоятельную базу данных магазина.

Название файла: <номер сессии>.sta Содержание в формате:
<ключ1>=<значение1>&…&<ключn>=<значениеn>

Ключи:

    SessionStatus – статус сессии (0 – все нормально, 1 – ошибка на стороне магазина, 2 – ошибка на стороне сервера) SessionDescription – описание последнего состояния сессии, результата авторизации или ошибки. TransactionID - в случае, если транзация завершилась успешно, содержит идентификатор транзакции.

Пример:

Файл с неудачной транзакцией:
SessionStatus=1&SessionDescription=Authorization failed

Файл с успешной транзакцией:
SessionID=1231231&OrderID=89734&Status=0&TransactionID=
123567&Description=Transaction Completed

По умолчанию в файле Data. pm установлен режим сохранения чека. При желании можно изменить значение переменной, в этом случае в каталог будет записываться только sta-файл. $SaveChecks = 1 (0 – нет, 1 – да)

Подкаталог Install. tpl

Cодержит шаблоны конфигурационных файлов приложения.

Data. tpl

шаблон для формирования файла Data. pm

Paths. tpl

шаблон для формирования файла Paths. pm

Checker_shop. tpl

шаблон формирования файла checker. ini в каталоге с ключами

Приложение: «Параметры запроса магазина»

Наимено-
вание параметра

Формат поля, максимальный размер или значение

Обязатель-
ность
параметров
(+/–)

Пояснение

OrderID

255

+

Номер заказа в магазине, может быть уникальным или нет, в зависимости от настроек магазина в Платёжной системе

Amount

Numeric

+

сумма к оплате Сумма указывается в наименьших единицах валюты (копейка, цент)

Language

Значения из справочника. В настоящее время доступны следующие значения: ru – русский; en – английский.

-

Язык ответа авторизационного сервера. При отсутствии принимается равным установленному по умолчанию на магазине. и сообщения клиенту возвращается в соответствии с этими установками

Currency

Значение из справочника. Код валюты соответствует ISO: RUR – рубли; USD – доллары; EUR - евро.

+

Код валюты. Обязательный параметр, так как является необходимой характеристикой суммы транзакции. Обязательность параметра принята во избежание конфликтов с магазином

PaymentDetails

255

-

Описание (назначение) платежа. Это поле отражается в выписке по счёту магазина, что удобно бухгалтерии магазина для дальнейшего анализа, а также в электронном чеке, предъявляемом клиенту при успешной авторизации

CardType

Значение из справочника. Сейчас доступны следующие типы:
AX – American Express
DC –Diners Club
EP – E-PORT
EU – EuroCard/ MasterCard
JC – JCB
UC – Union Card
VI – VISA
Список может пополняться другими платёжными средствами

-

Тип платёжного средства. Может быть использован в случае, если магазин явно хочет предоставить клиенту выбор типа платёжного средства на своей стороне. Необходимо отметить, что при этом рекомендуется устанавливать соответствующее значение поля registered. Тогда клиент будет перенаправлен сразу на вторую авторизационную страницу. Кроме того, каждому магазину соответствует свой список карт, поскольку разные процессинги могут обрабатывать не все карты из приведённого списка.

Registered

True / отсутствует

-

Зарегистрирован ли клиент в системе CyberPlatPay. Значение «true» используется только в случае, если необходимо авторизовать зарегистрированного клиента CyberPlatPay. В остальных случаях необходимость передачи параметра отсутствует.

FirstName

Макс. длина поля 70 символов

+

имя покупателя

MiddleName

Макс. длина поля 70 символов

-

отчество покупателя

LastName

Макс. длина поля 70 символов

+

фамилия покупателя

Email

Макс. длина поля 70 символов

+

E-mail клиента

Phone

Макс. длина поля 70 символов

-

Телефон покупателя. Желательно передача этого параметра, если клиент ранее сообщил его магазину

Address

Макс. длина поля 255 символов

-

Адрес покупателя. Передаётся магазином, если клиент указал свой адрес или адрес доставки

POS

до 5 символов

-

Зарезервировано для будущего использования

Terminal

Макс. длина поля 80 символов

-

Код терминала – используется магазинами (биллингами) в случаях обслуживания веб-мастеров, или использования нескольких подразделов. Этот параметр возвращается в магазин после авторизации и может быть использован для отображения разных шаблонов

return_url

+

Адрес, на который необходимо вернуть клиента после завершения авторизации

____________________________________________________________________________________

Из за большого объема этот материал размещен на нескольких страницах:
1 2 3