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)
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:
libbpsDescription:
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.