Skip to main content
POST
Record verified non-financial Commerce reconciliation

Authorizations

Authorization
string
header
required

Server-side tenant-scoped credential created from Build > API Keys.

Headers

Idempotency-Key
string
required
Required string length: 1 - 200

Path Parameters

saleId
string
required

Body

application/json
sourceVersion
string
required
Pattern: ^[a-f0-9]{64}$
outcome
enum<string>
required
Available options:
completed_externally,
verified_no_action_required
reference
string
required
Required string length: 1 - 500
note
string
required
Required string length: 1 - 1000

Response

Durable Commerce command result. Read back the exact ticket and purchase after acceptance or uncertainty.

tenantId
string
required
purchaseId
string
required
reason
string
required
factsKey
string
required
sourceVersion
string
required
asOf
string
required
title
string
required
itemName
string
required
currency
string
required
purchaseKind
string
required
paymentStatus
string
required
fulfillmentStatus
string
required
refundStatus
string
required
stripeMode
enum<string>
required
Available options:
test,
live
cycle
integer
required
Required range: x >= 0
revision
integer
required
Required range: x >= 0
required
boolean
required
amountMinor
integer
required
historical
boolean
required
providerBookingIds
string[]
required
permittedActions
enum<string>[]
required
Available options:
fulfill,
reconcile
humanActions
enum<string>[]
required
Available options:
refund,
retry_reservation,
payout
source
object
required
bookingConfirmed
boolean
required

True only for successful provider booking state plus required stored provider identifiers; reconciliation alone never sets this.

bookingStatus
string
outcome
string
sourceReconciledAt
string
reconciliation
object
lastCommand
object