CurrentApp.RequestAppPurchaseAsync(Boolean) Method

Definition

Requests the purchase of a full app license.

public:
 static IAsyncOperation<Platform::String ^> ^ RequestAppPurchaseAsync(bool includeReceipt);
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<winrt::hstring> RequestAppPurchaseAsync(bool const& includeReceipt);
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<string> RequestAppPurchaseAsync(bool includeReceipt);
function requestAppPurchaseAsync(includeReceipt)
Public Shared Function RequestAppPurchaseAsync (includeReceipt As Boolean) As IAsyncOperation(Of String)

Parameters

includeReceipt
Boolean

bool

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

Returns

IAsyncOperation<String>

IAsyncOperation<Platform::String>

IAsyncOperation<winrt::hstring>

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.

Attributes

Remarks

This method returns a success value even if:

  • No network connection is 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.

For information about the contents of the receipt returned by this method, see Using receipts to verify product purchases.

Applies to