Scan A Coupon With Barcode & Validate
Your goal is scanning the 'unique' barcode with
your laser scanner on the clients mobile device,
which will trigger the validation. The clients mobile phone will
have to show the actual redemption, and you want
this action to tell your POS system to implement
the correct discount value..
- You want to be able to simply scan the 2D Barcode off the customer`s mobile phone or printed offer.
* Laser Scanner Is Connected To POS
A client that spots a digital coupon on his Pc, claims the coupon. He then clicks the print coupon button, to create a hard copy. Clicking the print button leads to a pdf that can be printed easily.
- Send the barcode value to our server
Send a POST request (with your client_id, client_secret and barcode value) to this URL: http://utap.at/api/json/r1/coupon/validate_via_scan_id.
- Both client_id and client_secret can be found in your account in the API section
- The url might contain "v1" instead of "r1" depending on the type of account you are using. The API section in your account will point out the exact version you’ll have to use.
- The barcode value is the barcode which the POS just scanned.
- Receive and process the server response
Let’s have a look at the possible server responses. The coupon can either be valid or not.
Let’s assume it’s valid first. The server responds with a "success=true". This means the barcode value was accepted by our servers and the coupon is now registered as "validated" (the barcode is no longer valid). Now is the time to tell the POS system to implement a discount value. The server response also contains the value of the discount within the "coupon_value" variable since a discount might differ when using "Scratch & Win" coupons.
In case our servers respond with a "success=false", you know of course that the scanned coupon was not valid. Question is: Why? A reason as well as a solution will be sent along with the response and can be found in de variables "reason" and "solution". These messages are textual, so they can be shown within the POS to assist the staff in finding a solution. An example of a "reason" would be: "Coupon already validated last Tuesday".
- That’s it
Let the POS system continue its normal functionality. The scanned barcode is of course no longer valid. So the scanning of the same barcode will result in a "success=false". To create these above steps, you will need to configurate your Point of Sale software.
Unique Bar Codes - Take Your Pick
An EAN-13 barcode is a 13 digit (12 data and 1 check) barcoding standard which is a superset of the original 12-digit Universal Product Code (UPC) system developed in the United States. The EAN-13 barcode is defined by the standards organization GS1.
These Barcodes enable retailers and QSR brands to redeem and track mobile coupons in real-time. Make your choice in the barcode type you want to embed within the mobile coupon. By integrating the QR2coupon Pos API you can redeem and validate by choosing from multiple Barcode standards like EAN 8 (7 digits) , EAN-13 (12 digits) UCPA (11 digits)
or Code 39 (Universal Variable Lenght).
To use our API you will need to use your Username and Encrypted Password
To find your username and password details; Login to your account and visit Validation API & Widget
|password||Your encrypted password (SHA1)|
|couponcode||Unique coupon code, eg 12ab56|
|couponid||Unique coupon ID 123456789012
(our barcode on validation page will automatic pass the unique coupon ID)
|type||Default: xml. (Check out our Json Restful API documentation ).|
|0||Coupon is valid.|
|1||Coupon was already validated.|
|2||Coupon not yet validated but coupon expiry date exceeded.|
|3||Couponcode not found.|
|0||Coupon was already validated.|
|1||Coupon was set to validated.|
|2||Couponcode not found.|
API error codes
|1000||Username and/or password was wrong.|
|1001||Account was disabled.|
|1002||Couponcode AND couponid was empty.|
|1003||No valid action.|
|1005||No valid type (only 'xml' allowed).|
|1006||You can only pass 1 search method; based on couponcode or based on couponid.|
|1007||CouponID or couponcode not found.|
BUY A CAMPAIGN!
BECOME OUR PARTNER!
GOING PRIVATE LABEL!
Excellent, our deal_creatives team can build that for you. Look around or
Order now >
We are looking for Sales Partner, worldwide. Check out our
Partner Program >
Do you have existing clients? We can offer your business a
Private Label package >
To email and display your campains, we offer a
Mobile responsive Directory >
|NO CREDITCARD REQUIRED||USE OUR 'SEASONDEALS' CAMPAIGN TEAM|
|Start your free no-risk trial!||Have our campaign team build the campaign for you|