Skip to content

feat: add discoverable available discounts to discount extension#609

Open
hemanth wants to merge 1 commit into
Universal-Commerce-Protocol:mainfrom
hemanth:feat/available-discounts
Open

feat: add discoverable available discounts to discount extension#609
hemanth wants to merge 1 commit into
Universal-Commerce-Protocol:mainfrom
hemanth:feat/available-discounts

Conversation

@hemanth

@hemanth hemanth commented Jul 17, 2026

Copy link
Copy Markdown

Closes #346

Summary

Adds an available array to the discount extension's discounts_object, allowing businesses to surface discoverable promotions before the buyer applies a code.

Changes

  • source/schemas/shopping/discount.json:
    • Added available_discount definition with id, title, type (automatic/code), conditions, applied, and remaining_amount
    • Added available array to discounts_object (response-only via ucp_request: omit)

Use cases

  • Agent tells buyer: "There's a 15% off summer sale running"
  • Agent prompts: "Add $12 more for free shipping"
  • Automatic discounts surfaced so the buyer knows they're getting a deal
  • Code-based offers hint at existence without exposing the code

Design decisions

  • Business-optional: merchants that don't want to expose promotions just omit the field
  • Response-only (ucp_request: omit) — this is purely informational from business to platform
  • type: code exposes the existence of a promotion but NOT the code itself
  • remaining_amount enables threshold-based prompts ("add $X more for...")

@damaz91 damaz91 added the status:needs-triage Signal that the PR is ready for human triage label Jul 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

status:needs-triage Signal that the PR is ready for human triage

Projects

None yet

Development

Successfully merging this pull request may close these issues.

No way to discover available discounts before applying codes

2 participants