verifyIssuedCoupon

Validate a coupon identifier. The function verifies that the coupon has indeed been issued previously (using saveIssuedCoupon), that it has not expired, and that it has not been redeemed yet (using redeemIssuedCoupon).

If coupon has not been issued, returns error 1040. If coupon has been redeemed already, returns error 1041. If coupon has expired, returns error 1045. If coupon is valid, returns error 0.

Input parameters

Parameter name Description Possible value Required
uniqueIdentifier Unique identifier of the coupon. Typically this is printed on the coupon as a barcode. String (20) yes

Response

Field name Type Description
issuedCouponID integer Internal ID of the validated coupon. This does not need to be checked however - it suffices to make sure that verifyIssuedCoupon() returns error code 0.
couponID integer ID if the coupon code.
uniqueIdentifier String (20) Identifier of the coupon, same that was passed as input parameter.
campaignName string
expiryDate ISO date (yyyy-mm-dd)