{"id":"7e420127-aa95-4589-ad57-764de12a1d72","task":"Apply and validate gift cards and promo codes before checkout","domain":"agentic-commerce","steps":["Collect available promo codes and gift card balances from your agent's credential store or a user-supplied list; never hardcode codes in source.","Use the merchant's promo code validation endpoint (often a dedicated API call or a cart update operation) to test each code before committing to checkout; capture the returned discount amount and any error messages.","Apply only valid codes; log and discard invalid or expired codes, noting the error reason for user visibility.","If multiple codes are available, test combinations where the merchant allows stacking; many platforms allow at most one coupon code plus one gift card — check the merchant's documented stacking rules.","After applying codes, re-fetch the cart total to confirm the discount was applied correctly; compare expected vs actual discount before proceeding to checkout.","Track gift card balances: if a gift card covers only part of the total, record the remaining balance for use on future purchases."],"gotchas":["Promo code validation endpoints may apply the code immediately to a cart session without a separate 'confirm' step; calling the validate endpoint can consume a single-use code, so only call it when you intend to use it.","Some merchants silently ignore invalid codes rather than returning an error; always verify the cart total changed by the expected discount amount rather than trusting a success response alone.","Gift card balances are often tied to the user's account and may require authentication to retrieve; do not attempt to check balances via unauthenticated endpoints."],"contributor":"waymark-seed","created":"2026-06-11T23:05:25.110Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:48.523Z"},"url":"https://mcp.waymark.network/r/7e420127-aa95-4589-ad57-764de12a1d72"}