cURL
Burn Coupon
Mark a coupon as used/consumed to prevent further usage.
POST
cURL
This API marks a coupon as used/consumed, preventing it from being used again. This is typically called after a successful transaction to ensure the coupon cannot be reused.
Channel Merging Available
If your system uses different customer IDs across multiple channels (e.g., online and offline), Gameball’s channel merging feature helps unify customer profiles. By including the customer’s mobile number or email (based on your merging configuration) with each request, Gameball will combine activities into a single profile.For more information, head to the Channel Merging Guide.
If your system uses different customer IDs across multiple channels (e.g., online and offline), Gameball’s channel merging feature helps unify customer profiles. By including the customer’s mobile number or email (based on your merging configuration) with each request, Gameball will combine activities into a single profile.For more information, head to the Channel Merging Guide.
Path Parameters
The coupon code to burn/mark as used.
Request Body
Unique identifier for the customer that you can reference across the customer’s whole lifetime. Could be a database ID, random string, email or anything that uniquely identifies the customer.
Customer’s email address.
This is required if your account uses email-based channel merging.
Customer’s mobile number.
This is required if your account uses mobile-based channel merging.
Reference ID for the locked coupon, if the coupon was previously locked.
Pin code required for the coupon, if applicable.
Response
Whether the coupon was successfully burned/marked as used.
Timestamp when the coupon was burned.