User Tools

Site Tools

  • en

Delayed orders trading scheme

Scheme description

The point of the scheme is - placing the order is reversible. This is achieved by placing a so-called “delayed” order - within 2 hours there is an opportunity to cancel the order without any interference. If the order was not canceled within 2 hours, the sale is considered to be successfully completed and the information is sent to the MONT reporting system. If the order is canceled within 2 hours, the keys to it are returned to the virtual MONT warehouse for further resale. For the reporting system, this order did not exist.

Conditions

  • The partner knows the list of products in the MONT system to trade
  • The partner have a login for a system and all the required contracts are concluded.
  • For the partner are configured (if required) all the necessary discounts in the price list.
  • For login of partner are configuredthat the keys are returned immediately in response to the request.

Steps

1. Place delayed order (AddOrderDelayed)

Description

The method is used to place a “pending order” in the MontWebstore system. The input object contains the order number and the list of order lines. Each line corresponds to one ordered position, it has a unique number. It describes:

  • product ID;
  • quantity;
  • a completed license form, with end user information (if required);
  • the subscriber ID for which the subscription is created (only filled if the ordered product is a subscription).

Parameters

SendOrderLangContract
NameTyperequireDescription
OrderNumstringyesOrder Number in MONT system. It is set by reseller, and must be unique within all orders of the reseller.
SendOrderLinesarray of SendOrderLineContractyesAn array containing all rows of this order
LangCodestringyesLanguage for printing instructions
PhonenoEnduser phone number
SendOrderLineContract
EndUserInfoContract
NameTypeDescription
Fieldsarray of EndUserInfoFieldContractList of the end user license form fields
EndUserInfoFieldContract
NameTypeDescription
FieldNamestringName of the license form field
FieldValuestringField value

Return Values

OrderWiInstructionContract
NameTypeDescription
OrderNumstringOrder number
OrderStatusintCurrent status of the order. Possible values: InProcess - In process, 2 - Error, Successed - Succesfull. If all order lines are completed successfully, then the status is completed successfully. Otherwise, the status of the order is in process.
DateCreatedDateTimeOrder creation date
OrderLinesarray of OrderLineWiInstructionContractList of order lines
OrderLineWiInstructionContract

Содержит информацию об одной строке заказа с инструкциями для печати на чеке

Список полей (RU)
НазваниеТипОписание
OrderLineNumstringНомер строки заказа
DateCreatedDateTimeДата создания заказа
PartNumstringПартномер товара или услуги, за которую отвечает строка заказа
QuantityintКоличество
TotalSummdoubleСуммарная стоимость строки заказа
ItemPricedoubleЦена реселлера за одну единицу
CurrencystringКод валюты, в которой была совершена покупка
OrderStatusintСтатус строки заказа. Возможные значения описываются словарем OrderLineStatusEnum
EndUserInfoEndUserInfoContractИнформация о конечном пользователе, на которого была оформлена покупка
InstallInstructionsstringИнструкция по установке(использованию) для печати на чеках. Пример:
\nKaspersky Anti-Virus, защита 2 ПК на\n1 год \n
\nКлючи возврату и обмену не подлежат.\n
\nПоддержка производителя ключей: 8 \n800 7008811 \n
\nПоддержка поставщика ключей: 8 800 \n3331817 \n
\nСсылка на скачивание: https://www.kasnspersky.ru/downloads/thank-you/antivirus \n
\nНе для продажи и активации за \nпределами РФ.
FullInstructionsstringИнструкция по установке(использованию) для печати на чеках + список ключей, каждый из которых на отдельной строке. Пример:
2PGPF-FJRF9-QH6VT-DP7KQ-DJ9CZ,\n\n
Kaspersky Anti-Virus, защита 2 ПК на\n1 год \n
\nКлючи возврату и обмену не подлежат.\n
\nПоддержка производителя ключей: 8 \n800 7008811 \n
\nПоддержка поставщика ключей: 8 800 \n3331817 \n
\nСсылка на скачивание: https://www.ka\n
spersky.ru/downloads/thank-you/antiv\n
irus \n
\nНе для продажи и активации за \nпределами РФ.
Keys array of OrderKeyContractСписок ключей - результатов заказа
Links array of OrderLinkContractСписок ссылок - результатов заказа
Files array of OrderFileContractСписок файлов - результатов заказа
SubscriptionIdstringНомер подписки, которая была оформлена с помощью этой строки заказа. Заполняется, только если была заказана подписка
MontSubscriberIdGuidИдентификатор подписчика, на которого была оформлена подписка с помощью этой строки заказа. Заполняется, только если была заказана подписка
ErrorCodeintКод ошибки. Возможные ошибки.
ErrorTextstringОписание ошибки

