Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

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

Другая ошибка при выполнении операции.

...