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.