Protocol Reference · Agent Commerce by CertifiedData

Schema registry

Canonical schema reference for all Agent Commerce proof objects and log entry formats. Schemas are versioned and additive — future versions preserve stable core fields.

payment_receipt

payment_receipt.v1

Structured proof object for an authorized and executed AI payment.

Fields

Field	Type	Req	Meaning
receipt_id	string	✓	Unique payment receipt identifier.
schema_version	string	✓	Receipt schema version.
agent_id	string	✓	Agent identity reference.
merchant_id	string	✓	Merchant or payee reference.
rail	string	✓	Execution rail: stripe \| usdc_base \| eth_ethereum.
currency	string	✓	Payment currency (ISO 4217 lowercase).
amount	integer	✓	Amount in cents or atomic units.
purpose_tag	string	✓	data_access \| api_call \| saas_renewal \| procurement.
status	string	✓	succeeded \| submitted \| failed.
issued_at	string	✓	ISO 8601 issuance timestamp.

Canonical object

{
  "receipt_id": "rcpt_8fe84fd9...",
  "schema_version": "payment_receipt.v1",
  "agent_id": "agt_research_buyer_01",
  "merchant_id": "mrc_vendor_a",
  "rail": "stripe",
  "currency": "usd",
  "amount": 4900,
  "purpose_tag": "data_access",
  "status": "succeeded",
  "issued_at": "2026-04-05T19:00:00Z"
}

Future versions preserve stable core fields and add new fields additively.

authorization_log_entry

authorization_log_entry.v1

Public-safe record of a payment authorization decision outcome.

Fields

Field	Type	Req	Meaning
authorization_id	string	✓	Unique authorization identifier.
decision	string	✓	authorized \| blocked \| needs_review.
policy_id	string	✓	Policy reference used for evaluation.
rail	string		Payment rail requested.
amount_display	string		Human-readable amount (public-safe).
purpose_tag	string		Purpose tag evaluated against policy.
created_at	string	✓	Authorization evaluation timestamp.

Canonical object

{
  "authorization_id": "auth_22b5b4da...",
  "decision": "authorized",
  "policy_id": "pol_default_v1",
  "rail": "stripe",
  "amount_display": "$49.00",
  "purpose_tag": "data_access",
  "created_at": "2026-04-05T18:59:58Z"
}

verification_check_entry

verification_check_entry.v1

Public-safe record that a payment proof object was checked and evaluated.

Fields

Field	Type	Req	Meaning
verification_id	string	✓	Unique verification check identifier.
receipt_id	string	✓	Receipt being verified.
result	string	✓	valid \| invalid.
hash_valid	boolean	✓	Whether SHA-256 hash matched.
signature_valid	boolean	✓	Whether Ed25519 signature verified.
checked_at	string	✓	Verification timestamp.

Canonical object

{
  "verification_id": "ver_91af3c20...",
  "receipt_id": "rcpt_8fe84fd9...",
  "result": "valid",
  "hash_valid": true,
  "signature_valid": true,
  "checked_at": "2026-04-05T19:05:00Z"
}

transparency_event_entry

transparency_event_entry.v1

Public-safe append-style event object for the payments transparency surface.

Fields

Field	Type	Req	Meaning
event_id	string	✓	Unique transparency event identifier.
event_type	string	✓	Canonical event type (entity.action).
entity_type	string	✓	Type of entity referenced.
entity_id	string	✓	Identifier of the referenced entity.
schema_version	string	✓	Event schema version.
created_at	string	✓	Event timestamp.

Canonical object

{
  "event_id": "evt_890751a5...",
  "event_type": "receipt.issued",
  "entity_type": "payment_receipt",
  "entity_id": "rcpt_8fe84fd9...",
  "schema_version": "transparency_event.v1",
  "created_at": "2026-04-05T19:00:00Z"
}

event

event.v1

Base schema for all public-safe Agent Commerce events and log entries. All future event types must extend this.

Fields

Field	Type	Req	Meaning
event_id	string	✓	Unique event identifier.
event_type	string	✓	Canonical event type (entity.action).
event_category	string	✓	Stable event category grouping.
entity_type	string	✓	Referenced entity type.
entity_id	string	✓	Referenced entity identifier.
schema_version	string	✓	Event schema version.
created_at	string	✓	Event timestamp (ISO 8601).
public_payload	object	✓	Public-safe event-specific payload.

Canonical object

{
  "event_id": "evt_890751a5...",
  "event_type": "receipt.issued",
  "event_category": "receipt_events",
  "entity_type": "payment_receipt",
  "entity_id": "rcpt_8fe84fd9...",
  "schema_version": "event.v1",
  "created_at": "2026-04-05T19:00:00Z",
  "public_payload": {}
}

All future public-safe Agent Commerce events must extend this base structure and preserve stable top-level keys.

Event taxonomy Glossary Status enums Receipt spec AsyncAPI schema on GitHub ↗