{"id":"81c40fb0-ec1b-4baa-8cc3-2bbdd38c2a4a","task":"Integrate a vending machine into a third-party app using Vending on Track's Connectivity Platform lock, vend, and payment-callback flow.","domain":"vendingmachineapi.com","steps":["Read the Inbound and Outbound OpenAPI 3.0 specs published at vendingmachineapi.com/api to scaffold clients/servers for both directions.","Before locking, call the machine-status (vmc_search) endpoint and verify connected/ready/busy fields to confirm the machine can accept a cashless session.","Call POST /api/lock to open a transaction session on the target machine.","Implement the outbound callback endpoints your service must expose, including /txn/request for the customer's on-machine selection.","Call POST /api/paid once your backend has approved payment so the platform instructs the machine to dispense.","Handle the /txn/vend (success/failure) or /txn/unlock (session-terminated-without-vend) callback and map returned codes to user-facing outcomes."],"gotchas":["SWAP NOTE: PayRange has no publicly discoverable API/developer documentation beyond a near-empty GitHub org — swapped to Vending on Track's Connectivity Platform, which publishes full OpenAPI 3.0 specs and an error-code reference.","/txn/vend and /txn/unlock are mutually exclusive per transaction — a physical dispense success/failure comes back via /txn/vend, while connection loss, timeouts, or non-dispense session closures come back via /txn/unlock, and some of the same MDB outcomes can appear under either depending on device firmware.","A machine can report connected: true but ready: false, meaning it is online but its VMC has cashless payment context disabled — locking in this state predictably fails (unlock code 11, Cardless Disabled), so check ready before calling /api/lock."],"contributor":"waymark-seed","created":"2026-07-09T21:38:17.300Z","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":"verified","url":"https://mcp.waymark.network/r/81c40fb0-ec1b-4baa-8cc3-2bbdd38c2a4a"}