ActivateSubscriberReseller Usage
The ActivateSubscriberReseller interaction enables the client to activate a pending device that was added through some of the order equipment flows or a device that the customer already has.
The actual activation deals with activating the subscriber in the billing system so that the reseller's customer can use the device. Without the activation the device is rendered useless because the reseller's customer cannot use it on Mobility's network. The account associated with the device will belong to the reseller. Mobility may not have much if any information about the reseller's customer.
The reseller may have previously reserved a subscriber number for use during the activation; this is not a requirement and if a subscriber number is not provided, the activation flow will activate a random number from the number pool. The BAN associated with the activation will be determined by the billing system.
This is an asynchronous service. The partners will send the ActivateSubscriberReseller request and will get back an immediate response that acknowledges the receipt of the request for further processing.
If any exceptions occur, an error will be returned to the client instead of the response. As processing of the original request continues to completion, the client will receive one or more response messages via a request-response message - posted to the web service URL provided in the returnURL element of the MessageHeader in the original ActivateSubscriberReseller request from the client. The client is expected to acknowledge the receipt of each asynchronous response message using the standard acknowledgement.
Use Cases
These are some examples of using the ActivateSubscriberReseller API for device activation:
New Device Activation
Suppose a reseller has sold a new device to a customer and the customer wants to start using it on the mobility network. The ActivateSubscriberReseller API activates the new device in the billing system. This can be used in conjunction with other APIs, which assign a new (ReserveSubscriberNumber) or existing (AddPort) phone number to the device. Once the new device is activated, the customer can use it on the Mobility network.
Activating a Customer-Owned Device
Suppose a customer already owns a device and wants to switch to the reseller's services. The ActivateSubscriberReseller API activates the customer's device in the billing system. A subscriber number is either provided in the API call, or randomly assigned from the number pool. Once the customer's device is activated, it can be used on the Mobility network.
