The offer types and discount types, and what each means for the UI, are on Offer and discount types.
Get Coupons
The GET /v3/customers/{customerId}/coupons endpoint retrieves a list of available coupons for the user to display in your app. Without filters, the response contains all coupon types mixed together, including Game Rewards, App Coupons, Member Offers, and more.
You can also organise different coupon types into separate lists or sections within your app—just ensure they remain easily discoverable for users.
The response includes comprehensive data for each coupon, such as date intervals, activation limits, image URLs, and other details. We recommend creating:
- A minimalistic coupon card displaying only essential information to capture attention
- An expanded coupon details view showing complete terms and conditions
Activation
In the Admin Portal, offers can be configured as pre-activated, meaning the coupon is immediately ready for use without additional user actions.
For non-pre-activated offers, users must perform an activation step in the app. Simply add an action button to the coupon card UI that calls the POST /v3/customers/{customerId}/coupons/{couponId}/activate endpoint. After activation, indicate to the user that the coupon is ready for redemption during their next store visit.
Deactivation
Users can perform a deactivation step in the app. All coupons can be deactivated, including pre-activated. Deactivating the Coupon will make it not available for POS, allowing more gradual control into which coupons apply for a purchase. Simply add an action button to the coupon card UI that calls the POST /v3/customers/{customerId}/coupons/{couponId}/deactivate endpoint. After activation, indicate to the user that the coupon will not be redeemed during their next store visit, unless they activate it again. Last modified on October 19, 2026
