Введение

Основные вопросы

• •

  Кто обязан пробивать чеки Банк или магазин? — Обязанность пробивать чеки накладывается на ТСП (Торгово-Сервисное Предприятие).

• •

  Я не знаю, нужна ли мне касса — Проверить, нужно ли использовать кассу можно здесь (нажав на кнопку «Нужна ли мне касса»)

• •

  Что нужно сделать для того, чтобы все работало? — Для корректной работы необходимо арендовать или приобрести кассу, заключить договор с ОФД, зарегистрировать кассу в ФНС, передавать информацию о каждой покупке.

• •

  Можно ли пробивать чеки по интернет-платежам на кассе, которая стоит у меня в магазине? — Да, если она зарегистрирована в реестре ККТ и может использоваться для интернет платежей, при этом в случае совершения оплаты в интернете чек должен быть направлен клиенту в течение 5 минут с момента оплаты.

• •

  У меня касса «Штрих-М», «АТОЛ» (кроме АТОЛ 42-ФС). Могу ли я подключить ее к вашему интернет эквайрингу? — У нас нет интеграции с данными кассами. Вы можете использовать наш интернет эквайринг и пробивать чеки на любой кассе, но для этого вам придется сделать интеграцию своих систем самостоятельно. Исключением является подключение интернет эквайринга через нашего партнера PayKeeper. На сайте https://paykeeper.ru/paykeeper/54-fz-internet-magazin/ указаны типы касс, с которыми у них реализовано подключение. Если Ваша касса присутствует в этом списке, то вам будет лучше реализовать интеграцию через PayKeeper.

• •

  Как формировать фискальные чеки (фискализация) при приёме оплат в иностранной валюте? — На территории Российской Федерации действует ФЗ-54, согласно которому все кассовое оборудование работает только с российскими рублями. Заказы оплаченные в иностранной валюте не фискализируются. Для оформления чека по оплатам в иностранной валюте необходима конвертация, но на текущий момент платежный шлюз не поддерживает конвертацию. Для оформления чеков по валютным транзакциям, вам потребуется провести интеграцию Вашего ресурса с выбранной облачной кассой напрямую, данный способ подключения позволит конвертировать валютные транзакции.

• •

  Что такое признак предмета расчета? — Все пользователи контрольно-кассовой техники обязаны указывать наименование предмета расчета (за что взымается оплата). В зависимости от вашей деятельности предметы расчета у всех разные. Кто-то оказывает услуги, кто-то продает товары, а кто-то принимает платежи. Для того, чтобы определить, за что вы приняли деньги у Покупателя, ФНС предусмотрела указание признака предмета расчета. Пример: Если вы оказали услугу и оформили кассовый чек, в котором признак предмета расчета у услуги был установлен «ТОВАР» — такой чек может быть признан как «оформленный с нарушением».

• •

  Что такое признак способа расчета? — Еще один немаловажный реквизит предмета расчета — признак способа расчета. Этот реквизит определяет передачу предмета расчета в момент расчета. Простыми словами — современный кассовый чек отражает не только факт получения оплаты, но и факт передачи предмета расчета (товара, услуги, работы и т. п.). За факт фиксации передачи предмета расчета и факт оплаты отвечает реквизит признак способа расчета. Данный реквизит является обязательным, за исключением значения «ПОЛНЫЙ РАСЧЕТ». Пример: вы приняли предоплату за предмет расчета (конкретный товар), который однозначно определен в момент расчета (когда покупатель оплатил за него деньги). В этом случае вы отбиваете кассовый чек, в котором в предмете расчета указываете признак способа расчета «ПРЕДОПЛАТА 100%». Кассовый чек с таким признаком расчета указывает, что вы приняли оплату, но товар не передали. После передачи товары вам необходимо отправить закрывающий чек. Это можно сделать в личном кабинете интернет эквайринга в деталях по транзакции. На платежном шлюзе присутствуют следующие признаки способа расчета:

  • •

    Предоплата 100% — Полная предварительная оплата до момента передачи предмета расчета

  • •

    Частичная предоплата — Частичная предварительная оплата до момента передачи предмета расчета

  • •

    Аванс — Аванса за товар, характеристики которого к тому моменту не определены (например, если куплена подарочная карта)

  • •

    Полный расчет — Полная оплата, в том числе с учетом предоплаты или аванса (предварительной оплаты) в момент передачи предмета расчета

