4. Административная операция CreateOrder [SP]

На этой странице описана структура административной операции CreateOrder на платежном портале ПЦ "Прокард" с использованием продукта PC-ECOM-PG

Структура административной операции CreateOrder продукта PC-ECOM-PG представляется в виде XML-запроса отсылаемого на платежный портал ПЦ "Прокард" с варьируемыми параметрами, на который приходит XML-ответ также с варьируемыми параметрами.

Содержание XML-запроса и XML-ответа описываются следующим образом:

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

XML-запрос
XML-запрос имеет следующий формат
<?xml version=”1.0” encoding=”UTF-8”?>
<TKKPG>
  <Request>
  <Operation>CreateOrder</Operation>
  <Language></Language>
    <Order>
      <OrderType>Purchase</OrderType>
      <Merchant></Merchant>
      <Amount></Amount>
      <Currency></Currency>
      <Description></Description>
      <email></email>
      <phone></phone>
      <ApproveURL></ApproveURL>
      <DeclineURL></DeclineURL>
      <CancelURL></CancelURL>
    </Order>
  </Request>
</TKKPG>
  • Описание параметров запроса
ПараметрНужностьОписание

Language

Да

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

OrderType

Нет

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

Merchant

Да

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

Amount

Да

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

Currency

Да

Код валюты транзакции (должен быть = 980-гривня)

Description

Да

Текстовое описание заказа – будет отображено для клиента при выполнении платежа на странице оплаты.

email

Нет

E-mail клиента (дополнительный параметр), который можно сохранить в БД.

phone

Нет

Номер телефона клиента (дополнительный параметр), который можно сохранить в БД.

ApproveURL

Нет

URL для перенаправления в случае успешной операции (APPROVE)

DeclineURL

Нет

URL для перенаправления в случае отказа (DECLINE)

CancelURL

Нет

URL для перенаправления в случае отмены (CANCEL)

  • Пример Ответа
XML-ответ имеет следующий формат
<?xml version=”1.0” encoding=”UTF-8”?>
<TKKPG>
  <Response>
    <Operation>CreateOrder</Operation>
    <Status>00</Status>
    <Order>
      <OrderID>828</OrderID>
      <SessionID>ECDE79578768ECFBF2897A0F44CC0CEF</SessionID>
      <URL>https://PayURL/index.jsp</URL>
    </Order>
  </Response>
</TKKPG>
  • Описание параметров ответа
ПараметрНужностьОписание

Status

Да

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

OrderID

Условно

Определяет уникальный номер заказа, который будет использоваться при ссылке на данный заказ со стороны сервера интернет-магазина

SessionID

Условно

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

URL

Условно

URL, на который необходимо перенаправить пользователя (переход осуществляется методом GET на URL, указанный в ответе, с добавлением параметров SessionID и OrderID, принимающих значения идентификатора сессии и номера заказа соответственно)