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

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

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

  • 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.

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

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

Название Тип Обязательно Описание

orderId

ANS36

Да
(см. примечание ниже)

Номер заказа в платежной системе. Уникален в пределах системы. Отсутствует, если регистрация заказа не удалась по причине ошибки, детализированной в errorCode.

merchantOrderNumber

ANS..32

Да
(см. примечание ниже)

Номер (идентификатор) заказа в системе магазина.

language

A2

Нет

Язык в кодировке ISO 639-1. Если не указан, будет использован язык, указанный в настройках магазина как язык по умолчанию.

Необходимо передать или параметр orderId, или merchantOrderNumber. Если в запросе передаются оба параметра, приоритет orderId выше.

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

Существует три набора параметров ответа. Какие именно наборы параметров будут возвращены, завит от версии getOrderStatusExtended, указанной в настройках продавца. Эти параметры будут возвращены в ответе независимо от версии getOrderStatusExtended.

Название Тип Обязательно Описание Версия getOrderStatusExtended

orderNumber

ANS..32

Да

Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы - до 30 символов. Если номер заказа генерируется на стороне платёжного шлюза, этот параметр передавать необязательно.

Все версии.

orderStatus

N1

Нет

По значению этого параметра определяется состояние заказа в платёжной системе. Отсутствует, если заказ не был найден. Ниже представлен список возможных значений:

  • 0 - заказ зарегистрирован, но не оплачен;
  • 1 - предавторизованная сумма удержана (для двухстадийных платежей);
  • 2 - проведена полная авторизация суммы заказа;
  • 3 - авторизация отменена;
  • 4 - по транзакции была проведена операция возврата;
  • 5 - инициирована авторизация через сервер контроля доступа банка-эмитента;
  • 6 - авторизация отклонена.
Все версии.

actionCode

ANS..6

Да

Код ответа процессинга. Полный перечень кодов ответов процессинга и расшифровки этих кодов размещены на отдельной странице.

Все версии.

actionCodeDescription

AN..512

Да

Расшифровка actionCode, возвращённая процессингом. Полный перечень кодов ответов процессинга и расшифровки этих кодов размещены на отдельной странице.

Все версии.

errorCode

N..2

Нет

Код ошибки.

Все версии.

errorMessage

AN..512

Нет

Описание ошибки на языке, переданном в параметре language в запросе.

Все версии.

amount

N..12

Да

Сумма платежа в минимальных единицах валюты.

Все версии.

currency

N3

Нет

Код валюты платежа ISO 4217. Если не указано, то используется значение по умолчанию.

Все версии.

date

ANS

Да

Дата регистрации заказа в формате UNIX-времени (POSIX-времени).

Все версии.

depositedDate

N

Нет

Дата оплаты заказа в формате UNIX-времени (POSIX-времени).

Все версии.

orderDescription

ANS..600

Нет

Описание заказа, переданное при его регистрации.

Все версии.

ip

ANS..39

Да

IP-адрес покупателя. IPv6 поддерживается во всех запросах (до 39 символов).

Все версии.

authRefNum

AN..24

Нет

Учётный номер авторизации платежа, который присваивается при регистрации платежа.

Все версии.

refundedDate

ANS

Нет

Дата и время возврата средств.

Все версии.

paymentWay

AS..14

да