Возможности платежного шлюза

Платёжный шлюз позволяет принимать оплату по заказам, содержащих информацию о Корзине. Корзина предоставляет собой детализацию Заказа по товарным позициям, по которым производится оплата в рамках одного Заказа.
В запросе на регистрацию заказа также передаются данные, необходимые для формировании кассового чека.
Если вы выберите ecom-кассу от наших партнеров, то вся нужная информация будет передана в ОФД и в налоговую, согласно тербованиям ФЗ-54

Порядок действий для подключения ecom-кассы

Для стандартного интернет-эквайринга передать информацию по корзине в кассу можно 2 способами:

• •

  использовать плагин, поддерживающий ФЗ-54

• •

  обеспечить передачу параметров для чека по API

Для способов подключения «Выставление ссылки на оплату» и «Конструктор формы оплаты»: Передача информации в кассу для пробития чека обеспечивается настройками в Личном Кабинете.

Инструкция по настройке фискализации: Инструкция

Вместе с этим, необходимо выбрать партнера: Ниже представлены льготные расценки партнеров для клиентов Альфа-Банка.

В случае подписания индивидуального договора:

Для включения сервиса Е-Ком касса необходимо заключить дополнительное соглашение с банком: Дополнительное соглашение

Инструкция по заполнению дополнительного соглашения: Инструкция по заполнению дополнительного соглашения

FAQ

Помощь в процессе подключения: Обращайтесь в службу сопровождения emcsupport@alfabank.ru и ers@alfabank.ru

Куда отправить подписанное доп. соглашение:

• •

  Курьерской службой: ОАО «Альфа-Банк» г. Москва, проспект Андропова, д. 18, корпус 3 Колдаеву Алексею

• •

  Почтой РФ: ОАО «Альфа-Банк», 107 078 Москва, ул. Каланчевская д. 27 Колдаеву Алексею

Нужна тестовая среда: Обращайтесь в службу сопровождения тестовой среды: ers@alfabank.ru

Презентация: Скачать

Требования к запросам

Требования к формированию запросов регистрации заказа с Корзиной

В запросах на регистрацию заказа (с предавторизацией или без) Корзина товаров передаётся в параметре .

• •

  Все товарные позиции Корзины должны быть выражены в одной и той же валюте (если валюта позиции указывается), и должны совпадать с валютой Заказа.

• •

  Сумма всех товарных позиций Корзины должна быть равна сумме Заказа;

• •

  По каждой товарной позиции производится проверка переданного значения . В случае если значение слишком большое или слишком маленькое, то запрос завершается ошибкой.

• •

  Все параметры Корзины валидируются на соответствие требуемому формату (длине). В случае невыполнения хотя бы одного из указанных выше условий Заказ считается неправильно сформированным и Платёжный шлюз возвращает ошибку.

Требования к формированию запросов завершения заказа с Корзиной

При завершении заказов Корзина передаётся в элементе .

• •

  В случае завершения на полную предавторизованную сумму передача Корзины необязательна.

• •

  Сумма завершения в Корзине не должна превышать предавторизованную денежную сумму заказа.

• •

  При завершении заказа на сумму отличную от суммы предавторизации (кроме передачи значения «0») обязательно должна передаваться Корзина товаров.

• •

  Все товарные позиции Корзины должны быть выражены в одной и той же валюте (если валюта позиций указывается), и должны совпадать с валютой оригинального Заказа.

