Запрос на оплату с помощью Samsung Pay (payment.do)

Для регистрации заказа используется запрос payment.do (см. ниже).

https://3dsec.sberbank.ru/payment/samsung/payment.do

Для операций отмены, возврата и завершения платежа следует использовать стандартные запросы к платёжному шлюзу.

В настоящем документе при описании параметров запросов и ответов используются следующие обозначения типов данных:

A<n> – последовательность латинских букв длины <n>;
A..<n> – последовательность латинских букв длиной, не превышающей <n>;
N<n> – последовательность цифр длины <n>;
N..<n> – последовательность цифр длиной, не превышающей <n>;
AN<n> – последовательность латинских букв и цифр фиксированной длины <n>;
AN..<n> – последовательность латинских букв и цифр длиной, не превышающей <n>;
ANS<n> – последовательность латинских букв, цифр и символов фиксированной длины <n>
ANS..<n> – последовательность латинских букв, цифр и символов длиной, не превышающей <n>;
UTC – дата и время, при этом: дата должна быть передана без указания часового пояса, время московское, для протокола SOAP используется стандартная кодировка xs:dateTime.

Параметры запроса

Параметры запроса представлены в таблице ниже.

Для корректной обработки запроса необходимо добавить заголовок с определением типа содержимого - Content-Type: application/json.

Название	Тип	Обязательно	Описание
`merchant`	AN..255	Да	Логин продавца в платёжном шлюзе.
`clientId`	ANS..255	Нет	Номер (идентификатор) клиента в системе магазина. Используется для реализации функционала связок. Может присутствовать, если магазину разрешено создание связок. Указание этого параметра при платежах по связке необходимо - в противном случае платёж будет неуспешен.
`orderNumber`	ANS..32	Да	Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы. Если номер заказа генерируется на стороне платёжного шлюза, этот параметр передавать необязательно
`description`	ANS..512	Нет	Описание заказа в свободной форме. В процессинг банка для включения в финансовую отчётность продавца передаются только первые 24 символа этого поля. Чтобы получить возможность отправлять это поле в процессинг, обратитесь в техническую поддержку.
`language`	A2	Нет	Язык в кодировке ISO 639-1. Если не указан, будет использован язык, указанный в настройках магазина как язык по умолчанию.
`feeInput`	N..8	Нет	Сумма комиссии в минимальных единицах валюты. Параметр передается только при включении соответствующей пермиссии.
`additionalParameters`	Не актуально	Нет	Дополнительные параметры заказа, которые сохраняются для просмотра из личного кабинета продавца. Дополнительные параметры следует указывать в следующем формате. `имя_параметра`: `значение_параметра` В параметре запрещено передавать зарезервированные имена (в случае их передачи заказ может быть отклонен): sbrf_spasibo:amount_bonus sbrf_sbermiles:amount_bonus loyaltyId overridenClientId
`preAuth`	A..5	Нет	Параметр, определяющий необходимость предварительной авторизации (блокирования средств на счёте клиента до их списания). Доступны следующие значения: `true` (истина) - параметр включён, производится двухстадийная оплата; `false` (ложь) - параметр выключен, производится одностадийная оплата (средства списываются сразу).
`clientId`	ANS..255	Нет	Номер клиента, для которого следует создать связку для проведения регулярных платежей. Следует указывать, только если проводится технический платёж для последующих регулярных платежей.
`paymentToken`	Строка	Да	Содержимое параметра `3ds.data` из ответа, полученного от Samsung Pay.
`ip`	ANS..39	Да	IP-адрес покупателя. IPv6 поддерживается во всех запросах (до 39 символов).
`currencyCode`	N3	Нет	Цифровой код валюты платежа ISO 4217. Если не указан, считается равным коду валюты по умолчанию.
`billingPayerData`	См. описание	Нет	Блок c регистрационными данными клиента (адрес, почтовый индекс), необходимыми для прохождения проверки адреса в рамках сервисов AVS/AVV. Обязателен, если активна соответствующая пермиссия для мерчанта («Разрешено использование AVS/AVV»).
`tii`	A2	Нет	Параметр, указывающий на то, какой тип операции будет проводиться со стороны инициатора (мерчанта или клиента).
`billingAndShippingAddressMatchIndicator`	A1	Нет	Индикатор совпадения адреса держателя карты для выставления счета и адреса доставки. Возможные значения: Y - адрес держателя карты для выставления счета и адрес доставки совпадают; N - адрес держателя карты для выставления счета и адрес доставки не совпадают. Этот параметр используется для дальнейшей 3DS аутентификации клиента.
`shippingPayerData`	См. описание	Нет	Блок с данными доставки клиента. Используется для дальнейшей 3DS аутентификации клиента.
`orderPayerData`	См. описание	Нет	Блок с данными о плательщике заказа. Используется для дальнейшей 3DS аутентификации клиента.
`preOrderPayerData`	См. описание	Нет	Блок с данными предзаказа. Используется для дальнейшей 3DS аутентификации клиента.