Способ совершения платежа (платёж в с вводом карточных данных, оплата по связке и т. п.). Может принимать следующие значения:

  • CARD - оплата с вводом карточных данных;
  • CARD_BINDING - оплата связкой;
  • CARD_MOTO - оплата через колл-центр;
  • CARD_PRESENT - оплата как cardPresent;
  • SBRF_SBOL - оплата через Сбербанк Онлайн;
  • SBRF_SBOL_BINDING - оплата через связку Сбербанк Онлайн;
  • UPOP - оплата через China Union Pay;
  • FILE_BINDING - оплата через файл;
  • FILE_SBP_C2B_BINDING - СБП оплата через файл;
  • SMS_BINDING - оплата через смс;
  • P2P - перевод с карты на карту;
  • P2P_BINDING - перевод связкой;
  • PAYPAL - оплата со счёта PayPal;
  • MTS - оплата со счёта МТС;
  • APPLE_PAY - Apple Pay;
  • APPLE_PAY_BINDING - оплата связкой Apple Pay;
  • APPLE_PAY_RAW - оплата Apple Pay с данными по связке на стороне мерчанта (инициирующие и последующие платежи);
  • ANDROID_PAY - Android Pay;
  • ANDROID_PAY_BINDING - оплата связкой Android Pay;
  • GOOGLE_PAY_CARD - Google Pay нетокенизированная;
  • GOOGLE_PAY_RAW - оплата Google Pay с данными по связке на стороне мерчанта (инициирующие и последующие платежи);
  • GOOGLE_PAY_CARD_BINDING - оплата связкой с не токенизированной картой GooglePay;
  • GOOGLE_PAY_TOKENIZED - Google Pay токенизированная;
  • GOOGLE_PAY_TOKENIZED_BINDING - оплата связкой с токенизированной картой GooglePay;
  • SAMSUNG_PAY - Samsung Pay;
  • SAMSUNG_PAY_BINDING - оплата связкой Samsung Pay;
  • SAMSUNG_PAY_RAW - оплата Samsung Pay с данными по связке на стороне мерчанта (инициирующие и последующие платежи);
  • IPOS - оплата iPOS;
  • SBERID - оплата SberID;
  • SENDY - оплата Sendy;
  • SBP_C2B - Оплата СБП (Сервис Быстрых платежей) для C2B;
  • SBP_C2B_BINDING - оплата связкой СБП (Сервис Быстрых Платежей) для C2B;
  • SBP_B2C - выплаты СБП;
  • TOKEN_PAY - оплата токеном напрямую;
  • TOKEN_PAY_BINDING - оплата токенизированной связкой;
  • YANDEX_PAY_CARD - YandexPay нетокенизированная;
  • YANDEX_PAY_TOKENIZED - YandexPay токенизированная;
  • YANDEX_PAY_CARD_BINDING - оплата связкой с не токенизированной картой YandexPay;
  • YANDEX_PAY_TOKENIZED_BINDING - оплата связкой с токенизированной картой YandexPay;
  • MONEY_STREAM - оплата с баланса мобильного телефона через сервис MoneyStream;
  • BNPL - оплата заказа через механизм BNPL (Buy Now Pay Later);
  • MTS_INSTALLMENT - оплата в рассрочку через МТС Банк;
  • MTS_PAY - MTS Pay;
  • QR - оплата по QR-коду;
  • ALFAPAY_PLATIQR - оплата Alfa Pay по QR-коду;
  • TINKOFFPAY_PLATIQR - оплата Tinkoff Pay по QR-коду.
09 и выше.

avsCode

A1

Нет

AVS Response Сode - код ответа AVS-проверки (проверка адреса и почтового индекса держателя карты). Возможные значения:

  • A – почтовый индекс и адрес совпадают;
  • B – адрес совпадает, почтовый индекс не совпадает;
  • C – почтовый индекс совпадает, адрес не совпадает;
  • D – почтовый индекс и адрес не совпадают;
  • E – проверка данных запрошена, но результат неуспешен;
  • F – некорректный формат запроса AVS/AVV проверки.
19 и выше.
Элемент merchantOrderParams – присутствует в ответе, если в заказе содержатся дополнительные параметры продавца. Каждый дополнительный параметр заказа представлен в отдельном элементе merchantOrderParams.

name

AN..20

Нет

Название дополнительного параметра.

Все версии.

value

ANS..2000

Нет

Значение дополнительного параметра - до 2000 символов.

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

maskedPan

N..19

Нет

Маскированный номер карты, которая использовалась для оплаты. Указан только после оплаты заказа.

Все версии.

expiration

ANS

Нет

Срок истечения действия карты в формате ГГГГММ.

Все версии.

cardholderName

AS..26

Нет

Имя держателя карты латиницей, если доступно. Длина поля ограничена 26 символами (латинские буквы, точка, пробел).

Все версии.

approvalCode

AN6

Нет