• •

  В Корзине запрещены для передачи новые товарные позиции, отсутствующие в оригинальном заказе. Происходит проверка наличия указанного товара в Корзине запроса на завершение в изначальном заказе. Необходимо совпадение элементов , , . Если хотя бы одно из значений не совпадает, считается, что данная товарная позиция отсутствует в Корзине заказа на регистрацию.

• •

  Значение элемента в Корзине запроса на завершение не должно превышать значение аналогичного параметра в Корзине заказа на регистрацию.

• •

  Значение элемента блока не должно превышать значение аналогичного параметра в оригинальном заказе.

• •

  По каждой товарной позиции производится проверка переданного значения . В случае если значение слишком большое или слишком маленькое, то запрос завершается ошибкой.

• •

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

Требования к формированию запросов возврата заказа с Корзиной

В запросе на возврат Корзина указывается в блоке .

• •

  В случае полного возврата Заказа, передача Корзины товаров необязательна.

• •

  При возврате заказа на сумму отличную от суммы списания (кроме передачи значения «0») обязательно должна передаваться Корзина товаров.

• •

  В случае проведения нескольких возвратов по заказам с Корзиной, все они должны осуществляться только по алгоритму возврата с Корзиной.

• •

  Сумма возврата в Корзине не должна превышать подтверждённую денежную сумму оригинального заказа.

• •

  Все товарные позиции Корзины должны быть выражены в одной и той же валюте (если валюта позиций указывается), совпадающей с валютой оригинального Заказа.

• •

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

• •

  Значение элемента в Корзине запроса на завершение не должно превышать значение аналогичного параметра в Корзине заказа на регистрацию.

• •

  Значение элемента блока не должно превышать значение аналогичного параметра в оригинальном заказе.

• •

  Все параметры Корзины валидируются на соответствие требуемому формату (длине). В случае невыполнения хотя бы одного из указанных выше условий, запрос возврата заказа считается неправильно сформированным и Платёжный шлюз должен вернуть ошибку.

Схемы взаимодействия при использовании различных видов оплаты

Одностадийная оплата

Двухстадийная оплата

Интерфейс REST

Запрос регистрации заказа (REST)

Для регистрации заказа в схеме приёма платежа на стороне платёжной системы используется запрос register.do — см. раздел Координаты подключения.
Товарная Корзина передаётся в параметре orderBundle.
Раздел Требования к формированию запросов регистрации заказа с Корзиной содержит список условий, необходимых для корректного формирования запроса.
Примечание Если в запросе на оплату не передаётся корзина с данными фискализации, оператору фискальных данных передаются значения по умолчанию, указанные в настройках личного кабинета (подробнее см. инструкцию по работе с личным кабинетом).

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

{«<name1>«:»<value1>»,...,"<nameN>":"<valueN>"}

Примечание По умолчанию в процессинг банка передаются поля:

• •

  orderNumber — номер заказа в системе магазина;

• •

  description — описание заказа (не более 99 символов, запрещены к использованию %, +, конец строки \r и перенос строки \n). Если в заказе передать дополнительный параметр с именем merchantOrderId, то именно его значение будет передано в процессинг в качестве номера заказа (вместо значения поля orderNumber).

Параметры блока orderBundle:
Примечание Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.*

Параметры блока agent:

Параметры блока customerDetails:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметры блока deliveryInfo:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметры блока cartItems:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметры блока, входящего в состав items:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметры блока itemAttributes:

Атрибуты следует указывать следующим образом

"itemAttributes":{"attributes":[{"name":"paymentMethod","value":"1"},{"name":"paymentObject","value":"1"}]}

Параметры блока quantity:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметры блока itemDetails:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметры блока, входящего в состав itemDetailsParams:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметры блока discount:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметры блока agentInterest:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметры блока tax:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

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

Коды ошибок (поле errorCode):

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

