Apply an approved payment-method correction
Applies one unchanged, explicitly approved preview for an exact payment source.
Applies one unchanged, explicitly approved preview for an exact payment source. Send confirmed=true, the unchanged preview fingerprint, expected revision, expiry, reason, and a UUID idempotency key. The immutable correction ledger is written only after the current report and source are rechecked under the canonical day lock; the response contains the recalculated report. Use this for action=correct. 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/apply?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": "correct", "toMethodKey": "cash", "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": "44444444-4444-4444-8444-444444444444"}'{ "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 correction batch and revision result with a rechecked payment report.
application/json- response
data*