Код авторизации международной платёжной системы. Поле фиксированной длины (6 символов), может содержать цифры и латинские буквы.

Все версии.

chargeback

A..5

Нет

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

  • true (истина) - средства были возвращены;
  • false (ложь) - средства не были возвращены.
06 и выше.

paymentSystem

N..10

да

Наименование платёжной системы. Доступны следующие варианты:

  • VISA;
  • MASTERCARD;
  • AMEX;
  • JCB;
  • CUP;
  • MIR.

Если заказ был оплачен Платежным счетом, то данный параметр не возвращается.

08 и выше.

product

AN..255

да

Дополнительные сведения о корпоративных картах. Эти сведения заполняются службой технической поддержки. Если такие сведения отсутствуют, возвращается пустое значение.

08 и выше.

productCategory

строка

да

Дополнительные сведения о категории корпоративных карт. Эти сведения заполняются службой технической поддержки в консоли управления. Если такие сведения отсутствуют, возвращается пустое значение. Возможные значения: DEBIT, CREDIT, PREPAID, NON_MASTERCARD, CHARGE, DIFFERED_DEBIT.

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

eci

N..4

Нет

Электронный коммерческий индикатор.

Все версии.

cavv

ANS..200

Нет

Значение проверки аутентификации владельца карты. Указано только после оплаты заказа и в случае соответствующего разрешения.

Все версии.

xid

ANS..80

Нет

Электронный коммерческий идентификатор транзакции. Указан только после оплаты заказа и в случае соответствующего разрешения.

Все версии.
Элемент bindingInfo состоит из следующих параметров.

clientId

ANS..255

Нет

Номер (идентификатор) клиента в системе магазина. Используется для реализации функционала связок. Может присутствовать, если магазину разрешено создание связок.

Указание этого параметра при платежах по связке необходимо - в противном случае платёж будет неуспешен.

Все версии.

bindingId

AN..255

Нет

Идентификатор созданной ранее связки. Может использоваться, только если у продавца есть разрешение на работу со связками. Если этот параметр передаётся в данном запросе, то это означает:
1. Данный заказ может быть оплачен только с помощью связки;
2. Плательщик будет перенаправлен на платёжную страницу, где требуется только ввод CVC.

Все версии.

authDateTime

ANS

Нет

Дата и время авторизации в формате UNIX-времени (POSIX-времени).

02 и выше.

terminalId

AN..10

Нет

Идентификатор терминала в процессинге, через который осуществлялась оплата.

02 и выше.
Элемент bankInfo состоит из параметров.

bankName

ANS..50

Нет

Наименование банка-эмитента.

03 и выше.

bankCountryCode

AN..7

Нет

Код страны банка-эмитента.

03 и выше.

bankCountryName

AN..160

Нет

Страна банка-эмитента.

03 и выше.
Элемент loyaltyInfo/loyaltyInfos (состоит из элемента loyaltyName и тэгов paymentBonus и awardBonus) - Тэг, содержащий данные о состоянии бонусных баллов по программам лояльности в заказе
Элемент loyaltyInfo (состоит из элемента loyaltyName и тэгов paymentBonus и awardBonus) Нет Тэг, содержащий данные о состоянии бонусных баллов по программам лояльности в заказе 04 и выше.
Элемент loyaltyInfos (состоит из элемента loyaltyName и тэгов paymentBonus и awardBonus) Нет Тэг, содержащий данные о состоянии бонусных баллов по программам лояльности в заказе 15 версия и выше.

loyaltyName

ANS..512

Нет

Наименование программы лояльности(для Сбербанк спасибо это «sbrf_spasibo» и «sbrf_sbermiles»).

15 версия и выше.
paymentBonus Нет Тэг с атрибутами, содержащими данные о состоянии использованных баллов для списания при оплате заказа. См. содержимое блока paymentBonus ниже. 04 и выше.
awardBonus Нет Тэг с атрибутами, содержащими данные о состоянии средств, использованных для начисления баллов при оплате заказа. См. содержимое блока awardBonus ниже. 04 и выше.

orderBundle

Не актуально

Да

Блок, содержащий корзину товаров заказа. Описание его атрибутов представлено ниже.

