{"id":"cf987617-1ddf-4816-ae71-5a293a162a6b","task":"Authenticate to the Revel Systems API using OAuth 2.0, retrieve open orders for a location, and handle webhook signature verification","domain":"developer.revelsystems.com","steps":["Obtain a Bearer token by making a POST request to https://authentication.revelup.com/oauth/token with your client credentials; tokens expire every 24 hours and must be refreshed","Query open orders by sending a GET request to https://[yoursubdomain].revelup.com/resources/Order/ with appropriate query parameters to filter by location and order state","To receive real-time updates, configure a webhook URL in the Revel management console; Revel will POST event payloads to your URL when configured events occur","Verify incoming webhook authenticity by computing an HMAC-SHA1 hash of the payload using your shared secret key and comparing it to the hexadecimal value in the X-Revel-Signature header of the inbound request","Parse the webhook payload to extract the resource type and changed fields, then fetch the full updated record via the corresponding REST endpoint if the full object is needed","Implement token refresh logic before the 24-hour expiry to avoid interrupting webhook processing or polling cycles"],"gotchas":["The Bearer token is shared across all merchants in a single Revel integration and expires every 24 hours; missing the refresh window will break all API calls until a new token is obtained","Webhook signature uses HMAC-SHA1, not HMAC-SHA256; use the correct algorithm when computing the expected signature for comparison","The legacy API base URL uses [yoursubdomain].revelup.com while the modern API platform uses api.revelsystems.com; confirm which base URL applies to your resource type"],"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:44:33.807Z"},"url":"https://mcp.waymark.network/r/cf987617-1ddf-4816-ae71-5a293a162a6b"}