to english

OrderKeyContract
NameTypeDescription
ActiveKeystringActivation key
DateAddDateTimeKey purchase date
VendorClientTransactionIdstringKey purchase transaction ID. Used to bind the key to links and files
DescriptionstringKey description
OrderLinkContract
NameTypeDescription
Linkstringlink URL
DateAddDateTimeLink purchase date
VendorClientTransactionIdstringThe identifier of the transaction by which the link was obtained. Used to bind the key to links and files
DescriptionstringLink description
OrderFileContract
NameTypeDescription
DateAddDateTimeFile purchase date
VendorClientTransactionIdstringThe identifier of the transaction by which the file was received. Used to bind the key to links and files
DescriptionstringFile description
FileNamestringFile name
FileExtensionstringExtension of file
FileSizeintFile size (bytes)
DownloadUrlstringFile download link

All replies of web services B2BServiceV2Xml.svc and B2BServiceV2.svc are wrapped in a contract type (the contract contains information about the violations in the operation of the web service, as well as the response of the called method inside the <Data> tag.):

Errors


Возможные ошибки метода AddOrderDelayed

Examples

XmlOverHttp request without license form example
ВНИМАНИЕ!
Значения параметров представлены исключительно в целях демонстрации и не могут быть использованы в качестве рабочего запроса.

Запрос XmlOverHttp без лицензионной формы

Ответ XmlOverHttp без лицензионной формы


Запрос XmlOverHttp с лицензионной формой

Ответ XmlOverHttp с лицензионной формой


Запрос SOAP без лицензионной формы

Ответ SOAP без лицензионной формы


Запрос SOAP с лицензионной формой

Ответ SOAP с лицензионной формой

XmlOverHttp response (without license form) example
ВНИМАНИЕ!
Значения параметров представлены исключительно в целях демонстрации и не могут быть использованы в качестве рабочего запроса.

Запрос XmlOverHttp без лицензионной формы

Ответ XmlOverHttp без лицензионной формы


Запрос XmlOverHttp с лицензионной формой

Ответ XmlOverHttp с лицензионной формой


Запрос SOAP без лицензионной формы

Ответ SOAP без лицензионной формы


Запрос SOAP с лицензионной формой

Ответ SOAP с лицензионной формой

XmlOverHttp request with license form example
ВНИМАНИЕ!
Значения параметров представлены исключительно в целях демонстрации и не могут быть использованы в качестве рабочего запроса.

Запрос XmlOverHttp без лицензионной формы

Ответ XmlOverHttp без лицензионной формы


Запрос XmlOverHttp с лицензионной формой

Ответ XmlOverHttp с лицензионной формой


Запрос SOAP без лицензионной формы

Ответ SOAP без лицензионной формы


Запрос SOAP с лицензионной формой

Ответ SOAP с лицензионной формой

XmlOverHttp response (with license form) example
ВНИМАНИЕ!
Значения параметров представлены исключительно в целях демонстрации и не могут быть использованы в качестве рабочего запроса.

Запрос XmlOverHttp без лицензионной формы

Ответ XmlOverHttp без лицензионной формы


Запрос XmlOverHttp с лицензионной формой