01 и выше.
ofdOrderBundle См. описание Нет

Пересчитанная для ОФД остаточная корзина (с учетом возвратов).

24

В настоящее время реализовано исключительно для АТОЛ систем версии v5 (1.2).

Настоящая корзина отображается только при передаче бонусных баллов «Спасибо» при регистрации заказа.

Содержимое блока paymentBonus

Название Тип Обязательно Описание

approvedAmountBonus

N..20

Нет

Сумма баллов к списанию при оплате заказа.

depositedAmountBonus

N..20

Нет

Подтвержденная сумма в баллах для списания на момент запроса.

refundedAmountBonus

N..20

Нет

Сумма возврата в баллах на момент запроса.

pcId

ANS..512

Нет

Идентификатор последней проведённой операции с суммой для начисления баллов в процессинге лояльности.

successful

ANS..512

Да

Признак успешности операции, возможны следующие значения:

  • true (успешно);
  • false (неуспешно).

paymentOperation

ANS..512

Да

Тип последней проведенной операции со списываемыми баллами (PAYMENT, REVERSE, REFUND_PAYMENT)

Содержимое блока awardBonus

Название Тип Обязательно Описание

approvedAmountAward

N..20

Нет

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

depositedAmountAward

N..20

Нет

Подтверждённая сумма заказа, на которую произведено начисление бонусных баллов.

refundedAmountAward

N..20

Нет

Сумма возврата заказа, на которую произведено начисление бонусных баллов.

pcId

AN..512

Нет

Идентификатор последней проведённой операции с суммой для начисления баллов в процессинге лояльности.

successful

AN..512

Да

Признак успешности операции, возможны следующие значения:

  • true (успешно);
  • false (неуспешно).

paymentOperation

ANS..512

Да

Тип последней проведенной операции с суммой для начисления баллов (AWARD, REVERSE, REFUND_AWARD).

orderBundle

orderBundle состоит из следующих элементов.

Название Тип Обязательно Описание Версия getOrderStatusExtended

orderCreationDate

ANS..21

Нет

Дата создания заказа в формате YYYY-MM-DDTHH:mm:ss.

01 и выше.

customerDetails

Не актуально

Нет

Блок с атрибутами данных о покупателе. Описание его атрибутов представлено ниже.

01 и выше.

cartItems

Не актуально

Да

Блок с атрибутами товарных позиции корзины товаров. Описание его атрибутов представлено ниже.

01 и выше.

customerDetails

customerDetails состоит из следующих элементов.

Название Тип Обязательно Описание Версия getOrderStatusExtended

email

ANS..40

См. примечание ниже.

Адрес электронной почты покупателя. Можно указать несколько адресов электронной почты через запятую и без пробелов - в этом случае чек будет отправлен на все указанные адреса.

01 и выше.

phone

NS..12

См. примечание ниже.

Номер телефона клиента. Примеры:

  • +79000000000
  • 89000000000
  • 9000000000
  • 79000000000

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

При использовании АТОЛ фискализации параметр phone следует передавать в следующем формате:

Номер телефона необходимо передать вместе с кодом страны без пробелов и дополнительных символов кроме символа «» (номер «371 2 1234567» необходимо передать как »+37121234567«). Если номер телефона относится к России (префикс »+7«), то значение можно передавать без префикса (номер »+79251234567« можно передать как «9251234567»). Максимальная длина строки - 64 символа. В запросе должно быть обязательно заполнено одно из полей: email или phone.

01 и выше.

fullName

ANS..100

Нет

Фамилия, имя и отчество плательщика.

01 и выше

passport

ANS..100

Нет

Серия и номер паспорта плательщика в следующем формате: 2222888888.

01 и выше

inn

N..12

Нет

Идентификационный номер налогоплательщика. Допускается передавать 10 или 12 символов.

01 и выше

cartItems

cartItems состоит из следующих элементов.

Название Тип Обязательно Описание Версия getOrderStatusExtended

items

Не актуально

Да

Тэг с параметрами, содержащими информацию по одной товарной позиции в Корзине.

