The Bango Resale API is RESTful, uses UTF-8 JSON to encode parameters and response values, and includes features to help you test your integration. (Make sure you understand the connectivity requirements for accessing the Bango Platform.)
The Bango Resale API supports both synchronous activation of services (where no user interaction is required) and asynchronous activation (where user interaction is required, such as following a merchant-supplied sign-up link). In the API, a user’s ability to access a merchant’s service is represented as an abstract “entitlement” record which is always in one of several states. API calls can update the record and modify the state to reflect changes in a user’s entitlement to access the service.
Here’s a diagram showing an asynchronous activation.
In this example, the merchant requires a user to sign up before the service is activated. This means your initial request to create an entitlement returns an entitlement record with status PENDING, along with a request to send the user to a particular URL supplied by the merchant. Your initial request should also include a URL under your control: the Bango Platform uses this to notify you of subsequent changes to the entitlement. When the merchant confirms to the Bango Platform that the user has signed up, the Bango Platform sends an updated entitlement record (with status ACTIVE) to the notification URL.