Post a transaction (stamp / redeem / adjust)
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Replay-safe request key. Repeated requests with the same value within 24h return the original response unchanged.
255Body
STAMP, REDEEM, ADJUST x <= 100000Must be a multiple of 0.01x >= 0280120Stable partner-side identifier used for permanent organization-wide deduplication.
180Response
Created
STAMP, REDEEM, ADJUST SCANNER, POS, API, ADJUST, DASHBOARD, LEGACY_IMPORT, TAP 0.01Partner-supplied stable identifier (Toast order id,
Shopify checkout id, Square payment id). When set on
create via POST /transactions or
POST /marketplace/accrue, the unique
(orgId, externalTransactionId) index makes the call
permanently idempotent — a redelivered upstream webhook
returns the existing row at HTTP 200 instead of
double-crediting.
Set on a compensating row created by
/marketplace/reverse. Points at the original transaction
this row reverses. The original is reversed at most once
(enforced by a unique constraint).
Operator-visible reason for a reversal ("Customer refunded the order"). Persisted on the COMPENSATING row, not the original.
True when posted via a pk_test_… key. Test rows still
write to the ledger and still fire webhooks (so partner
sandbox integrations can verify their receivers), but DO
NOT update Customer / Card / Enrollment aggregates and
are excluded from operator dashboard rollups.
Related topics
List transactionsReverse a previously-posted transactionFind-or-create customer + post transaction in one callAuthentication and scopesGo-live checklist
