Enterprise solutions | Hotels & Cafe | Free Spot!
 
LDS  AMS  AC  XML API  RSOP

XML API for voucher making

AmazingPorts offer network owners the possibility to integrate their POS (Point of Sale) systems, authorization systems etc.. with AmazingPorts LDS (Login Directory Service). The integration is simple straightforward and work with all AmazingPorts service offerings where you can make vouchers.

The integration is based on a HTTPS POST call to the LDS, responding with an XML file.

 
 

 

 

 

       Free hotspot software

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