TIMESTAMP

This variable will contain a time stamp of when the inbound call was received by our network. The date and time will be in yyyy-mm-dd HH:mm:ss format.

IMSI

This variable will contain the IMSI of the subscriber who has made the outbound call request.

TRANSACTIONID

This variable will contain a numerical ID as assigned by our network for the call authentication request.

CARRIERID

The carrier ID that has been assigned to you for use with our API.

MSISDN

This variable will contain the MSISDN of the subscriber who has made the outbound call request.

MCC

This variable will contain (if the data is available) the MCC country code of where the subscriber is located. For example 234 for the UK.

MNC

This variable will contain (if the data is available) the MNC operator code (The network name that the subscriber is logged onto). For example 18 for the Cloud9 Network.

TADIG

This variable will contain (if the data is available) the TADIG network code (The network identifier of the network that the subscriber is logged onto). For example GBWC9 for the Cloud9 Network.

REQUEST_TYPE

This variable will contain the API HTTP request type. For Outbound Call Back Call authorisation this will be AUTH_CALLBACK_CALL

CALLDESTINATION

This variable will contain the subscribers dialled destination in full international format prefixed with a '+' sign (e.g. +447xxx for the UK).

USER_BALANCE *

The amount of credit available to the user in £ and pence format (or $, cents or €, cents depending on the subscribers currency setings)
* If your system is holding the user balance then this variable can be ignored as it will be set to 0.00

IOT

If the user is in an IOT chargeable country then this variable will be set to 1 else this variable will be set to 0

IOT_CHARGE

If the user is in an IOT chargeable country then this variable will contain the IOT charge per minute that Cloud9 will change for the call. This charge is for IOT ONLY and doesn't include Cloud9's call termination charges. The charge is in UK Sterling in £0.00 format. Please add your markup to this charge when charging your users.

MSRN

The returned MSRN for the subscriber. The MSRN will be in full international format prefixed with a '+' sign (e.g. +447xxx for the UK). If the subscriber is off line this field will contain the value ‘OFFLINE’

ECC

This variable will contain a value of 0 or 1. If 0 then the Sim Call Control application was not used when the call was placed (so the user dialed the destination number suffixed with a '#') If 1 then the destination number was dialed by the Sim Call Control application.

<MOC_response>

The <MOC_response tag> is required so our system can detect your server’s XML reply.

<TRANSACTION_ID ></TRANSACTION_ID>

The transaction_id tag must contain the transaction ID we passed you within the HTTP request. In the above example this would be 1002.

<REQUEST_STATUS ></ REQUEST_STATUS>

The request status tag must contain either a 0 (zero) or 1 (one). 0 = Failure 1 = Success If set to 0 then our system will drop the call. If set to 1 then our system will process the call.

<ROUTING></ROUTING>

The routing tag tells our system how to route the call. 0 = Allow Cloud9 to route the call to the dialled destination. 1 = Route the call to an alternative destination. If set to 1 then the <route_to> tag must be populated with the re-route destination number.

<REROUTE_TO></REROUTE_TO>

If the <routing> tag is set to 1 then this field must be populated with the destination number you wish to route to. For example if the MSISDN 07700000000 is called and you with to re-route this to +441283220000, simply respond with +441283220000 within this tag. Please note that all destination numbers must be in international format prefixed with a '+'.

<DISPLAY_MESSAGE></DISPLAY_MESSAGE>

The display message tag needs to contain the message that you want displayed on the subscribers handset. You can use characters 0-9, a-z, A-Z '. , < > " () . The display message has a maximum limit of 159 characters. You must populate this field regardless of the request_status or routing tag settings.

<TIMER></TIMER>

The amount of duration in MINTUES that the call is allowed to stay open for.The maximum duration allowed is 60 minutes and the minimum duration allowed is 1 minute.

</MOC_response>

The </MOC_response> tag is required so our system can detect your server’s XML reply.

ERROR_MESSAGE

This variable needs to contain information to why the request could not be processed.