4.1. CreateOrder - Административная операция создания заказа [SP2]

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

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

XML-запрос

XML-запрос имеет следующий формат

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 <?xml version="1.0" encoding="UTF-8"?> <TKKPG>   <Request>   <Operation>CreateOrder</Operation>   <Language>RU</Language>     <Order>       <OrderType>Purchase</OrderType>       <Merchant>TEST_TRADER_2</Merchant>       <Amount>5000</Amount>       <Currency>980</Currency>       <Description>Тестовая покупка</Description> <ApproveURL>https://test-shop/result.php</ApproveURL>       <DeclineURL>https://test-shop/result.php</DeclineURL>       <CancelURL>https://test-shop/result.php</CancelURL>     </Order>   </Request> </TKKPG>

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

Параметр

Нужность

Описание

Параметр

Нужность

Описание

Language

Да

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

OrderType

Да

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

  • Purchase - покупка

  • P2PTransfer - P2P перевод

  • PreAuth - Предавторизация

  • 3DSOnly - Только проверка 3-D Secure без финансовой тразнакции

  • C2A - Card 2 Account - Только дебетовая часть P2P Перевода

Merchant

Да

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

Amount

Да

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

Currency

Да

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

Description

Да

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

ApproveURL

Нет

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

DeclineURL

Нет

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

CancelURL

Нет

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

AddParams.MPI.Version

Нет

Версия 3DS протокола. Обязательна при "ручном" вызове финансовых операций.

  • 1 - протокол 3-D Secure v1.0;

  • 2 - протокол EMV 3-D Secure v2.1.

AddParams.TokenCryptogram

Нет

TAVV/DTVV/DSRP криптограмма. Обязательна при проведении 3-D Secure аутентификации для транзакций, выполняемых по токену.

XML-ответ

XML-ответ имеет следующий формат

XML-ответ имеет следующий формат

1 2 3 4 5 6 7 8 9 10 11 12 <?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 страницы оплаты Прокард)