Ответ XmlOverHttp с лицензионной формой


Запрос SOAP без лицензионной формы

Ответ SOAP без лицензионной формы


Запрос SOAP с лицензионной формой

Ответ SOAP с лицензионной формой

SOAP request
ВНИМАНИЕ!
Значения параметров представлены исключительно в целях демонстрации и не могут быть использованы в качестве рабочего запроса.

Запрос XmlOverHttp без лицензионной формы

Ответ XmlOverHttp без лицензионной формы


Запрос XmlOverHttp с лицензионной формой

Ответ XmlOverHttp с лицензионной формой


Запрос SOAP без лицензионной формы

Ответ SOAP без лицензионной формы


Запрос SOAP с лицензионной формой

Ответ SOAP с лицензионной формой

SOAP response
ВНИМАНИЕ!
Значения параметров представлены исключительно в целях демонстрации и не могут быть использованы в качестве рабочего запроса.

Запрос XmlOverHttp без лицензионной формы

Ответ XmlOverHttp без лицензионной формы


Запрос XmlOverHttp с лицензионной формой

Ответ XmlOverHttp с лицензионной формой


Запрос SOAP без лицензионной формы

Ответ SOAP без лицензионной формы


Запрос SOAP с лицензионной формой

Ответ SOAP с лицензионной формой

2. Confirm delayed order (ConfirmDelayedOrder)

In case when sale to the end user is successfull, the partner can send a request for confirm of the delayed order. The order will be considered successful and it's data will be sent to the MONT reporting system without waiting for the end of 2 hours. After 2 hours from the moment of placing the delayed order, the system will consider the order successful anyway (even without confirmation).

Описание

Метод используется в схеме размещения отложенного заказа для подтверждения размещенного “отложенного заказа” в системе MontWebstore. В случае, когда продажа конечному клиенту состоялась, партнёр должен отправить запрос на подтверждение отложенного заказа. В этом случае заказ будет считаться успешным и информация по нему отправится в систему отчётности MONT. Если при размещении заказа был указан номер телефона клиента, то при подтверждении заказа на этот номер будет отправлена СМС.

ВНИМАНИЕ! В случае если партнер не отправил подтверждение в течении 24 часов, заказ будет отменен в автоматическом режиме. Партнеру не следует полагаться на автоотмену. Партнер обязан отменять заказ, как только в нем пропадает необходимость, в этом случае система MONT снимает резерв ключей.
Параметры
НазваниеТипОписание
orderNumberstringНомер заказа (пример: abc0000123)
Возвращаемое значение
ТипОписание
boolОбъект , содержащий статус выполнения операции

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

Запрос XmlOverHttp

Ответ XmlOverHttp


Запрос SOAP

Ответ SOAP


Возможные ошибки
КодТекст ошибки
3Заказ не найден
6006Не нужно делать эту операцию для обычного заказа
6002Уже успешно подтвержден
6001Невозможно подтвердить отложенный заказ

2а. Refuse delayed order (RefuseDelayedOrder)

RefuseDelayedOrder

Description

The method is used to cancel the placed “delayed” order in the MontWebstore system.

Parameters
NameTypeDescription
orderNumberstringOrder number
Return value
TypeDescription
boolObject containing the status of the operation
Errors
Error codeError text
3Order not found
6006Operation is not allowed for not dellayed order
6007Order is already refused
6004Can't refuse delayed order
Examples
XmlOverHttp request

Запрос XmlOverHttp

Ответ XmlOverHttp


Запрос SOAP

Ответ SOAP


XmlOverHttp response

Запрос XmlOverHttp

Ответ XmlOverHttp


Запрос SOAP

Ответ SOAP


SOAP request

Запрос XmlOverHttp

Ответ XmlOverHttp


Запрос SOAP

Ответ SOAP


SOAP response

Запрос XmlOverHttp

Ответ XmlOverHttp


Запрос SOAP

Ответ SOAP