4.1. CreateOrder - Административная операция создания заказа [SP2]
На этой странице описана структура административной операции 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>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 | Да | Тип заказа. Параметр определяет финансовую транзакцию, которая будет впоследствии сформирована.
|
Merchant | Да | Идентификатор интернет-магазина. |
Amount | Да | Сумма транзакции в копейках |
Currency | Да | Код валюты транзакции (должен быть = 980-гривня) |
Description | Да | Текстовое описание заказа – будет отображено для клиента при выполнении платежа на странице оплаты. |
ApproveURL | Нет | URL для перенаправления в случае успешной операции (APPROVE) |
DeclineURL | Нет | URL для перенаправления в случае отказа (DECLINE) |
CancelURL | Нет | URL для перенаправления в случае отмены (CANCEL) |
AddParams.MPI.Version | Нет | Версия 3DS протокола. Обязательна при "ручном" вызове финансовых операций.
|
AddParams.TokenCryptogram | Нет | TAVV/DTVV/DSRP криптограмма. Обязательна при проведении 3-D Secure аутентификации для транзакций, выполняемых по токену. |
XML-ответ
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 | Результат выполнения запроса: |
OrderID | Определяет уникальный номер заказа, который будет использоваться при ссылке на данный заказ со стороны сервера интернет-магазина |
SessionID | Идентификатор сессии, применяемый в совокупности с номером заказа для инициации оплаты, операций отмены, получения статуса заказа и т. д. |
URL | Игнорируется. (это URL страницы оплаты Прокард) |
Copyright © 2015-2021 PROCARD