Skip to main content
Version: v0.12.11

Payment Event Records

PEAC records payment evidence across multiple rails: x402, Stripe SPT delegation, ACP mandate lifecycle, MPP/paymentauth HTTP auth challenges, and UCP order events.

Finality semantics rule​

PEAC never synthesizes payment finality from non-payment artifacts. An ACP session "completed" does not prove payment settlement. A Stripe grant does not prove payment authorization. Each mapper uses assertExplicitFinality to enforce that finality is stated explicitly by the upstream system.

Commerce mandate records (v0.14.3+)​

The org.peacprotocol/commerce-mandate extension group (7 type URIs) covers mandate lifecycle:

  • mandate-grant-observed
  • mandate-authorization-observed
  • mandate-capture-observed
  • mandate-void-observed
  • mandate-refund-observed
  • mandate-settlement-observed
  • mandate-budget-observed

x402 evidence​

npm install @peac/adapter-x402 @peac/rails-x402

Records x402 v1 and v2 payment offer and settlement evidence with dual-header support.

Stripe SPT delegation evidence​

npm install @peac/rails-stripe

Records Stripe Payment Token delegation grants. Does not prove payment authorization without explicit upstream confirmation.

MPP / paymentauth evidence​

npm install @peac/mappings-paymentauth

Records HTTP Payment authentication scheme challenges and receipts (draft-ryan-httpauth-payment).

ACP session and payment evidence​

npm install @peac/mappings-acp

Strict boundary: session evidence and payment observation use separate functions. amount_minor is always a string (not a number).

UCP order evidence​

npm install @peac/mappings-ucp

payment_state_source marker separates order state from payment state.