Protocol Reference · Agent Commerce by CertifiedData
Event taxonomy
All Agent Commerce events follow the entity.action naming convention and extend the event.v1 base schema.
receipt_events
receipt.issuedschema: event.v1Entity type: payment_receipt
{
"receipt_id": "rcpt_8fe84fd9...",
"rail": "stripe",
"status": "succeeded",
"issued_at": "2026-04-05T19:00:00Z"
}receipt.verifiedschema: event.v1Entity type: payment_receipt
{
"receipt_id": "rcpt_8fe84fd9...",
"verification_id": "ver_91af3...",
"result": "valid",
"checked_at": "2026-04-05T19:05:00Z"
}authorization_events
authorization.createdschema: event.v1Entity type: payment_authorization
{
"authorization_id": "auth_22b5b4da...",
"created_at": "2026-04-05T18:59:58Z"
}authorization.authorizedschema: event.v1Entity type: payment_authorization
{
"authorization_id": "auth_22b5b4da...",
"decision": "authorized",
"policy_id": "pol_default_v1",
"created_at": "2026-04-05T18:59:58Z"
}authorization.blockedschema: event.v1Entity type: payment_authorization
{
"authorization_id": "auth_22b5b4da...",
"decision": "blocked",
"policy_id": "pol_default_v1",
"created_at": "2026-04-05T18:59:58Z"
}authorization.review_requestedschema: event.v1Entity type: payment_authorization
{
"authorization_id": "auth_22b5b4da...",
"decision": "needs_review",
"policy_id": "pol_default_v1",
"created_at": "2026-04-05T18:59:58Z"
}verification_events
verification.checkedschema: event.v1Entity type: verification_check
{
"verification_id": "ver_91af3...",
"receipt_id": "rcpt_8fe84fd9...",
"result": "valid",
"checked_at": "2026-04-05T19:05:00Z"
}transaction_events
transaction.createdschema: event.v1Entity type: payment_transaction
{
"transaction_id": "tx_1a60ca39...",
"status": "created",
"created_at": "2026-04-05T19:00:00Z"
}transaction.submittedschema: event.v1Entity type: payment_transaction
{
"transaction_id": "tx_1a60ca39...",
"status": "submitted",
"submitted_at": "2026-04-05T19:00:10Z"
}transaction.succeededschema: event.v1Entity type: payment_transaction
{
"transaction_id": "tx_1a60ca39...",
"status": "succeeded",
"settled_at": "2026-04-05T19:00:30Z"
}transaction.failedschema: event.v1Entity type: payment_transaction
{
"transaction_id": "tx_1a60ca39...",
"status": "failed",
"failure_code": "payment_failed",
"failed_at": "2026-04-05T19:00:30Z"
}transaction.refundedschema: event.v1Entity type: payment_transaction
{
"transaction_id": "tx_1a60ca39...",
"status": "refunded",
"refunded_at": "2026-04-05T19:30:00Z"
}transaction.disputedschema: event.v1Entity type: payment_transaction
{
"transaction_id": "tx_1a60ca39...",
"status": "disputed",
"disputed_at": "2026-04-05T20:00:00Z"
}transparency_events
transparency.appendedschema: event.v1Entity type: transparency_entry
{
"event_id": "evt_890751a5...",
"event_type": "receipt.issued",
"entity_type": "payment_receipt",
"entity_id": "rcpt_8fe84fd9...",
"created_at": "2026-04-05T19:00:00Z"
}registry_events
registry.publishedschema: event.v1Entity type: registry_entry
{
"registry_entry_id": "reg_19af...",
"entity_type": "payment_receipt",
"entity_id": "rcpt_8fe84fd9...",
"published_at": "2026-04-05T19:00:00Z"
}