Protocol Reference · Agent Commerce by CertifiedData
Status enum reference
Canonical, stable status values used across Agent Commerce schemas, APIs, and transparency events. These values are reserved and will not change meaning across schema versions.
Authorization statuses
authorizedThe payment request matched policy and can proceed to execution.
Schemas: authorization_log_entry.v1
blockedThe payment request violated policy and cannot proceed.
Schemas: authorization_log_entry.v1
needs_reviewThe payment request crossed a threshold that requires human review before execution.
Schemas: authorization_log_entry.v1
Transaction statuses
pendingThe object exists but has not yet reached a final state.
Schemas: payment_receipt.v1, event.v1
submittedThe transaction was submitted to a payment rail but not yet settled.
Schemas: payment_receipt.v1
succeededThe transaction completed successfully and settlement is confirmed.
Schemas: payment_receipt.v1, event.v1
failedThe transaction did not complete successfully.
Schemas: payment_receipt.v1, event.v1
refundedThe transaction was reversed through a refund flow.
Schemas: event.v1
disputedThe transaction entered a dispute state requiring resolution.
Schemas: event.v1
Verification statuses
validThe checked proof or receipt passed all verification steps.
Schemas: verification_check_entry.v1
invalidThe checked proof or receipt failed one or more verification steps.
Schemas: verification_check_entry.v1