The Request

https://lds.AmazingPorts.com/partner/issuexmlcoupon.action?offeringId=xyz&validMinutes=10

This service requires a login(username & password), which you obtain during the registration process of the Access Controller

Parameter	Required?	Default value	Explanation
offeringId	Mandatory	n/a	The ID of the service the voucher should carry  - Service Id's are unique to every HotSpot owner, and are provided as a part of the registration process of the Access Controller
validMinutes	Optional	15	The number or minutes from "now" that the voucher should be valid - defaults to 15 minutes if omitted. Note that this does not limit the service offering of a voucher, it only limits when a voucher can be activated by a user.

The Response

The response to the call is an XML file with the following structure:

 <coupon
     formatted-code="6JH THS K89 sdg"
     serial-number="11392"
     valid-from="2007-01-22T18:55:17"
     valid-to="2007-01-22T19:05:17" >
           <offering
                name="1 hour Internet Access"
                description="Gives one hour  Internet access" />
           <issuer
                first-name="John"
                last-name="Doe"
                partner="Company Ltd" />
</coupon>

Name	Example value	Explanation
coupon/formatted-code	6JH THS K89 sdg	The voucher code used to activate the service offering. It is case sensitive. Spaces are added for simple reading, and later automatically removed by the system when entered.
coupon/serial-number	11392	The serial number number of the voucher
coupon/valid-from	2007-01-22T18:55:17	The date and time from which the voucher is valid
coupon/valid-to	2007-01-22T19:05:17	The date and time to which the voucher is valid. Note that this example coupon is valid for 10 minutes.
coupon/offering/name	1 Hour Internet Access	The name of the offering the coupon is valid for
coupon/offering/description	Gives one hour Internet access	A description of the service
coupon/issuer/first-name	John	The first name of the issuer
coupon/issuer/last-name	Doe	The last name of the issuer
coupon/issuer/partner	Company Ltd	The name of the partner that issued the voucher