Add to wallet service
API provides a simple way for adding items to the consumers mobile wallet. The concept is similar to book marking in the cloud, except that the items added to the wallet are transactional in nature. That is the items on the wallet are presentable to a merchant for the purchase of goods and services.
Header Format:
<HttpHeaders>
<username>testuser</username><password>testpass</password><clientid>888</clientid>
</HttpHeaders>
Request Format:<
<AddToWalletRequest><action>add</action>
<promoid>7</promoid>
<key>raj.narayanasamy1@bswci.com</key><itemtype>T</itemtype>
<contentUrl>http://showAsset.com</contentUrl>
<contentxml></contentxml>
<barcodeUrl>http://showAssetBarCode.com</barcodeUrl>
</AddToWalletRequest>
Response Format:
<AddToWalletResponse><requestStatus>000</requestStatus></AddToWalletResponse>
FAQ
What are the typical uses of this API?
This API can be used to add tickets, memberships(regular or promotional)
coupons, gift certificates, pick up/purchase receipts and more.
What is the cost of this API?
There is no cost to using this API. However if SMS confirmation message needs to be sent, the user of the API will need to pay for the SMS messages upfront. So there will be very low monthly charges once you exceed 100 messages per month.
What is required to add an Item to the wallet?.
You will need content URL and Barcode URL – both URLs formatted for properly display on mobile devices.
Will you help in generation of the barcodes?
If your current systems is not generating barcodes you could use content xml instead of content url and barcode url. Content xml will be used to generate barcode data.
What are the other limitations on the content URL? Or Barcode URL.
Content URL Page can contain, your company logo or an image that can be used to identify your brand. The URL cannot contain more than one image. Size of the image needs to be less than 10k. Other than that, remaining information needs to relevant to the type of item being added. No advertisements are allowed. Limit on the size of the URL will be enforced to provide good experience on mobile devices.
What is the test URL for the Serivce?
db2.cardlesspay.com/serices/XMLService.
How do I verify my item is added to the mobile wallet?
Use the url://db2.cardelsspay.com:8080/wallet
This can be tried from your Smart Phone as well.
Is barcode URL necessary to add an Item to the wallet?.
Not required
How do I Process the barcodes?
If you are generating the barcode you are responsible for providing the software that helps in decoding the barcode and feeding it to the appropriate system. However we can help you do that.
1. Using the content XML for generating the barcode. Content XML follows a certain format, that we know how to process and you can use one of our pre built application to scan and process the barcodes, with out any effort on your part
2. You can provide a call back URL that will be used post the scanner results in decoded format, which you can use for further processing
