Здесь находится описание алгоритма выполнения административной операции GetOrderInformation [SP2] при использовании платежного портала Процессингового центра "Прокард"

XML-запрос имеет формат

<?xml version="1.0" encoding="UTF-8"?>
<TKKPG>
  <Request>
    <Operation>GetOrderInformation</Operation>
    <Language></Language>
    <Order>
      <Merchant></Merchant>
      <OrderID></OrderID>
    </Order>
    <SessionID></SessionID>
    <ShowParams></ShowParams>
    <ShowOperations></ShowOperations>
    <ShowPositions></ShowPositions>
    <ClassicView></ClassicView>
  </Request>
</TKKPG>

На этой странице:

Описание параметров запроса

Параметр

Обяз. поле

Описание

Language

Да

Язык интерфейса. Заполняется в соответствии с RFC 1766 двухсимвольным кодом языка (например, RU – русский, EN – английский, UK – украинский и т. д.)

Merchant

Да

Идентификатор интернет-магазина.

OrderID

Да

Идентификатор заказа, по которому необходимо получить информацию

SessionID

Да

Идентификатор сессии, который был выдан ранее для данного заказа с соответствующим OrderID

ShowParams

Нет

Возможность просмотреть дополнительные параметры заказа.
Возможные значения:
true – в ответ будет добавлена секция <OrderParams>, содержащая имена и значения дополнительных параметров заказа
false (по умолчанию) – в ответе значения дополнительных параметров заказа будут отсутствовать

ShowOperations

Нет

Возможность просмотреть список всех операций по заказу.
Возможные значения:
true – в ответ будет добавлена секция <OrderOperations>, содержащая список операций по заказу
false (по умолчанию) – в ответе будет отсутствовать секция <OrderOperations>

ShowPositions

Нет

Должно быть false.

ClassicView

Нет

Отображение ответа в стандартном виде.
Возможные значения:
true – ответ отображается в стандартном виде (т. е. присутствует тег <TKKPG>/<Response>, содержащий остальные теги ответа)
false (по умолчанию) – ответ отображается без тега <TKKPG>/<Response> (т. е. все теги ответа содержатся в теге <Order>)

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

<?xml version="1.0" encoding="UTF-8"?>
<TKKPG>
  <Request>
    <Operation>GetOrderInformation</Operation>
    <Language>RU</Language>
    <Order>
      <Merchant>TEST_TRADER</Merchant>
      <OrderID>828</OrderID>
    </Order>
    <SessionID>ECDE79578768ECFBF2897A0F44CC0CEF</SessionID>
    <ShowParams>true</ShowParams>
    <ShowOperations>true</ShowOperations>
    <ShowPositions>false</ShowPositions>
    <ClassicView>false</ClassicView>
  </Request>
</TKKPG>

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

Если значение параметра ClassicView равно true (если значение параметра ClassicView равно false: Заглавный тэг Order, а TKKPG не существует):

<?xml version="1.0" encoding="UTF-8"?>
<TKKPG>
  <Response>
    <Operation>GetOrderInformation</Operation>
    <Status>00</Status>
    <Order>
      <row>
        <id>9074</id>
        <SessionID>B5EF753375C69B3A30700A82A43811E8</SessionID>
        <createDate>2017-02-13 14:15:37</createDate>
        <lastUpdateDate>2017-02-13 14:33:26</lastUpdateDate>
        <payDate>2017-02-13 14:34:11</payDate>
        <MerchantID>POS_1</MerchantID>
        <Amount>2500</Amount>
        <Currency>840</Currency>
        <OrderLanguage>RU</OrderLanguage>
        <Description>xxxxxxxx</Description>
        <ApproveURL>/testshopPageReturn.jsp</ApproveURL>
        <CancelURL>/testshopPageReturn.jsp</CancelURL>
        <DeclineURL>/testshopPageReturn.jsp</DeclineURL>
        <Orderstatus>EXPIRED</Orderstatus>
        <Receipt/>
        <twoId/>
        <RefundAmount>0</RefundAmount>
        <RefundCurrency>null</RefundCurrency>
        <ExtSystemProcess>0</ExtSystemProcess>
        <OrderType>Purchase</OrderType>
        <Fee>0</Fee>
        <RefundDate>0000-00-00 00:00:00</RefundDate>
        <TWODate>130217</TWODate>
        <TWOTime>143411</TWOTime>
        <OrderParams>
          <row>
            <PARAMNAME>TranAddendums</PARAMNAME>
            <VAL>PFRyYW5BZGRlbmR1bXM+ ZW5kdW1zPg0K</VAL>
          </row>
        </OrderParams>
        <OrderOperations>
          <row>
            <id>11721</id>
            <PackageId>1</PackageId>
            <createDate>2017-02-13 14:15:37</createDate>
            <MerchantID>POS_1</MerchantID>
            <TERMINALID/>
            <OperType>0</OperType>
            <OperName>CreateOrder</OperName>
            <OrderId>9074</OrderId>
            <Amount>0</Amount>
            <Currency/>
            <Approval/>
            <twoId/>
          </row>
        </OrderOperations>
        <Positions>
          <Position>
            <Quantity>1</Quantity>
            <Price>12</Price>
            <Tax>2</Tax>
            <Text>Name Position</Text>
            <PaymentType>1</PaymentType>
            <PaymentMethodType>1</PaymentMethodType>
            <PaymentSubjectType>1</PaymentSubjectType>
          </Position>
        </Positions>
      </row>
    </Order>
  </Response>
</TKKPG>

Описание параметров ответа

Параметр

Обяз. поле

Описание

Status

Да

Результат выполнения запроса:
00 – успешно
30 – неверный формат сообщения (нет обязательных параметров и т. д.)
10 – интернет-магазин не имеет доступа к операции получения статуса заказа (или такой интернет-магазин не зарегистрирован)
54 – недопустимая операция
72 – системная ошибка
96 – системная ошибка
97 – системная ошибка

id

Да

Идентификатор заказа, по которому запрошен статус

SessionID

Да

Идентификатор сессии

createDate

Нет

Дата создания заказа

lastUpdateDate

Нет

Дата последнего изменения заказа

payDate

Нет

Дата первого платежа по заказу

MerchantID

Нет

Идентификатор интернет-магазина

Amount

Нет

Сумма заказа

Currency

Нет

Валюта заказа

OrderLanguage

Нет

Язык интерфейса заказа. Заполняется в соответствии с RFC 1766 двухсимвольным кодом языка (например, RU – русский, EN – английский, UK – украинский и т. д.)

Description

Нет

Описание заказа

ApproveURL

Нет

URL, на который будет перенаправлен клиент после одобрения операции

CancelURL

Нет

URL, на который будет перенаправлен клиент в случае отказа (нажатия на кнопку Cancel/Отмена)

DeclineURL

Нет

URL, на который будет перенаправлен клиент в случае неуспешного проведения операции оплаты

OrderStatus

Да

APPROVED или DECLINED. Подробнее в Приложение 2

Receipt

Нет

Подписанный квиток совершенной авторизации

(BASE64-encoded)

twoid

Нет

Номер транзакции, выполненной по последней операции в заказе

RefundAmount

Нет

Сумма операций возврата

RefundCurrency

Нет

Валюта операций возврата

ExtSystemProcess

Нет

Признак использования внешней системы для обработки транзакции

OperType

Нет

Тип заказа

Fee

Нет

Эквайринговая комиссия

RefundDate

Нет

Дата возврата по заказу

TWODate

Нет

Дата на чеке

TWOTime

Нет

Время на чеке

OrderParams

Нет

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

OrderOperations

Нет

Содержит список всех операций по заказу