VNP Input Webservices - Deanonymize an 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
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 urlhttps://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.
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”}
| PARAMETER NAME | MANDATORY | VALUE FORMAT | DESCRIPTION | EXAMPLE |
|---|---|---|---|---|
| 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) |