paymentservice_check_existing()

Determine whether a subscription digital good is currently active.

Synopsis:

#include <bps/paymentservice.h>
 
BPS_API int paymentservice_check_existing(const char *digital_good_id,
                                          const char *digital_good_sku,
                                          const char *group_id,
                                          unsigned *request_id)

Since:

BlackBerry 10.0.0

Arguments:

digital_good_id

The digital good ID. To check the status of a subscription app (not a digital good), use PAYMENTSERVICE_APP_SUBSCRIPTION as the digital_good_id parameter.

digital_good_sku

The digital good SKU.

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_check_existing() function determines whether a subscription digital good is currently active. Only the ID or SKU of the digital good is required as input in order to retrieve the subscription status of a digital good. If both are provided, then the ID takes precedence, and the SKU will only be used in case the digital good cannot be retrieved using the ID.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno value set otherwise.

Last modified: 2014-09-30



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus