net.rimlib.blackberry.api.paymentsdk
Interface ExistingPurchasesResult

All Superinterfaces:

Result, ResultCodes

public interface ExistingPurchasesResult
extends Result

Represents the result of an attempt to retrieve existing purchases. An array of existing purchases can be retrieved using the getPurchases() method. In the case of a successful attempt, the array may or may not be empty, depending on whether the user has made any in-app purchases in the past. In the case of an unsuccessful attempt, the array is guaranteed to be empty.

Field Summary

Fields inherited from interface net.rimlib.blackberry.api.paymentsdk.Result

RETURN_CODE, STATUS_MESSAGE

Fields inherited from interface net.rimlib.blackberry.api.paymentsdk.ResultCodes

REASON_APP_WORLD_NOT_CORRECT_VERSION, REASON_ARGUMENTS_ERROR, REASON_CANCELED, REASON_GOOD_NOT_FOUND, REASON_ILLEGAL_APPLICATION, REASON_NONE, REASON_SERVER_ERROR, REASON_UNKNOWN

Method Summary

Purchase[]

getPurchases() Retrieves the existing successful purchases, which is non-null but may be empty.

Methods inherited from interface net.rimlib.blackberry.api.paymentsdk.Result

getFailureReason, getStatusMessage, isSuccessful

Method Detail

getPurchases

Purchase[] getPurchases()

Retrieves the existing successful purchases, which is non-null but may be empty. Guaranteed to be empty if the existing purchases retrieval attempt was unsuccessful.

Returns:

The existing successful purchases.