Номер товарной позиции указывается в виде атрибута тэга: positionId - Уникальный идентификатор товарной позиции внутри корзины заказа.

По каждой товарной позиции в запросе должен передаваться отдельный тэг items. Описание параметров тэга представлено ниже.

03 и выше.

items

items состоит из следующих элементов.

Название Тип Обязательно Описание Версия getOrderStatusExtended

positionId

ANS..12

Да

Уникальный идентификатор товарной позиции внутри корзины заказа.

01 и выше.

name

ANS..100

Да

Наименование или описание товарной позиции в свободной форме.

Используйте \\ - для передачи \

используйте \« - для передачи »

где « означает знак кавычек

01 и выше.

quantity

N..18

Да

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

03 и выше.

itemAmount

N..18

Нет

Сумма стоимости всех товарных позиций одного positionId в минимальных единицах валюты. itemAmount обязателен к передаче, только если не был передан параметр itemPrice. В противном случае передача itemAmount не требуется. Если же в запросе передаются оба параметра: itemPrice и itemAmount, то itemAmount должен равняться itemPrice * quantity, в противном случае запрос завершится с ошибкой.

При расчёте параметра itemAmount = itemPrice*quantity результат округляется до второго знака после десятичного разделителя. Например, если результат вычислений равен 100,255, то итоговый результат будет равен 100,26.

01 и выше.

itemCurrency

N3

Нет

Код валюты товарной позиции ISO 4217. Если не указан, считается равным валюте заказа.

01 и выше.

itemCode

ANS..100

Да

Номер (идентификатор) товарной позиции в системе магазина.

Во всех методах передача артикула itemcode/code обязательна.

01 и выше.

quantity

quantity состоит из следующих элементов.

Название Тип Обязательно Описание Версия getOrderStatusExtended

measure

ANS..20

Да

Мера измерения количества товарной позиции.

03 и выше.

Содержимое блока ofdOrderBundle

Название Тип Обязательно Описание

name

ANS..100

Да

Наименование или описание товарной позиции в свободной форме.

itemAmount

N..18

Да

Сумма стоимости всех товарных позиций одного positionId в деньгах в минимальных единицах валюты.

itemPrice

N..18

Да

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

  • itemPrice не может быть меньше 0.
  • itemPrice может передаваться как строкой, так и целочисленным типом.
quantity

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

quantity.value

N..18

Да

Количество товарных позиций данного positionId. Для указания дробных чисел используйте десятичную точку

quantity.measure

ANS..20

Да

Мера измерения количества товарной позиции.

itemAttributes

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

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

itemAttributes[paymentMethod]

N..2

Да

Тип оплаты возможны следующие значения:

  • 1 - полная предварительная оплата до момента передачи предмета расчёта;
  • 2 - частичная предварительная оплата до момента передачи предмета расчёта;
  • 3 - аванс;
  • 4 - полная оплата в момент передачи предмета расчёта;
  • 5 - частичная оплата предмета расчёта в момент его передачи с последующей оплатой в кредит;
  • 6 - передача предмета расчёта без его оплаты в момент его передачи с последующей оплатой в кредит;
  • 7 - оплата предмета расчёта после его передачи с оплатой в кредит.

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

  1. Корзина заказа из API-запроса.
  2. Настройки фискализации в личном кабинете.
  3. Значения по умолчанию.

Для paymentMethod значением по умолчанию является 1 (полная предварительная оплата до момента передачи предмета расчета).

itemAttributes[paymentObject]

N..2

Да

Тип оплачиваемой позиции, возможны следующие значения:

  • 1 - товар;
  • 2 - подакцизный товар;
  • 3 - работа;
  • 4 - услуга;
  • 5 - ставка азартной игры;
  • 6 - выигрыш азартной игры;
  • 7 - лотерейный билет;
  • 8 - выигрыш лотереи;
  • 9 - предоставление РИД;
  • 10 - платёж;
  • 11 - агентское вознаграждение;
  • 12 - составной предмет расчёта;
  • 13 - иной предмет расчёта.
  • 14 - имущественное право;
  • 15 - внереализационный доход;
  • 16 - страховые взносы: о суммах расходов, уменьшающих сумму налога (авансовых платежей) в соответствии с пунктом 3.1 статьи 346.21 Налогового кодекса Российской Федерации;
  • 17 - торговый сбор: о суммах уплаченного торгового сбора;
  • 18 - курортный сбор;

