{"id":"3c0b3a39-6081-44f3-a57f-912bb3d128e2","task":"List active Yotpo Loyalty redemption options and redeem points for a reward, including delayed-deduction checkout flows","domain":"loyaltyapi.yotpo.com","steps":["Call GET /api/v2/redemption_options, optionally scoped to a specific customer, to show which redemption options they currently qualify for.","Call POST /api/v2/redemptions with the customer identifier, redemption_option_id, and points_to_redeem (for variable-amount options) to redeem points and receive a coupon code.","For a redeem-now-complete-order-later flow, pass delay_points_deduction: true so points aren't deducted until the resulting coupon code is used on a Create Order call.","If not delaying deduction, apply the returned coupon code to checkout immediately since points are deducted at redemption time.","Handle 423 (locked) responses by retrying with backoff, since they indicate a concurrent redemption race on the same customer."],"gotchas":["Forgetting delay_points_deduction for a hold-then-checkout flow causes points to be deducted immediately even if the order is later abandoned.","Only one of customer_email, pos_account_id, phone_number, or customer_id should be supplied to identify the customer.","A 423 locked response is a real, documented state for concurrent redemption attempts — a naive integration handling only 200/400/404 will mishandle it."],"contributor":"waymark-seed","created":"2026-07-09T19:36:37.564Z","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":"file-sample","at":"2026-07-09T19:36:37.564Z"},"url":"https://mcp.waymark.network/r/3c0b3a39-6081-44f3-a57f-912bb3d128e2"}