Frequently Asked Questions
Activation
The FAQs in this section provide more information on the ‘Create an entitlement’, ‘Request activation info’ and ‘Activate an entitlement’ APIs.
The activation url is owned by the merchant. It should be unique per user.
10,000 characters.
The merchant can choose to allow the customer to migrate. The merchant would need to cancel the entitlement managed on the merchant side before allowing the customer to activate the entitlement with the reseller.
No, the activationInfo only returns the current values in the entitlement along with a refreshed activation url.
Entitlements will change status from PENDING to ACTIVE once the customer has completed sign up via the activation url. Bango can’t delay the activated date of the entitlement to some date in the future.
No, the activationInfo API only works on entitlements in PENDING status. The entitlementId will remain the same, along with a refreshed activation url.
Entitlements that have been terminated will move to a CANCELLED/REVOKED state and the entitlement no longer managed. If the customer subscribes in the future for the same service, a new entitlement would be created under the same customerIdentifier with a new entitlementId
No, the activation url is owned by the merchant and will only expire if they set an expiry date.
The merchant provides the reseller with the activation in a 200 response. The customer can then use this to access the service.
The activationInfo API will always return a valid activation url, with the urlExpiry parameter.
The customer can use the activation url to sign up as long as the entitlement has not already been activated and the url has not expired.
The entitlementId will be unique for each service they are entitled to. If a customer activates, cancels, and then reactivates, a new entitlementId will be generated. If a customer is allowed to hold more than one active entitlement for the same service, the entitlementId’s will be unique.
An entitlement would remain in PENDING until the point that either reseller or merchant sent another request to change the status eg terminate/activate entitlement.
If the reseller sends a “Create Entitlement” request, but the customer already has an ACTIVE entitlement with the same product key, and there is a restriction of 1 entitlement per customer.