====== IVR Technical description ====== ===== 1. General information ===== The principle that lies behind the service of IVR call is designed for those cases when no other method is available.of all mobile The disadvantage of this approach is that the sending of reply SMS is impossible. The advantage of such method is the option of setting higher rates for each call. Currently the service of IVR call is available for subscribers of all cellular networks and telecommunication providers in Israel. ===== 2. The service description ===== - The end user is forwarded to the instruction page where he receives complete information on the service. - The end user chooses the activity period of the requested service. Depending on the service cost, the text of the code and the IVR number vary. - The end user enters the number, given on the instruction page, and following the instruction, enters the code for the service activation. - Finishing the call the subscriber enters his phone number on the website in order to receive the activated service. ===== 3. How it works ===== 1. The moment the subscriber calls to the IVR number, provided on the instruction page, his phone account is being charged. Following the instruction the subscriber has to enter the service code, which is also provided on the website. 2. After the call the subscriber enters his phone number on the website. 3. Considering that IVR system is running on sms:transit service, parameters described in technical information at http://smscoin.net/info/smstransit-tech/ are passed to Result URL. * Please, note that the number the call was made to is passed within shortcode parameter. This implies that your handler should include processing function of numbers which start with 0; * Billing = MO parameter is constant, so confirmation script of SMS status Status URL is not used; * When using IVR service it is impossible to send SMS with a code, as long as reply from the handler is ignored. 3.1 The transaction is passed to Result URL with MO billing type. In case the transaction from the subscriber's number was passed to Result URL, the service is considered to be paid for and should be provided to the subscriber. 3.2 If the transaction is not passed to Result URL, it means this transaction wasn't paid for or its delivery is delayed. In this case you should offer the end user to reenter his phone number (upon the expiry of 1 minute). 4. The identification of this transaction is possible by shortcode parameter upon the request to Result URL and by billing = MO parameter. ===== 4. Available rates ===== Available rates are: 25, 30, 35, 39, 45, 50, 60, 72, 79, 99 NIS incl. VAT. Each rate is assigned to specific IVR number given in the instruction. Currently 2 languages are available: Russian and Hebrew. Unfortunately, the option to switch the languages while calling to IVR number is not implemented yet. Thus, different phone numbers with corresponding interface language should be set for each language. ===== 5. Promotion ===== When calling to 0123456... the end user is to enter the service code (for instance, 10000 + any 4 digits, for ex.: 100005897). It is important to provide the last 4 digits randomly. The phone number of IVR payment service, given in the instruction, varies according to the following parameters: * rate * language.