Programming Guide » History » Revision 14
Revision 13 (chin-yeh, 10/31/2011 02:13 PM) → Revision 14/15 (Soh Keong, 02/05/2013 08:51 AM)
{{toc}}
h1. Programming Guide
* [[programming_guide#Steps-By-Steps|Steps-By-Steps]] - describes how to integrate the SP web services APIs.
* [[API References]] - the API references of all of the APIs mentioned in the [[programming_guide#Steps-By-Steps|Steps-By-Steps]]
_Demo Application:_
> Query SP Balance : http://192.168.2.68:8080/TestPage/page/point/tw_sp_query.jsp
> Sales : http://192.168.2.68:8080/TestPage/page/point/tw_sp_sales.jsp
> Return/Exchange : http://192.168.2.68:8080/TestPage/page/point/tw_sp_return.jsp http://192.168.2.68:8080/sp-test/index.html
Below is the list of libraries needed:
* sp-stub - _download the latest stable version from_ "Nexus":http://192.168.2.13:8081/nexus/index.html
* sp-client - _download the latest stable version from_ "Nexus":http://192.168.2.13:8081/nexus/index.html
h2. Steps-By-Steps
h3. Query Utilization Status
This [[API_References#Query-utilization-status-of-the-Special-Bundle-Set|API]] checks if the member has already purchased the special bundle set.
*Steps:*
# This API requires the parameters:
** memberId
** countryCode
# Pass the required parameters into the method, [[API_References#Query-utilization-status-of-the-Special-Bundle-Set|isUtilized]]
# If the returned *status* is:
** *true* means it's been utilized
** *false* means it has not been utilized
h3. Utilize the Special Bundle Set
This [[API_References#Utilize-the-Special-Bundle-Set|API]] informs SP web services when the member has purchased the special bundle set.
*Steps:*
# [[API_References#Utilize-the-Special-Bundle-Set|Query the utilization status of the special bundle set]]
## if *not yet utilized*
### pass the following parameters to the method, [[API_References#Utilize-the-Special-Bundle-Set|flagSpecialSetUtilization]]:
**** dbConnection
**** orderId
**** countryCode
**** memberId
**** trxDate
### if the returned *status* is *0000*, it has been successfully processed
## if *utilized*, inform the member that he/she has purchased the bundle set.
h3. Return or Exchange Special Bundle Set
Invokes this [[API_References#Return-the-Special-Bundle-Set|API]] when the member return or exchange the special bundle set.
*Steps:*
# there's no need to query the utilization status
# pass the following parameters to the method, [[API_References#Return-the-Special-Bundle-Set|unflagSpecialSetUtilization]]:
** dbConnection
** orderId
** countryCode
** memberId
** trxDate
# if the returned *status* is *0000*, it has been successfully processed
h2. API References
See [[API References]]