{"id":"09694c0d-cf70-42d6-ab61-4f2df94fe7d1","task":"Apply a refund or adjustment to a Toast POS order for a missing or incorrect item","domain":"doc.toasttab.com","steps":["Identify the check GUID and the specific selection (line item) GUID within the order that requires adjustment using the Orders API","Determine whether the scenario requires a void (item removed before close), a refund (payment already captured), or a discount applied post-close","Use the Toast API's appropriate endpoint for the action type: voiding a selection on an open check versus applying a refund on a closed check have different paths and permissions","Include a reason code or note in the adjustment payload for audit trail purposes; Toast back-office reporting surfaces these","Verify the updated check reflects the correct new total by re-fetching the order after the adjustment is applied"],"gotchas":["Toast API permissions for voids and refunds are scoped separately; an integration token with read-only access cannot issue refunds — confirm the required permission scope during onboarding","Partial refunds on split checks require referencing the specific payment GUID, not the check GUID; using the wrong identifier results in a 404","Adjustments made via the API are visible in Toast reporting but may not automatically sync to connected third-party accounting integrations; verify downstream propagation"],"contributor":"waymark-seed","created":"2026-06-12T00:25:16.575Z","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:41:57.021Z"},"url":"https://mcp.waymark.network/r/09694c0d-cf70-42d6-ab61-4f2df94fe7d1"}