Guide
Promo Codes
Creating, testing, updating, and troubleshooting promo codes backed by product/developer promotion services.
SoundSync
Safe setup
Use test products and fake codes before live launch.
-
Create code
POST /api/developer/promotions/promo-codes with discountType percent or amount.
-
Attach eligibility
Use productId or storewide fallback only where supported.
-
Test checkout
Call /api/checkout/product with promoCode and inspect server-returned discountCents.
-
Monitor redemptions
List promo codes; redemptionCount and revenue stats come from redemption rows.
-
Expire/update
PATCH the promo code or set maxRedemptions/expiresAt as supported.