1amount=24000&
2currency=643&
3language=ru&
4orderNumber=04f04a87d6f4а5rg3r3d21&
5returnUrl=https://alfa.rbsuat.com/payment/merchants/ecom2/finish.html&
6jsonParams={"name1":"value1"}&
7sessionTimeoutSecs=5400&
8merchantLogin=merch_child&
9taxSystem=0&
10
11orderBundle=
12{ 
13
14"orderCreationDate":"2013-07-12T13:51:00",  
15
16"customerDetails":{ "email":"email@email.com", "phone":"79851231234", "contact": "Mega  Tester","deliveryInfo":{ "deliveryType":"courier", "country":"RU",  "city":"Moscow",
17"postAddress":"Земляной Вал 50А стр.2" }},  
18
19"cartItems":  
20
21{ "items": 
22
23[ 
24{ "positionId": "1",
25"name": "Metzeler Enduro 3 Sahara", 
26"itemDetails": { "itemDetailsParams":[{ "value": "Metzeler ", "name": "brand" }, { "value": "17inch", "name": "radius" }]},
27"quantity": { "value": 0.71, "measure": "штук" }, 
28"itemAmount": 8000, 
29"itemCurrency": "643",
30"itemCode": "NM-15", 
31"discount": { "discountType": "percent", "discountValue": "5" },
32"agentInterest": { "interestType": "agentPercent", "interestValue": "7" }, 
33"tax": {"taxType": 1,"taxSum": 111}, 
34"itemPrice": 11267
35},
36
37{ "positionId": "2", 
38"name": "Universal Mirror Enduro", 
39"itemDetails": { "itemDetailsParams":[{ "value": "Noname", "name": "brand" }, { "value": "12mm", "name": "diameter" }]},
40"quantity": { "value": 1.0, "measure": "штук" }, 
41"itemAmount": 8000, 
42"itemCurrency": "643",
43"itemCode": "NM-15", 
44"discount": { "discountType": "percent", "discountValue": "5" },
45"agentInterest": { "interestType": " agentPercent ", "interestValue": "7" }, 
46"tax": {"taxType": 1,"taxSum": 111}, 
47"itemPrice": 8000 
48},
49
50{ "positionId": "3", 
51"name": "Warm Grips", 
52"itemDetails": { "itemDetailsParams":[ { "value": "Noname", "name": "brand" }]},  "quantity": { "value": 1.0, "measure": "штук" },
53"itemAmount": 8000, 
54"itemCurrency": 643, 
55"itemCode": "G-16",
56"discount": { "discountType": "percent", "discountValue": "5" },
57"agentInterest": { "interestType": " agentPercent ", "interestValue": "7" }, 
58"tax": {"taxType": 1,"taxSum": 111}, 
59"itemPrice": 8000 
60}
61] 
62
63} 
64
65}

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

