LICENSES (IN-APP & SUBSCRIPTIONS)

***This page has been removed from the VDC due to the Verizon Apps shutdown. Feel free to browse our other development areasdevicesAPIs and Tools.***

VERIZON APPS SUNSET

***NOTE: Effective November 1st, 2012, the VDC no longer accepts new Verizon App submissions. Additionally, beginning December 2012, final billing to customers for all existing Subscriptions and In-App Purchase apps will occur, and all paid Subscriptions and In-App Purchase API apps will be removed from the catalog on November 1st, 2012. Customers will receive a final full month of use & access, before Verizon Apps begins its complete shutdown in January 2013.

For additional details, please review the Verizon Apps Notice and Verizon Apps Transition Timeline.***

LICENSES

In order to access the license and result fields of LicenseAuthenticator.CheckLicenseResult that is returned from the purchaseInAppContent method, use the getLicense() method call that returns the signed license String.  This string is an XML representation of the license and contains a multitude of important fields including MDN, MEID, Keyword, License terms, Purchase date, etc. 

 

Refer below to a sample of the license result that is returned, note the signature is after the closed License tag:

    

 <License><MDN>9085551111</MDN><MEID>11111111111111</MEID><RCID>404001</RCID><Name>Movie Rentals on your phone</Name><Keyword>mSpotMovies105</Keyword><IsPurchaseRequired>true</IsPurchaseRequired><IsSubscriptionExpired>false</IsSubscriptionExpired><IsLimitedTimeExpired>false</IsLimitedTimeExpired><IsUsageConsumed>false</IsUsageConsumed><Price>$4.99 per download</Price><PriceType>Recurring Downloads</PriceType><PricingTerms>unlimited uses of 1 download</PricingTerms><IsFree>false</IsFree><IsTrial>false</IsTrial><IsOnDevice>true</IsOnDevice><IssueTime>2011-04-13T21:03:39</IssueTime><PurchaseDate>2011-04-13T20:14:44</PurchaseDate><NextCheckTime>2011-06-13T21:03:39</NextCheckTime></License>��@g�*t��Yv�'P��_;�o���0H/�16�2_�x�a��㶪U��t�Ze����pn�kqH?=�{a��D�>2"�$A��|�+�Fkl���p��'(9�۱��Y|%ì?³ï¿½×?À?��saMx��

 

The purchaseInAppContents() method returns standard integer error codes that can be used to make decisions about what to display to the end user, refer below to a sample and javadocs in SDK for more detail:

 

•       LICENSE_OK: license is valid

•       LICENSE_NOT_FOUND:  license invalid

•       LICENSE_TRIAL_OK: trial license valid

•       ERROR_UNABLE_TO_CONNECT: couldn’t contact license server, try again

•       ……..

 

Licenses will also grow as end users purchase additional In-App items.  Each new item is appended to the license file in an <InApp> element within an <InAppList> element.  If a new purchase is made the Verizon Apps service will return a new license to the device.

 

<InAppList><InApp><MDN>1234567890</MDN><MEID></MEID><RCID>Z452500</RCID><Name>inApp1</Name><Keyword>Z352501</Keyword><IsPurchaseRequired>false</IsPurchaseRequired><IsSubscriptionExpired>false</IsSubscriptionExpired><IsLimitedTimeExpired>false</IsLimitedTimeExpired><IsUsageConsumed>false</IsUsageConsumed><Price>$4</Price><PriceType>First Download</PriceType><PricingTerms>First Download</PricingTerms><IsFree>false</IsFree><IsTrial>false</IsTrial><IsOnDevice>false</IsOnDevice><IssueTime>2011-08-01T18:25:29</IssueTime><PurchaseDate>2011-08-01T18:26:00</PurchaseDate><NextCheckTime>2011-09-01T18:26:00</NextCheckTime><InAppName>testInAppName1</InAppName><InAppSKU>testInAppSku1</InAppSKU><InAppParentId>testContent</InAppParentId><PurchaseId>testPurchaseId</PurchaseId>

        </InApp>

 …….

…….

</InAppList>