Skip to main content
Use one shared status map for product, operations, and support.

​
API resource statuses

StatusMeaningTypical action
pendingaccepted but not finalmonitor
scheduledqueued for future executionkeep scheduled
in_analysismanual or provider reviewkeep queued and visible to operators
processingsettlement in progresswait for webhook or reconcile
paidsettled successfullymark payout completed
rejectedblocked before settlementroute to operator review
cancelledintentionally stoppedclose the request
errorfailed during processinginvestigate retry policy
unknownnot yet normalizedreconcile immediately

​
Webhook event mapping

Resource status and webhook event names are not identical.
  • payout.transferred maps to resource status paid
  • payout.failed maps to resource status error
  • payout.canceled maps to resource status cancelled

​
Why this matters

If your product displays event names as resource statuses, operator tooling becomes ambiguous. Keep one internal mapping and reuse it across webhook handlers, dashboards, and reconciliation jobs.