Указанные выше значения доступны для ФФД 1.05.

Для ФФД 1.2 список доступных значений пополняется также следующими значениями:

  • 30 - реализуемый подакцизный товар, подлежащий маркировке средством идентификации, не имеющем кода маркировки;
  • 31 - реализуемый подакцизный товар, подлежащий маркировке средством идентификации, имеющем кода маркировки;
  • 32 - реализуемый товар, подлежащий маркировке средством идентификации, не имеющим код маркировки, за исключением подакцизного товара;
  • 33 - реализуемый товар, подлежащий маркировке средством идентификации, имеющим код маркировки, за исключением подакцизного товара.

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

  1. Корзина заказа из API-запроса.
  2. Настройки фискализации в личном кабинете.
  3. Значения по умолчанию.

Для paymentObject значением по умолчанию является 1 (товар).

taxType

N..2

Да

Ставка НДС, доступны следующие значения:

  • 0 – без НДС;
  • 1 – НДС по ставке 0%;
  • 2 – НДС чека по ставке 10%;
  • 4 – НДС чека по расчетной ставке 10/110;
  • 6 - НДС чека по ставке 20%;
  • 7 - НДС чека по расчётной ставке 20/120;
  • 10 – НДС чека по ставке 5%;
  • 11 – НДС чека по расчетной ставке 5/105;
  • 12 – НДС чека по ставке 7%;
  • 13 – НДС чека по расчетной ставке 7/107.

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

Содержимое блока loyalties

Название Тип Обязательно Описание Версия getOrderStatusExtended

loyaltyProgramName

ANS..20

Да

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

04 и выше.

positionId

ANS..12

Да

Идентификатор товарной позиции, участвующей в указанной бонусной программе.

04 и выше.

bonusAmountForDebit

N..18

Да

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

04 и выше.

bonusAmountForCredit

N..18

Нет

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

04 и выше.

Коды ошибок

Код ошибки Текст ошибки
0

Обработка запроса прошла без системных ошибок.

5

Доступ запрещён.

5

Пользователь должен сменить свой пароль.

5

[orderId] не указан.

6

Незарегистрированный orderId.

7

Системная ошибка.

Примеры

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

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:mer="http://engine.paymentgate.ru/webservices/merchant">
    <soapenv:Header/>
    <soapenv:Body>
       <mer:getOrderStatusExtended>
          <order orderId="942e8534-ac73-4e3c-96c6-f6cc448018f7" language="en">
             <!--Optional:-->
             <merchantOrderNumber> </merchantOrderNumber>
            </order>
       </mer:getOrderStatusExtended>
    </soapenv:Body>
 </soapenv:Envelope>

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

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns1:getOrderStatusExtendedResponse xmlns:ns1="http://engine.paymentgate.ru/webservices/merchant">
         <return orderNumber="1499420313736" orderStatus="2" actionCode="0" actionCodeDescription="" amount="10500" currency="643" date="2017-07-07T12:41:11.654+03:00" orderDescription="Описание" ip="127.0.0.1" errorCode="0" errorMessage="Успешно">
            <attributes name="mdOrder" value="dc84ffbc-1d04-4748-94dc-75d87e91a745"/>
            <cardAuthInfo maskedPan="555555**5599" expiration="202012" cardholderName="Test" approvalCode="111111"/>
            <authDateTime>2017-07-07T12:41:12.185+03:00</authDateTime>
            <terminalId>12345678</terminalId>
            <authRefNum>111111111111</authRefNum>
            <paymentAmountInfo paymentState="DEPOSITED" approvedAmount="10500" depositedAmount="10500" refundedAmount="0"/>
            <bankInfo bankName="SOME BANK IN USA" bankCountryCode="US" bankCountryName="Соединенные Штаты Америки"/>
            <orderBundle>
               <cartItems>
                  <items positionId="1">
                     <name>Universal Mirror Enduro</name>
                     <quantity measure="штук">3.0</quantity>
                     <itemAmount>6000</itemAmount>
                     <itemCurrency>643</itemCurrency>
                     <itemCode>NM-15</itemCode>
                  </items>
                  <items positionId="2">
                     <name>Билет в Москву</name>
                     <quantity measure="штук">1.0</quantity>
                     <itemAmount>4500</itemAmount>
                     <itemCurrency>643</itemCurrency>
                     <itemCode>GFCCHC</itemCode>
                  </items>
               </cartItems>
            </orderBundle>
         </return>
      </ns1:getOrderStatusExtendedResponse>
   </soap:Body>