{"formUrl":"https://alfa.rbsuat.com/payment/merchants/ecom2/payment_ru.html?
mdOrder=ece47318-19f2-466a-93cd-bdb08c1587ec","orderId":"ece47318-19f2-466a-93cd-bdb08c1587ec"}

Запрос регистрации заказа с предавторизацией (REST)

Для регистрации заказа с предавторизацией используется запрос registerPreAuth.do — см. раздел «Координаты подключения». Товарная Корзина передаётся в параметре orderBundle.
Раздел Требования к формированию запросов регистрации заказа с Корзиной содержит список условий, необходимых для корректного формирования запроса.
Примечание Если в запросе на оплату не передаётся корзина с данными фискализации, оператору фискальных данных передаются значения по умолчанию, указанные в настройках личного кабинета (подробнее см. инструкцию по работе с личным кабинетом).
Параметры запроса:

{«<name1>«:»<value1>»,...,"<nameN>":"<valueN>"}

По умолчанию в процессинг банка передаются поля:

• •

  orderNumber — номер заказа в системе магазина;

• •

  description — описание заказа (не более 99 символов, запрещены к использованию %, +, конец строки \r и перенос строки \n). Если в заказе передать дополнительный параметр с именем merchantOrderId, то именно его значение будет передано в процессинг в качестве номера заказа (вместо значения поля orderNumber).

Параметр orderBundle:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметр agent:

Параметры блока customerDetails:

Параметры блока deliveryInfo:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметры блока cartItems:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Атрибуты элемента items:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметры тэга itemAttributes: Атрибуты следует указывать следующим образом

"itemAttributes":{"attributes":[{"name":"paymentMethod","value":"1"},{"name":"paymentObject","value":"1"}]}

Атрибуты элемента quantity:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметры блока  itemDetails:

Атрибуты параметра itemDetailsParams:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметры блока discount:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметры блока agentInterest:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметры блока tax:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

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

Коды ошибок (поле errorCode):

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

1amount=24000&
2currency=643&
3language=ru&
4orderNumber=01a287222222299&
5returnUrl=https://alfa.rbsuat.com/payment/merchants/ecom2/finish.html&
6jsonParams={"name1":"value1"}&
7merchantLogin=merch_child&
8taxSystem=0&
9
10orderBundle=
11{ 
12
13"orderCreationDate":"2013-07-12T13:51:00",
14
15"customerDetails":{ "email":"email@email.com", "phone": "79851231234","contact": "Mega  Tester", "deliveryInfo":{ "deliveryType":"courier", "country":"RU",  "city":"Moscow",
16"postAddress":"Земляной Вал 50А стр.2" }},
17
18"cartItems":  
19
20{ "items": 
21
22[  
23{ "positionId": "1", 
24"name": "Metzeler Enduro 3 Sahara",
25"itemDetails": { "itemDetailsParams": [{ "value": "Metzeler ", "name": "brand" },
26{ "value": "17inch", "name": "radius" }]}, 
27"quantity": { "value": 0.71, "measure": "штук" },
28"itemAmount": 8000, 
29"itemCurrency": "643", 
30"itemCode": "NM-15",
31"discount": { "discountType": "percent", "discountValue": "5" },
32"agentInterest": { "interestType": "agentPercent", "interestValue": "7" }, 
33"tax": {"taxType": 1,"taxSum": 111}, 
34"itemPrice": 11267
35},
36
37{ "positionId": "2", 
38"name": "Universal Mirror Enduro",
39"itemDetails": { "itemDetailsParams": [{ "value": "Noname", "name": "brand" },
40{ "value": "12mm", "name": "diameter" }]}, 
41"quantity": { "value": 1.0, "measure": "штук" },
42"itemAmount": 8000, 
43"itemCurrency": "643", 
44"itemCode": "NM-15",
45"discount": { "discountType": "percent", "discountValue": "5" },
46"agentInterest": { "interestType": " agentPercent ", "interestValue": "7" }, 
47"tax": {"taxType": 1,"taxSum": 111}, 
48"itemPrice": 8000 
49},
50
51{ "positionId": "3", 
52"name": "Warm Grips",
53"itemDetails": { "itemDetailsParams": [ { "value": "Noname", "name": "brand" }]},
54"quantity": { "value": 1.0, "measure": "штук" }, 
55"itemAmount": 8000, 
56"itemCurrency": 643,
57"itemCode": "G-16", 
58"discount": { "discountType": "percent", "discountValue": "5" },
59"agentInterest": { "interestType": " agentPercent ", "interestValue": "7" }, 
60"tax": {"taxType": 1,"taxSum": 111}, 
61"itemPrice": 8000 
62}
63] 
64
65} 
66
67}

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

{"formUrl":"https://alfa.rbsuat.com/payment/merchants/ecom2/payment_ru.html?mdOrder=fc122907-e237-440e-9f25-48bf6120984b","orderId":"fc122907-e237-440e-9f25-48bf6120984b"}

Запрос завершения на полную сумму предавторизации (REST)

Для запроса списания полной суммы предавторизации используется запрос deposit.do. Данная операция доступна пользователям, обладающим соответствующими правами в системе.

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

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

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

Коды ошибок (поле errorCode):

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

currency=643&language=ru&orderId=f57db9df-5885-483d-8d5e-8e592d60ec9d&amount=0

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

{"errorCode":"0","errorMessage":"Успешно"}

Завершение на частичную сумму предавторизации (REST)

Для запроса списания частичной суммы предавторизации используется запрос deposit.do.
Данная операция доступна пользователям, обладающим соответствующими правами в системе. Раздел Требования к формированию запросов завершения заказа с Корзиной содержит список условий, необходимых для корректного формирования запроса.

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

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

Параметры блока depositItems:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Атрибуты элемента items:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметры тэга itemAttributes: Атрибуты следует указывать следующим образом

<attributes  name="название_атрибута_2">значение_атрибута_2</attributes>

Параметры блока quantity:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметры блока itemDetails:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметры блока, входящего в состав itemDetailsParams:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметры блока discount:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметры блока agentInterest:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметры блока tax:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

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

Коды ошибок (поле errorCode):

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

1orderId=9659c922-f0fa-4b4f-9b09-8a754ad99c63&
2amount=4441&
3depositItems=
4{"items": 
5
6[
7{ "positionId": "2", 
8"name": "Universal Mirror Enduro",
9"itemDetails": { "itemDetailsParams": [{ "value": "Noname", "name": "brand" },{"value": "12mm", "name": "diameter" }]}, 
10"quantity": { "value": 1.0, "measure": "штук" },
11"itemAmount": 3330, 
12"itemCurrency": "643", 
13"itemCode": "NM-15",
14"discount": { "discountType": "percent", "discountValue": "5" },
15"agentInterest": { "interestType": " agentPercent ", "interestValue": "7" }, 
16"tax": {"taxType": 1,"taxSum": 111}, 
17"itemPrice": 3330
18},
19
20{ "positionId": "3", 
21"name": "Warm Grips",
22"itemDetails": { "itemDetailsParams": [ { "value": "Noname", "name": "brand" }]},
23"quantity": { "value": 1.0, "measure": "штук" }, 
24"itemAmount": 1111, 
25"itemCurrency": 643,
26"itemCode": "G-16", 
27"discount": { "discountType": "percent", "discountValue": "5" },
28"agentInterest": { "interestType": " agentPercent ", "interestValue": "7" }, 
29"tax": {"taxType": 1,"taxSum": 111},
30"itemPrice": 1111
31}
32] 
33
34}

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

{"errorCode":"0","errorMessage":"Success"}

Запрос отмены оплаты заказа (REST)

Для отмены оплаты заказа используется запрос reverse.do. Функция отмены доступна в течение ограниченного времени после оплаты, точные сроки необходимо уточнять в Банке.
Операция отмены оплаты может быть совершена только один раз. Если она закончится ошибкой, то повторная операция отмены платежа не пройдет.
Данная функция доступна магазинам по согласованию с Банком. Для выполнения операции отмены пользователь должен обладать соответствующими правами.
Параметры запроса:

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

Коды ошибок (поле ErrorCode):

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

language=ru&orderId=9231a838-ac68-4a3e-bddb-d9781433d852

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

{"errorCode":"0","errorMessage":"Успешно"}

Запрос полного возврата средств оплаты заказа (REST)

Для запроса полного возврата средств оплаты используется запрос refund.do. По этому запросу средства по указанному заказу будут возвращены плательщику. Запрос закончится ошибкой в случае, если средства по этому заказу не были списаны. Данная операция доступна пользователям, обладающим соответствующими правами в системе. Параметры запроса:

{«<name1>«:»<value1>»,...,"<nameN>":"<valueN>"}

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

Коды ошибок (поле errorCode):

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

language=ru&orderId=c84105aa-0713-44e1-ae3b-4c5e09d49a7d&jsonParams={"name1":"value1"}&amount=24000

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

{"errorCode":"0","errorMessage":"Успешно"}

Запрос частичного возврата средств оплаты заказа (REST)

Для частичного возврата средств оплаты заказа  используется запрос refund.do.
Данная операция доступна пользователям, обладающим соответствующими правами в системе.
Примечание Для безошибочной обработки запроса достаточно передать параметры quantity и positionId.

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

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

{«<name1>«:»<value1>»,...,"<nameN>":"<valueN>"}

Параметры блока refundItems:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметры блока, входящего в состав items:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметры тэга itemAttributes: Атрибуты следует указывать следующим образом

<attributes  name="название_атрибута_1">значение_атрибута_1</attributes>
<attributes  name="название_атрибута_2">значение_атрибута_2</attributes>

Параметры блока quantity:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметры блока itemDetails:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметры блока, входящего в состав itemDetailsParams:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметры блока discount:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметры блока agentInterest:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

Параметры блока tax:
Обязательность параметров указана для использования в рамках блока. Если блок необязательный и в запросе отсутствует, то и входящие в него параметры не должны передаваться.

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

Коды ошибок (поле errorCode)

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

1language=ru&
2orderId=830603cd-a886-483a-9a23-c37fb8018096&
3jsonParams={"name1":"value1"}&
4amount=9000&
5refundItems=
6{"items": 
7
8[  
9{ "positionId": "2", 
10"name": "Universal Mirror Enduro", 
11"itemDetails":{ "itemDetailsParams": [{"value": "Noname", "name": "brand"}, {"value": "12mm", "name": "diameter" }]},
12"quantity": { "value": 1.0, "measure": "штук" },
13"itemAmount": 6000, 
14"itemCurrency": "643", 
15"itemCode": "NM-15",
16"discount": { "discountType": "percent", "discountValue": "5" },
17"agentInterest": { "interestType": " agentPercent ", "interestValue": "7" }, 
18"tax": {"taxType": 1,"taxSum": 111}, 
19"itemPrice": 6000
20},
21
22{ "positionId": "3", 
23"name": "Warm Grips", 
24"itemDetails": { "itemDetailsParams":[ { "value": "Noname", "name": "brand" }]}, 
25"quantity": { "value": 1.0, "measure": "штук" },
26"itemAmount": 3000, 
27"itemCurrency": 643, 
28"itemCode": "G-16",
29"discount": { "discountType": "percent", "discountValue": "5" },
30"agentInterest": { "interestType": " agentPercent ", "interestValue": "7" }, 
31"tax": {"taxType": 1,"taxSum": 111}, 
32"itemPrice": 3000
33}
34] 
35
36}

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

{"errorCode":"0","errorMessage":"Успешно"}

Запрос сведений о кассовом чеке (REST)

Для получения сведений о чеках по заказу используется запрос getReceiptStatus.do.В запросе могут передаваться следующие данные: *идентификатор заказа — orderId или orderNumber;

• •

  идентификатор чека — uuid. Если передан идентификатор заказа (orderId или orderNumber), ответ возвращает все чеки данного заказа. При передаче только идентификатора чека ответ возвращает сведения только о данном чеке. Если указаны и идентификатор заказа, и чека, ответ возвращает все чеки заказа.
  Параметры запроса

Параметры ответа
Примечание Некоторые возвращаемые параметры могут зависеть от используемого оператора фискальных данных.

Атрибуты блока Receipt представлены в таблице ниже.

Атрибуты блока OFD представлены в таблице ниже.

Коды ошибок В таблице ниже представлены коды и сообщения ошибок.

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

https://alfa.rbsuat.com/payment/rest/getReceiptStatus.do?userName=login-api&password=password&orderId=abd60d0c-e096-42c3-8b17-6081c67db214

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

{"errorCode»:"0»,"orderNumber»:"220170606034051002_177»,"orderId»:"abd60d0c-e096-42c3-8b17-6081c67db214»,"receipt»: [{"receiptStatus»: 1,"uuid»:"790925e5-739c-430c-9e92-79d9f14481a4»,"shift_number»:"27»,"fiscal_receipt_number»:"21»,"receipt_date_time»: 1499256900000,"fn_number»:"9999078900006364»,"ecr_registration_number»:"1234567890023481»,"fiscal_document_number»:"21»,"fiscal_document_attribute»:"3713381819»,"amount_total»: 10000}]}

