Undo an approved payment-method correction
Applies an unchanged, explicitly approved undo preview for one exact payment source.
Applies an unchanged, explicitly approved undo preview for one exact payment source. Use the same apply contract with action=undo, confirmed=true, the unchanged preview fingerprint, expected revision, expiry, reason, and a UUID idempotency key. Undo writes a reversal in the immutable correction ledger and rechecks the resulting report; it preserves unrelated corrections for the same day. Organization-boundary tokens also require fiest.organization.read; when a token covers several organizations, organization_id must identify an exact organization returned by listOrganizations.
Quick request
curl -X POST 'https://api-sandbox.fiest.io/v1/restaurants/11111111-1111-4111-8111-111111111111/payment-corrections/undo?organization_id=33333333-3333-4333-8333-333333333333' \ -H 'Authorization: Bearer $FIEST_ACCESS_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ "businessDate": "2026-07-15", "sourceKind": "order", "sourceRecordId": "fiest-50b6d34f-bc6e-4248-b3d6-839b3dda31a1", "action": "undo", "reason": "The receipt was settled in cash at the counter.", "expectedRevisionId": "11111111-1111-4111-8111-111111111111", "previewFingerprint": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "expiresAt": "2026-07-15T13:00:00.000Z", "confirmed": true, "idempotencyKey": "55555555-5555-4555-8555-555555555555"}'{ "data": { "restaurantId": "11111111-1111-4111-8111-111111111111", "batchId": "22222222-2222-4222-8222-222222222222", "revisionId": "33333333-3333-4333-8333-333333333333", "replayed": false, "report": { "refundReporting": { "policy": "refund-event-date/v1", "legacyTiming": false, "incompleteEvidence": false }, "restaurantId": "11111111-1111-4111-8111-111111111111", "scope": "day", "period": { "startDate": "2026-07-15", "endDate": "2026-07-15", "timeZone": "Europe/Helsinki", "dayStartHour": 4 }, "currency": "EUR", "rawRows": [ { "key": "card", "label": "Card", "transactionCount": 459, "grossMinor": 2795000, "netMinor": 2390000, "vatMinor": 405000, "grossByRateMinor": null, "vatByRateMinor": null } ], "adjustedRows": null, "rawTotalMinor": 2795000, "adjustedTotalMinor": null, "status": "review_required", "warnings": [ { "code": "correction_ledger_unavailable", "message": "Raw values are available; adjusted values need review.", "businessDate": null, "correctionId": null } ], "days": [], "corrections": [], "sources": [], "appliedCorrectionIds": [], "rawSourceBasis": "services_accounting", "calculationVersion": "services-accounting/payment-report/1", "schemaVersion": null, "currentSourceFingerprint": null, "readOnly": true } }}fiestOAuth fiest.restaurant.read, fiest.accounting.read, fiest.analytics.read, fiest.accounting.corrections.writeAuthorizationBearer <token>OAuth 2.1 authorization code with PKCE. Partner clients and redirect URIs must be approved by Fiest before use.
Scope: fiest.restaurant.read, fiest.accounting.read, fiest.analytics.read, fiest.accounting.corrections.write
restaurantId*stringA restaurant identifier returned by the authorized restaurant list.
uuidorganization_id?stringAn organizationId returned by GET /v1/organizations. Required for restaurant-scoped calls when a Management portfolio authorization covers more than one organization; omitted for a single-restaurant authorization and optional for a one-organization grant.
uuidapplication/json- body
businessDate*string^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$datesourceKind*string"order""tab""tab_split_detail""card_split_payment"sourceRecordId*string1 <= length <= 255action*string"correct""undo"toMethodKey?string1 <= length <= 64reason*string4 <= length <= 1000expectedRevisionId*|nullpreviewFingerprint*string^[a-f0-9]{64}$expiresAt*string^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$date-timeconfirmed*booleanidempotencyKey*string^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuidThe immutable reversal batch and revision result with a rechecked payment report.
application/json- response
data*