</soap:Envelope>

Пример ответа на на запрос getOrderStatusExtended 24 версии

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns1:getOrderStatusExtendedResponse xmlns:ns1="http://engine.paymentgate.ru/webservices/merchant">
         <return orderNumber="224000" orderStatus="2" actionCode="0" actionCodeDescription="" amount="572725" currency="643" date="2022-09-21T17:56:11.735+03:00" depositedDate="2022-09-21T17:56:22.280+03:00" orderDescription="" errorCode="0" errorMessage="Успешно">
            <merchantOrderParams name="loyaltyId" value="sbrf_spasibo"/>
            <merchantOrderParams name="sbrf_spasibo:amount_bonus" value="200000"/>
            <merchantOrderParams name="sbrf_spasibo:change_rate" value="1"/>
            <transactionAttributes name="merchantIp" value="10.99.50.37"/>
            <transactionAttributes name="paymentNetRefNum" value="a793cb09-c900-455e-a128-6f23b83848a0"/>
            <attributes name="mdOrder" value="2209895b-fde2-7ea0-b45b-6e0e00e3b4f8"/>
            <cardAuthInfo maskedPan="427601XXXXXX6064" expiration="202412" cardholderName="Some Text" approvalCode="123456" paymentSystem="VISA"/>
            <authDateTime>2022-09-21T17:56:20.909+03:00</authDateTime>
            <terminalId>12345678</terminalId>
            <authRefNum>111111111111</authRefNum>
            <paymentAmountInfo paymentState="DEPOSITED" approvedAmount="572725" depositedAmount="572725" refundedAmount="0" feeAmount="0" totalAmount="572725"/>
            <bankInfo bankName="SBERBANK OF RUSSIA" bankCountryCode="RU" bankCountryName="Россия"/>
            <orderBundle>
               <cartItems>
                  <items positionId="1">
                     <name>water</name>
                     <itemDetails>
                        <itemDetailsParams name="brand">Metzeler</itemDetailsParams>
                        <itemDetailsParams name="radius">17inch</itemDetailsParams>
                     </itemDetails>
                     <quantity measure="0">60.0</quantity>
                     <itemAmount>444705</itemAmount>
                     <depositedItemAmount>444705</depositedItemAmount>
                     <itemCurrency>643</itemCurrency>
                     <itemCode>1</itemCode>
                     <itemAttributes>
                        <attributes name="paymentMethod">1</attributes>
                        <attributes name="paymentObject">1</attributes>
                     </itemAttributes>
                  </items>
                  <items positionId="2">
                     <name>water</name>
                     <itemDetails>
                        <itemDetailsParams name="brand">Noname</itemDetailsParams>
                        <itemDetailsParams name="diameter">12mm</itemDetailsParams>
                     </itemDetails>
                     <quantity measure="0">10.0</quantity>
                     <itemAmount>73977</itemAmount>
                     <depositedItemAmount>73977</depositedItemAmount>
                     <itemCurrency>643</itemCurrency>
                     <itemCode>2</itemCode>
                     <itemAttributes>
                        <attributes name="paymentMethod">1</attributes>
                        <attributes name="paymentObject">1</attributes>
                     </itemAttributes>
                  </items>
                  <items positionId="3">
                     <name>potato</name>
                     <itemDetails>
                        <itemDetailsParams name="brand">Noname</itemDetailsParams>
                     </itemDetails>
                     <quantity measure="0">6.543</quantity>
                     <itemAmount>54043</itemAmount>
                     <depositedItemAmount>54043</depositedItemAmount>
                     <itemCurrency>643</itemCurrency>
                     <itemCode>3</itemCode>
                     <itemAttributes>
                        <attributes name="paymentMethod">1</attributes>
                        <attributes name="paymentObject">1</attributes>
                     </itemAttributes>
                  </items>
               </cartItems>
               <loyalties>
                  <loyalties loyaltyProgramName="sbrf_spasibo" positionId="1">
                     <bonusAmountForDebit>155295</bonusAmountForDebit>
                     <bonusAmountForCredit>0</bonusAmountForCredit>
                  </loyalties>
                  <loyalties loyaltyProgramName="sbrf_spasibo" positionId="2">
                     <bonusAmountForDebit>25833</bonusAmountForDebit>
                     <bonusAmountForCredit>0</bonusAmountForCredit>
                  </loyalties>
                  <loyalties loyaltyProgramName="sbrf_spasibo" positionId="3">
                     <bonusAmountForDebit>18872</bonusAmountForDebit>
                     <bonusAmountForCredit>0</bonusAmountForCredit>
                  </loyalties>
               </loyalties>
            </orderBundle>
            <loyaltyInfos loyaltyName="sbrf_sbermiles">
               <paymentBonus approvedAmountBonus="0" depositedAmountBonus="0" refundedAmountBonus="0" successful="false"/>
               <awardBonus approvedAmountAward="572725" depositedAmountAward="572725" refundedAmountAward="0" pcId="1003050634" successful="true" paymentOperation="AWARD"/>
            </loyaltyInfos>
            <loyaltyInfos loyaltyName="sbrf_spasibo">
               <paymentBonus approvedAmountBonus="200000" depositedAmountBonus="200000" refundedAmountBonus="0" pcId="1003050632" successful="true" paymentOperation="PAYMENT"/>
               <awardBonus approvedAmountAward="572725" depositedAmountAward="572725" refundedAmountAward="0" pcId="1003050633" successful="true" paymentOperation="AWARD"/>
            </loyaltyInfos>
            <chargeback>false</chargeback>
            <paymentWay>CARD</paymentWay>
            <ofdOrderBundle taxType="NONE" name="potato" itemAmount="18005" itemPrice="8259">
               <quantity measure="0">2.18</quantity>
               <itemAttributes name="paymentMethod" value="1"/>
               <itemAttributes name="paymentObject" value="1"/>
            </ofdOrderBundle>
            <ofdOrderBundle taxType="NONE" name="potato" itemAmount="36038" itemPrice="8260">
               <quantity measure="0">4.363</quantity>
               <itemAttributes name="paymentMethod" value="1"/>
               <itemAttributes name="paymentObject" value="1"/>
            </ofdOrderBundle>
            <ofdOrderBundle taxType="VAT_20" name="water" itemAmount="111165" itemPrice="7411">
               <quantity measure="0">15.0</quantity>
               <itemAttributes name="paymentMethod" value="1"/>
               <itemAttributes name="paymentObject" value="1"/>
            </ofdOrderBundle>
            <ofdOrderBundle taxType="NONE" name="water" itemAmount="22191" itemPrice="7397">
               <quantity measure="0">3.0</quantity>
               <itemAttributes name="paymentMethod" value="1"/>
               <itemAttributes name="paymentObject" value="1"/>
            </ofdOrderBundle>
            <ofdOrderBundle taxType="VAT_20" name="water" itemAmount="333540" itemPrice="7412">
               <quantity measure="0">45.0</quantity>
               <itemAttributes name="paymentMethod" value="1"/>
               <itemAttributes name="paymentObject" value="1"/>
            </ofdOrderBundle>
            <ofdOrderBundle taxType="NONE" name="water" itemAmount="51786" itemPrice="7398">
               <quantity measure="0">7.0</quantity>
               <itemAttributes name="paymentMethod" value="1"/>
               <itemAttributes name="paymentObject" value="1"/>
            </ofdOrderBundle>
         </return>
      </ns1:getOrderStatusExtendedResponse>
   </soap:Body>
</soap:Envelope>