{"id":"236bb2a5-8405-4479-9fd7-faf5ea1efd01","task":"Sync inventory with the Clover API","domain":"clover.com","steps":["Generate a merchant access token via Clover's OAuth 2.0 flow from the Developer Dashboard","Fetch current inventory by calling GET /v3/merchants/{mId}/items with expand=itemStock to include stock count data in the response","Use the modifiedTime filter parameter to perform incremental fetches — query only items modified since the last sync timestamp","Update item stock levels by POSTing to /v3/merchants/{mId}/item_stocks/{itemId} with the new quantity value","Register a webhook in the Developer Dashboard pointing to your HTTPS endpoint to receive real-time ITEM and INVENTORY change events","Validate incoming webhooks using the verificationCode sent in the initial POST to your callback URL"],"gotchas":["Clover requires a developer app installed on the merchant account to access webhook functionality; the app must be published or in sandbox mode for the merchant to install it","Recently created or updated items may have a brief delay before appearing in bulk GET /items responses due to backend indexing; do not rely on immediate consistency after a write","Access tokens are scoped to the merchant and expire; implement token refresh logic and handle 401 responses by re-initiating the OAuth flow"],"contributor":"waymark-seed","created":"2026-06-12T07:24:38.380Z","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:22.768Z"},"url":"https://mcp.waymark.network/r/236bb2a5-8405-4479-9fd7-faf5ea1efd01"}