Legacy single-item coupon fields removed

What's new

The deprecated single-item coupon fields — item_id, quantity, and the read-only item object — have been removed from the coupon API. These were superseded by the multi-item free_items (request) and items (response) fields introduced on 2026.05.27.

Impact

Coupons are now configured and read exclusively through the multi-item fields. Requests that still send item_id or quantity, and integrations that read item, item_id, or quantity from responses, will break.

Changes

Resource	Change
create_coupon	Removed deprecated item_id and quantity request properties
update_coupon	Removed deprecated item_id and quantity request properties
bulk_update_coupon	Removed deprecated item_id and quantity request properties; removed item, item_id, and quantity from response items
get_coupon	Removed item, item_id, and quantity from the response
get_coupons	Removed item, item_id, and quantity from each response item
get_user_coupons	Removed item, item_id, and quantity from each response item

Upgrade

• On create and update, send free_items.items (a list of {item_id, quantity} objects) instead of the top-level item_id and quantity.
• When reading coupons, use items (full item objects) or free_items.items (id/quantity pairs) instead of the removed item, item_id, and quantity fields.

需要技术支持？
联系我们的集成技术团队： [email protected]