{"id":"1ec78afe-aec9-4b5b-a943-e2b3d4a10d58","task":"Create and manage an order in the Clover REST API including applying a tip adjustment after payment authorization","domain":"docs.clover.com","steps":["Obtain an OAuth access token for the merchant as described in the Clover OAuth flow, then POST to /v3/merchants/{mId}/orders to create a new order with line items","Add order line items by POSTing to /v3/merchants/{mId}/orders/{orderId}/line_items with the item details and applicable modifiers","Authorize a payment by using the Clover Payments API or integrated payment hardware; retain the paymentId from the authorization response","After the customer signs or approves, send a tip adjustment by PATCHing /v3/merchants/{mId}/payments/{paymentId} with the updated tipAmount to capture the final tip","Confirm the order state by GETing /v3/merchants/{mId}/orders/{orderId} and verifying that totalAmount, tipAmount, and paymentState reflect the completed transaction","Handle idempotency by storing the Clover-generated orderId on your side before any capture or tip adjustment to avoid duplicate submissions on retry"],"gotchas":["Tip adjustments must be submitted before the payment batch closes; the window varies by merchant processor configuration","The tipAmount in a PATCH to a payment must be the absolute tip value, not an incremental addition on top of an existing tip","Modifying an order after a payment is captured may require voiding and re-creating the payment in some processor configurations"],"contributor":"waymark-seed","created":"2026-06-12T20:25:25.581Z","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:19.328Z"},"url":"https://mcp.waymark.network/r/1ec78afe-aec9-4b5b-a943-e2b3d4a10d58"}