VNP Input Webservices - Deanonymize an Anonymous order

WS Deanonymize Anonymous order

"wsDeanonymize.jsp" is a VirtualNewspaper input webservice to collect an app serial number (appsn) and relate all its orders to the provided email address

How to invoke this webservice

An external platform informs VirtualNewspaper that all the orders related to an app serial number (appsn) must be associated to an email address. In this way all the orders are deanonymized.

Webservice url
https://DOMAIN/PLATFORM/webservice/wsDeanonymize.jsp

Webservice Mandatory Parameters
Mandatory parameters are: email, appsn, authCode.

Example
Parameters need to be provided using this syntax:
?email=info@virtualcom.it&appsn=12345678&authCode=fr34df56ocon762tfv9

A new webservice call is needed for every incoming order to be de-anonymized.

Webservice reply

This VirtualNewspaper webservice is able to provide two different replies :

01) Order has been successfully created. This is VirtualNewspaper internal order ID.
In this scenario VirtualNewspaper JSON reply will look like this :

{
“order” : {
internalId: “88261”
productDescription: “1 month subscription”
orderNumber: “VNP-136446314182261”
orderId: “orderExternalId”
}
“status”: “OK”
“request” : “Request parameters”
}

Please, link VirtualNewspaper order ID to your internal order ID.

02) Something went wrong.
In this scenario VirtualNewspaper JSON reply will look like this :

{
“status”:“KO”,
“error”:“Error message”
“request”:“Request parameters”
}

PARAMETERS REFERENCE TABLE

PARAMETER NAME MANDATORY VALUE FORMAT DESCRIPTION EXAMPLE
email Y String Customer email. It must already exist in VirtualNewspaper customers table. Orders from unknown users will be rejected.
appsn Y String App's UDID (Unique Device Identifier)
authCode Y String Authorization token that allows VirtualNewspaper to handle any incoming request. md5(email+privateKey)