CurrentAppSimulator.RequestAppPurchaseAsync Method

Creates the async operation that enables the user to simulate the purchase of a full license for the current app.

Syntax

public:
static IAsyncOperation<String^ >^ RequestAppPurchaseAsync(
         bool includeReceipt
)

Parameters

includeReceipt
Type: bool

Determines if the 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

Uses the CurrentApp/ListingInformation/App element in WindowsStoreProxy.xml as the data source for the members of the returned object.

If the purchase transaction succeeds, the license state is updated only in memory. The contents of WindowsStoreProxy.xml are not changed.

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 Name	Description	Child Elements	Attributes
Receipt	Contains information about app and in-app purchases	AppReceiptProductReceiptSignature	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.
AppReceipt	Contains 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.
ProductReceipt	Contains information about in-app 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.
Signature	Contains the signature for the receipt and information on how the receipt was digitally signed.	SignedInfoSignatureValue	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

Namespace: Windows.ApplicationModel.Store

Metadata: windows.winmd