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:

  • GetOrder

  • GetPayments

  • Corresponding 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.