Расширенный запрос состояния заказа (REST)

Для запроса состояния зарегистрированного заказа используется запрос getOrderStatusExtended.do.
Параметры запроса

Примечание В запросе должен присутствовать либо orderId, либо orderNumber. Если в запросе присутствуют оба параметра, то приоритетным считается orderId. Существует несколько наборов параметров ответа. Какие именно наборы параметров будут возвращены, завит от версии getOrderStatusExtended, указанной в настройках продавца.

Элемент merchantOrderParams — присутствует в ответе, если в заказе содержатся дополнительные параметры продавца. Каждый дополнительный параметр заказа представлен в отдельном элементе merchantOrderParams.

Элемент cardAuthInfo — в элементе лежит структура, состоящая из списка элемента secureAuthInfo и следующих параметеров:

Элемент secureAuthInfo (элемент состоит из элемента eci и элемента threeDSInfo, являющимся списком параметров cavv и xid):

Элемент bindingInfo состоит из параметров:

Элемент paymentAmountInfo состоит из параметров:

Элемент bankInfo состоит из параметров:

Содержимое orderBundle

Содержимое customerDetails

Содержимое cartItems

Содержимое items

Содержимое quantity

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

orderId=b9054496-c65a-4975-9418-1051d101f1b9&language=ru&merchantOrderNumber=0784sse49d0s134567890

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

