CurrentApp.RequestAppPurchaseAsync | requestAppPurchaseAsync method

Applies to Windows and Windows Phone

Requests the purchase of a full app license.

Syntax


public static IAsyncOperation<string> RequestAppPurchaseAsync(
  bool includeReceipt
)

Parameters

includeReceipt

Type: Boolean [JavaScript] | System.Boolean [.NET] | Platform::Boolean [C++]

Determines if this method should return the receipts for this app.

Return value

Type: IAsyncOperation<String>

If the includeReceipt parameter is set to true, this string contains XML that represents all receipts for the app and any in-app purchases. If includeReceipt is set to false, this string is empty.

Remarks

This method returns a success value even if:

  • there's no network connection available
  • the user cancels out of the dialog
  • the user's authentication fails
You should treat a success result as indicating the async process completed without errors. To ensure that the transaction itself was successful, check the LicenseInformation element in the returned receipt.

The XML-formatted string that this method returns uses these elements:

Element NameDescriptionChild ElementsAttributes
ReceiptContains information about app and in-app product purchases

AppReceipt

ProductReceipt

Signature

Version: The version number of the receipt.

CertificateId: The certificate thumbprint used to sign the receipt.

ReceiptDate: Date the receipt was signed and downloaded.

ReceiptDeviceId: Identifies the device used to request this receipt.

AppReceiptContains information about an app purchase.None.

Id: Identifies the purchase.

AppId: The Package Family Name value that the OS uses for the app.

LicenseType: Full, if the user purchased the full version of the app. Trial, if the user downloaded a trial version of the app.

PurchaseDate: Date when the app was acquired.

ProductReceiptContains information about in-app product purchases.None.

Id: Identifies the purchase.

AppId: Identifies the app through which the user made the purchase.

ProductId: Identifies the product purchased.

ProductType: Determines the product type. Currently only supports a value of Durable.

PurchaseDate: Date when the purchase occurred.

SignatureContains the signature for the receipt and information on how the receipt was digitally signed.

SignedInfo

SignatureValue

This element is a standard XML-DSIG construct. It contains a SignatureValue element, which contains the signature you can use to validate the receipt.

 

To verify a receipt's authenticity, you can check the receipt's signature using the public certificate. To get this certificate, use the following URL:

https://go.microsoft.com/fwlink/p/?linkid=246509&cid=<CertificateId>

where <CertificateId> is the CertificateId of the receipt.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Namespace

Windows.ApplicationModel.Store
Windows::ApplicationModel::Store [C++]

Metadata

Windows.winmd

See also

CurrentApp

 

 

Show:
© 2014 Microsoft