tii

Параметры блока tii

Значение	Описание	Тип транзакции	Инициатор транзакции	Данные карты	Данные сохраняются
CI	Первоначальный общий CIT (customer initiated transaction)	Инициирование	Клиент	Вводятся клиентом	Да
II	Первоначальный взнос CIT (customer initiated transaction)	Инициирование	Клиент	Вводятся клиентом	Да
RI	Первичный Рекуррентный CIT (customer initiated transaction)	Инициирование	Клиент	Вводятся клиентом	Да
F	Внеплановый CIT (customer initiated transaction)	Последующий	Клиент	Клиент выбирает карту вместо ручного ввода	Нет
U	Внеплановый MIT (merchant initiated transaction)	Последующий	Мерчант	Нет ручного ввода, мерчант передает данные	Нет
R	Рекуррентный MIT (merchant initiated transaction)	Последующий	Мерчант	Нет ручного ввода, мерчант передает данные	Нет
I	Рассрочка MIT (merchant initiated transaction)	Последующий	Мерчант	Нет ручного ввода, мерчант передает данные	Нет

billingPayerData

Параметры блока billingPayerData

Название	Тип	Обязательно	Описание
`billingCity`	AN..50	Нет	Город, зарегистрированный по конкретной карте у Банка Эмитента
`billingCountry`	AN..50	Нет
`billingAddressLine1`	AN..50	Нет	Адрес, зарегистрированный по конкретной карте у Банка Эмитента Строка 1. Обязательно, если у Мерчанта активирована пермиссия «Разрешено использование AVS/AVV».
`billingAddressLine2`	AN..50	Нет	Адрес, зарегистрированный по конкретной карте у Банка Эмитента Строка 2.
`billingAddressLine3`	AN..50	Нет	Адрес, зарегистрированный по конкретной карте у Банка Эмитента Строка 3.
`billingPostalCode`	AN..50	Нет	Почтовый индекс, зарегистрированный по конкретной карте у Банка Эмитента. Обязательно, если у Мерчанта активирована пермиссия «Разрешено использование AVS/AVV».
`billingState`	AN..50	Нет	Штат, зарегистрированный по конкретной карте у Банка Эмитента (ISO 3166-2)

shippingPayerData

Параметры блока shippingPayerData

Название	Тип	Обязательно	Описание
`shippingcity`	ANS…50	Нет	Город клиента (из адреса доставки).
`shippingCountry`	ANS…50	Нет	Страна клиента.
`shippingAddressLine1`	ANS…50	Нет	Основной адрес клиента (из адреса доставки).
`shippingAddressLine2`	ANS…50	Нет	Основной адрес клиента (из адреса доставки).
`shippingAddressLine3`	ANS…50	Нет	Основной адрес клиента (из адреса доставки).
`shippingPostalCode`	ANS…16	Нет	ZIP или иной почтовый индекс клиента для доставки.
`shippingState`	ANS…50	Нет	Штат/регион клиента (из адреса доставки).
`shippingMethodIndicator`	N2	Нет	Индикатор способа доставки. Перечень возможных значений: 01 - доставка на адрес держателя карты для выставления счета; 02 - доставка на другой адрес, проверенный Мерчантом; 03 - доставка на адрес, отличный от основного адреса держателя карты (расчетного); 04 - отправка в магазин/самовывоз (адрес магазина должен быть указан в соответствующих параметрах доставки); 05 - цифровая дистрибуция (включает онлайн сервисы и электронные подарочные карты); 06 - путешествия и билеты на события, не подлежащие доставке; 07 - иное (например, игры, цифровые товары, не подлежащие доставке, цифровые подписки и т.д.).
`deliveryTimeframe`	N2	Нет	Сроки доставки товара. Перечень возможных значений: 01 - цифровая дистрибуция; 02 - доставка в день оплаты; 03 - ночная доставка; 04 - доставка в интервал 2 дня после оплаты и позже.
`deliveryEmail`	ANS…254	Нет	Целевой адрес электронной почты для доставки цифровой дистрибуции.

orderPayerData

Параметры блока orderPayerData