{"errorCode»:"0»,"errorMessage»:"Успешно»,"orderNumber»:"220170606034051002_28»,"orderStatus»: 2,"actionCode»: 0,"actionCodeDescription»:»»,"amount»: 52500,"currency»:"643»,"date»: 1499343399327,"depositedDate»: 1499343424170,"orderDescription»:»»,"ip»:"127.0.0.1»,"merchantOrderParams»: [],"attributes»: [{"name»:"mdOrder»,"value»:"467db186-3aaf-4ba1-a66d-403bdde6c86f"}],"cardAuthInfo»: {"expiration»:"202012»,"cardholderName»:"test»,"approvalCode»:"123456»,"paymentSystem»:"VISA»,"pan»:"411111**1111"},"authDateTime»: 1499343423166,"terminalId»:"123456»,"authRefNum»:"111111111111»,"paymentAmountInfo»: {"paymentState»:"DEPOSITED»,"approvedAmount»: 52500,"depositedAmount»: 52500,"refundedAmount»: 0,"feeAmount»: 0},"bankInfo»: {"bankName»:"test»,"bankCountryCode»:"RU»,"bankCountryName»:"Россия"},"orderBundle»: {"customerDetails»: {"email»:"test@test.ru»,"phone»:"79998887766"},"cartItems»: {"items»: [{"positionId»:"1»,"name»:"name»,"quantity»: {"value»: 1.0,"measure»:"me"},"itemAmount»: 52500,"depositedItemAmount»: 52500,"itemCurrency»: 643,"itemCode»:"1246754788"}]}},"chargeback»: false,"paymentWay»:"CARD"}

Координаты подключения

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

Учётные данные для тестирования фискализации (ОФД Orange Data)

Для тестирования функциональности фискализации через оператор фискальных данных Orange Data в личном кабинете платёжного шлюза используйте следующие учётные данные:

• •

  ИНН — 7728168971;

• •

  Группа — 1. В тестовом личном кабинете ОФД-Такском вы можете проверить наличие фискального чека после успешной операции:

• •

  URL-адрес — https://tlk-ofd.taxcom.ru/

• •

  Логин — ers@alfabank.ru;

• •

  Пароль — AlfaEcom20