paymentservice_get_existing_purchases

Retrieve the previous successful purchases.

Synopsis:

#include <bps/paymentservice.h>

BPS_API int paymentservice_get_existing_purchases_request(bool allow_refresh,
                                                          const char *group_id,
                                                          unsigned *request_id)

Since:

BlackBerry 10.0.0

Arguments:

allow_refresh: A value of true specifies that the device should be allowed to refresh the list of purchases from the Payment Service server, When a value of false is specified, the current list of cached purchases is returned immediately.

group_id: The window group ID of the application. This ID is required so that the Payment Service can properly display dialogs.

request_id: The Payment Service populates this argument upon successful completion of the request with the request ID. It can be used to correlate the response to the request.

Library:

libbps (For the qcc command, use the -l bps option to link against this library)

Description:

The paymentservice_get_existing_purchases_request() function retrieves the previous successful purchases made by the end user from within the calling application.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno value set otherwise.