Название	Тип	Обязательно	Описание
`homePhone`	ANS…19	Нет	Домашний телефон держателя карты, с обязательным символом «+».
`workPhone`	ANS…19	Нет	Рабочий телефон держателя карты, c обязательным символом «+».
`mobilePhone`	ANS…19	Нет	Мобильный телефон держателя карты, c обязательным символом «+».

preOrderPayerData

Параметры блока preOrderPayerData

Название	Тип	Обязательно	Описание
`preOrderDate`	ANS8	Нет	Ожидаемая дата, когда будет доступна доставка (для предварительно заказанных покупок), в формате YYYYMMDD.
`preOrderPurchaseInd`	N2	Нет	Индикатор размещения клиентом заказа на доступную или будущую доставку. Перечень возможных значений: 01 - доставка доступна; 02 - будущая доставка.
`reorderItemsInd`	N2	Нет	Индикатор того, что клиент выполняет переоформляет ранее оплаченную доставку в рамках нового заказа. Перечень возможных значений: 01 - заказ оформляет впервые; 02 - повторный заказ.

Параметры ответа

Параметры ответа представлены в таблице ниже.

Название	Тип	Обязательно	Описание
`success`	A..5	Да	Указывает на успешность запроса. Доступны следующие значения: `true` (истина) - запрос обработан успешно; `false` (ложь) - запрос не прошёл.
Блок `data` (возвращается, только если запрос прошёл успешно)
`orderId`	ANS36	Да	Номер заказа в платежной системе. Уникален в пределах системы. Отсутствует если регистрация заказа не удалась по причине ошибки, детализированной в ErrorCode.
Блок `error` (возвращается, только если запрос завершился с ошибкой)
`code`	N..2	Да	Код ошибки.
description	ANS..512	Да	Подробное техническое объяснение ошибки - содержимое этого параметра не предназначено для отображения пользователю.
`message`	AN..512	Да	Понятное описание ошибки - предназначено для отображения пользователю.

Коды ошибок

Код ошибки	Текст ошибки
0	Обработка запроса прошла без системных ошибок.
1	Недостаточно средств на карте.
5	Доступ запрещён.
5	Пользователь должен сменить свой пароль.
7	Системная ошибка.
10	Некорректное значение параметра `[paymentToken]`.
10	Некорректное значение параметра `[orderNumber]`.
10	Некорректное значение параметра `[merchant]`.
10	Некорректное значение параметра `[ip]`.
10	Некорректное значение параметра `[paymentToken.header]`.
10	Расшифровка переданных данных неуспешна.

Пример запроса POST

{
    "merchant": "OurBestMerchantLogin",
    "orderNumber": "UAF-203974-DE",
    "language": "RU",
    "preAuth": true,
    "description" : "Test description",
    "additionalParameters":
    {
        "firstParamName": "firstParamValue",
        "secondParamName": "secondParamValue"
    },
    "paymentToken": "ew0KICB7DQoJICAidmVyc2lvbiI6ICJSU0FfdjEiLA0KCSAgInNpZ25hdHVyZSI6ICJabUZyWlNCemFXZHVZWFIxY21VPSIsDQoJICAiaGVhZGVyIjogew0KCQkiZXBoZW1lcmFsUHVibGljS2V5IjogIk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRW14Q2hDcGpLemY5YVh6MjZXVDZaVE4yekUzaUdYUWpjWlJZWUFkUUlURFgyUmtBTmJ0N2s5cmFoRjFoempqbWVWVHhjZ0NvZkg4MXprMkdOVFozZHRnPT0iICAgICAgIA0KCQkid3JhcHBlZEtleSI6ICJYejI2V1Q2WlROMnpFM2lHWFFqYz0iDQoJCSJwdWJsaWNLZXlIYXNoIjogIk9yV2dqUkdrcUVXamRrUmRVclhmaUxHRDBoZS96cEV1NTEyRkpXckdZRm89IiwNCgkJInRyYW5zYWN0aW9uSWQiOiAiYXBwbGUtMTIzNDU2Nzg5MEFCQ0RFRiINCgkgIH0sDQoJICAiZGF0YSI6ICIxZFhFMTNrdnpUVlA2bldFTjhEMnBoclBsZlFjR3I4VzN5ajJTSFlZai9QeWNIV1RqbnBWN3ovRXI3OGJyaT09Ig0KICB9DQp9",
    "ip" : "127.0.0.1"
}

Пример ответа

Успешная оплата

{
"success":true,
"data": {
    "orderId": "12312312123"
  }
}

Неуспешная оплата

{
  "error": {
    "code": 1,
    "description": "Processing Error",
    "message": "Недостаточно средств на карте"
  },
  "success": false
}

Инструменты страницы