Where to find coupon codes and discounts in orders, payments, and webhooks
Last updated: July 10, 2026
Where to find coupon codes and discounts in orders, payments, and webhooks
If a player applies a coupon or discount code at checkout, the coupon information is now exposed in the order APIs and related webhooks.
Supported surfaces
You can retrieve coupon visibility from the following endpoints and events:
GetOrderGetPaymentsCorresponding order/payment webhooks, including
item.add
What is included
For eligible paid orders, the payload includes coupon information such as:
The coupon code
The discount amount
Important distinction
This is different from the coupon.redeemed webhook, which is used for free item redemptions. If you need to track discount codes applied during checkout for paid orders, use the order APIs or corresponding webhooks such as item.add.
Common use case
This is useful for analytics, attribution, and downstream reporting systems that need to store which checkout promo code was used on a paid order.