Page History
...
HTTP заголовки (httpAttributes)
HTTP заголовки
Поле | Описание | Тип |
AcceptLanguage | Заголовок Accept Language http-запроса. | Строковый (128 символов) |
UserAgent | Заголовок User Agent http-запроса. | Строковый (255 символов) |
Accept | Заголовок Accept http-запроса. | Строковый (255 символов) |
Referer | Заголовок Referer http-запроса. | Строковый (255 символов) |
Forwarded | Заголовок Forwarded http-запроса. | Строковый (16 символов) |
XForwardedFor | Заголовок XForwarded-For http-запроса. | Строковый (16 символов) |
Via | Заголовок Via http-запроса. | Строковый (128 символов) |
Переменные окружения сервера (serverAttributes)
Переменные окружения сервера
Поле | Описание | Тип |
RemoteAddress | IP-адрес клиента. | Строковый (16 символов) |
ServerProtocol | Переменная окружения Server_Protocol. | Строковый (16 символов) |
HostName | Имя хоста клиента. | Строковый (70 символов) |
...
Результатом работы процедуры всегда является ответ в виде объекта типа getAFSResult, содержащий данные о проверке платежа в случае успешного выполнения процедуры (код результата ее работы RetCodeравен нулю) или не содержащий данные о проверке платежа в случае неуспешного выполнения процедуры (код результата ее работы RetCodeне равен нулю).
Выходные параметры процедуры check
Параметр | Описание | Тип |
FraudStatus | Код фрод-статуса проверяемой операции. | Числовой (15) |
ReasonDescription | Описание причины выставления фрод-статуса проверяемой операции . | Строковый (100 символов) |
ReasonId | Код причины выставления фрод-статуса. | Числовой (15) |
RetCode | Результат выполнения процедуры. | Целочисленный (10) |
Description | Произвольный комментарий к результату выполнения процедуры. | Строковый (2000 символов) |
...
Все параметры данной процедуры являются обязательными.
Входные параметры процедуры set3DSecData
Параметр | Описание | Тип |
outPaymentId | Идентификатор платежной операции во внешней системе. | Числовой (15) |
outSystemId | Идентификатор внешней системы. | Числовой (15) |
authResult | Результат авторизации по 3DSecure (Y - успешно, N - неуспешно, A - Attempt, U –неизвестно). | Строковый (1 символ) |
authRequired | Результат проверки вовлеченности карты (1 – вовлечена, 0 – не вовлечена, -1 – неизвестно, null – все остальное). | Числовой (1) |
...
Результатом работы процедуры является текущий фрод-статус платежа, который можно использовать для принятия решения о дальнейших действиях над платежом.
Выходные параметры процедуры set3DSecData
Параметр | Описание | Тип |
FraudStatus | Код фрод-статуса проверяемой операции . | Числовой (15) |
ReasonDescription | Описание причины выставления фрод-статуса проверяемой операции. | Строковый (100 символов) |
ReasonId | Код причины выставления фрод-статуса . | Числовой (15) |
RetCode | Результат выполнения процедуры. | Целочисленный (10) |
Description | Произвольный комментарий к результату выполнения процедуры. | Строковый (2000 символов) |
Коды результатов выполнения процедуры set3DSecData
Код | Описание |
0 | Операция прошла успешно, ошибок нет. |
2 | Ошибка авторизации внешней системы. |
4 | Указан несуществующий идентификатор платежа. |
1 | Другая ошибка при выполнении операции. |
...
Все параметры данной процедуры являются обязательными.
Входные параметры процедуры getFraudStatus
Параметр | Описание | Тип |
outPaymentId | Идентификатор платежной операции во внешней системе. | Числовой (15) |
outSystemId | Идентификатор внешней системы. | Числовой (15) |
...
Результатом работы процедуры всегда является ответ в виде объекта типа getAFSResult, содержащий данные о проверке платежа в случае успешного выполнения процедуры (код результата ее работы RetCode равен нулю) или не содержащий данные о проверке платежа в случае неуспешного выполнения процедуры (код результата ее работы RetCodeне равен нулю).
Выходные параметры процедуры getFraudStatus
Параметр | Описание | Тип |
FraudStatus | Код фрод-статуса проверяемой операции . | Числовой (15) |
ReasonDescription | Описание причины выставления фрод-статуса проверяемой операции. | Строковый (100 символов) |
ReasonId | Код причины выставления фрод-статуса. | Числовой (15) |
RetCode | Результат выполнения процедуры. | Целочисленный (10) |
Description | Произвольный комментарий к результату выполнения процедуры. | Строковый (2000 символов) |
PaymentParameters | Список возвращаемых параметров платежа | Список из структур: name — название параметра (строка, регистр не важен); booleanValue — заполняется, если значение параметра имеет логический тип (true, false); doubleValue — заполняется, если значение параметра имеет числовой тип; stringValue — заполняется, если значение параметра имеет строковый тип; intValue — заполняется, если значение параметра имеет целочисленный тип; dateValue — заполняется, если значение параметра имеет тип дата. |
Список возвращаемых параметров платежа PaymentParameters
Параметр | Описание | Тип |
date | Дата платежа, если она была передана от внешней системы. Иначе дата получения данных по платежу в СПМ. | Дата |
calculateAmount | Пересчитанная сумма платежа в основной валюте СПМ. | Числовой |
outAmount | Переданная от внешней системы сумма платежа. | Числовой |
outCurrencyCode | Код валюты, в которой была передана сумма платежа. | Строковый |
Email плательщика. | Строковый | |
phone | Телефон плательщика. | Строковый |
mobilePhone | Телефон плательщика. | Строковый |
cardNumberMask | Номер банковской карты плательщика (первые 6 и последние 4 цифры). | Строковый |
cardType | Тип банковской карты, определенный в СПМ по номеру карты. | Строковый |
cardSubType | Подтип банковской карты, определенный в СПМ по номеру карты. | Строковый |
cardholder | Держатель карты. | Строковый |
cardBankCountry | Страна банка эмитента, определенная по номеру карты. | Строковый |
cardBank | Название банка эмитента, определенное по номеру карты. | Строковый |
expiredate | Дата окончания действия банковской карты. | Дата |
acquirer | Уникальное название эквайера в переделах внешней системы. | Строковый |
cookie | Значение уникального идентификатора плательщика, переданное внешней системой. | Строковый |
ip | IP-адрес покупателя. | Строковый |
ipCountry | Страна, определенная по IP-адресу покупателя. | Строковый |
billNumber | Номер счета из внешней системы. | Строковый |
orderNumber | Номер заказа из внешней системы. | Строковый |
outStatus | Статус операции в соответствии со справочником СПМ. | Числовой |
outStatusName | Название статуса операции. | Строковый |
fraudStatus | Числовой | |
reasonId | Числовой | |
testMode | Тестовый режим. | Логический |
usedCSC | Использовался ли Card Secure Code. | Логический |
3DSecAuthresult | Результат авторизации по 3DSecure (Y - успешно, N - неуспешно, A - Attempt, U – неизвестно). | Строковый |
3DSecAuthrequired | Результат проверки вовлеченности карты (1 – вовлечена, 0 – не вовлечена, -1 – неизвестно, null – все остальное). | Числовой |
recurringIndicator | Режим рекуррентного платежа. | Логический |
billingPostalCode | BillingData. Индекс предприятия связи покупателя. | Строковый |
billingAddress | BillingData. Адрес покупателя. | Строковый |
billingFirstName | BillingData. Имя покупателя. | Строковый |
billingLastName | BillingData. Фамилия покупателя. | Строковый |
billingPhoneNumber | BillingData. Телефон покупателя. | Строковый |
billingEMailAddress | BillingData. E-mail покупателя. | Строковый |
customer | ФИО покупателя. | Строковый |
customerCountry | Страна, указанная покупателем. | Строковый |
customerRegion | Регион, указанный покупателем. | Строковый |
customerCity | Город, указанный покупателем. | Строковый |
customerAddress | Адрес, указанный покупателем. | Строковый |
clientSystemLanguage | Код языка операционной системы покупателя. | Строковый |
clientLocalTime | Местное время клиента. | Строковый |
clientUserLanguage | Код языка покупателя. | Строковый |
clientBrowserLanguage | Код языка веб-браузера покупателя. | Строковый |
clientBrowserPlatform | Наименование платформы, на которой работает браузер покупателя. | Строковый |
clientJsBrowserName | Название браузера покупателя. | Строковый |
clientJsVersion | Версия интерпретатора Java script. | Строковый |
clientTimeZone | Смещение времени в часовом поясе покупателя относительно GMT в минутах. Например, для GMT +2 в часах значение в минутах + 120. | Строковый |
clientCookieEnabled | Есть поддержка Cookie и они включены в браузере покупателя. | Логический |
clientJavaEnabled | Есть поддержка Java script и интерпретатор включен. | Логический |
clientConnectionType | Тип соединения по HTTP. | Строковый |
clientProcessor | Название процессора на компьютере покупателя. | Строковый |
clientScreenRes | Разрешение экрана на компьютере покупателя. | Строковый |
clientScreenPixelDepth | Глубина цветов экрана на компьютере покупателя. | Числовой |
clientStylesheetsEnabled | Поддержка css стилей. | Логический |
httpAccept | Заголовок Accept http-запроса. | Строковый |
httpAcceptLanguage | Заголовок Accept Language http-запроса. | Строковый |
httpReferer | Заголовок Referer http-запроса. | Строковый |
httpServerProtocol | Переменная окружения Server_Protocol. | Строковый |
httpUserAgent | Заголовок User Agent http-запроса. | Строковый |
hostname | Имя хоста покупателя. | Строковый |
Коды результатов выполнения процедуры getFraudStatus
Код | Описание |
0 | Операция прошла успешно, ошибок нет. |
2 | Ошибка авторизации внешней системы. |
4 | Указан несуществующий идентификатор платежа. |
1 | Другая ошибка при выполнении операции. |
...
Результатом работы процедуры всегда является ответ, содержащий код результата ее работы и закодированное описание результата в случае успешного выполнения процедуры (код результата RetCode равен нулю) или не содержащий данные о проверке платежа в случае неуспешного выполнения процедуры (код результата ее работы RetCodeне равен нулю).
Выходные параметры процедуры setStatus
Параметр | Описание | Тип |
RetCode | Результат выполнения процедуры. | Целочисленный (10) |
Description | Произвольный комментарий к результату выполнения процедуры. | Строковый (2000 символов) |
...
Все параметры данной процедуры, кроме параметра Email, являются обязательными.
Входные параметры процедуры setMerchantData
Параметр | Описание | Тип |
outSystemId | Идентификатор внешней системы. | Числовой (15) |
outMerchantId | Идентификатор мерчанта во внешней системе. | Числовой (15) |
merchantName | Наименование мерчанта. | Строковый (128 символов) |
merchantEmail | E-mail адрес мерчанта | Строковый (64 символа), необязательный параметр |
isOnMonitoring | Подлежат ли мониторингу платежи по данному мерчанту | Логический (true,false) |
categoryId | Идентификатор категории мерчанта из справочника категорий | Числовой (15) |
mcc | Идентификатор категории мерчанта (MCC - Merchant Category Code) | Строковый (4) – четырех-значный цифровой код |
Note |
---|
Результатом процедуры является обновление всех указанных параметров для мерчанта с данным идентификатором. Если в базе СПМ не найден мерчант с данным идентификатором из внешней системы, то в базе будет создана новая запись. |
Категории мерчантов
Код | Название |
19 | Книги, Видео, CD |
20 | Билеты в театр, кино, на концерты |
21 | Игорный бизнес |
22 | Цветы, подарки, парфюмерия |
23 | Искусство, коллекционные модели, награды |
24 | Службы знакомств |
25 | Программное обеспечение |
26 | Интернет и хостинг решения, кабельное TV |
27 | Обучение / конференции / форумы |
28 | Бытовая техника и электроника |
29 | Информационно - консультационные услуги |
30 | Компьютеры и комплектующие |
31 | Продукты питания |
32 | Средства массовой информации |
34 | Разное |
35 | Автозапчасти |
36 | Бронирование авиа и ж/д билетов, гостиниц, туров, машин |
37 | Библиотеки |
38 | Товары для красоты и здоровья |
39 | Одежда и обувь |
40 | Товары для дома / Мебель |
41 | Табачные изделия |
43 | Переводческие услуги |
44 | Благотворительность |
46 | Фото и полиграфия |
47 | Связь и телефония |
48 | Охранные системы |
49 | Он-лайн игры |
50 | Файлы для скачивания (Музыка, фильмы, передачи, книги) |
51 | Спорт и туризм |
52 | Ювелирные изделия, часы |
53 | Аукционы |
54 | Коммунальные и прочие платежи |
55 | Реклама |
56 | Страхование |
57 | Авиакомпании |
58 | Гостиницы |
59 | Купоны/сертификаты |
77 | Агрегаторы |
78 | Товары для детей |
97 | Онлайн трейдинг |
98 | Работа/рекрутинг/фриланс |
...
Результатом работы процедуры всегда является ответ, содержащий код результата ее работы и закодированное описание результата в случае успешного выполнения процедуры (код результата RetCode равен нулю) или не содержащий данные о проверке платежа в случае неуспешного выполнения процедуры (код результата ее работы RetCodeне равен нулю).
Выходные параметры процедуры setMerchantData
Параметр | Описание | Тип |
RetCode | Результат выполнения процедуры. | Целочисленный (10) |
Description | Произвольный комментарий к результату выполнения процедуры. | Строковый (2000 символов) |
Коды результатов выполнения процедуры setStatus
Код | Описание |
0 | Операция прошла успешно, ошибок нет. |
2 | Ошибка авторизации внешней системы. |
1 | Другая ошибка при выполнении операции. |
...