x402

Reconcile an ambiguous x402 settlement. (admin access required)

Manually resolves an inbound settle left awaiting reconciliation: a Verified attempt whose settle threw, timed out, or was interrupted becomes eligible once stale; a stale Settled attempt missing its settlement record is also eligible but only accepts "settled". The operator confirms on-chain whether funds moved: "settled" records the settlement (txHash required), while "failed" marks it Failed so a fresh settle can retry.

post/x402/payments/reconcile

Request

  • Base URL: ./../api/v1/ (relative, and the document was published on a file host, not at the API’s origin)
  • URL: ./../api/v1/x402/payments/reconcile
  • Auth: API key in header token

Request body

OR

Response

Reconciliation result

status'success' required

Example response

{
  "status": "success",
  "data": {
    "attemptId": "clx402attempt0001",
    "status": "Settled"
  }
}

Changes

No recorded changes to this operation across all 50 revisions of this API.