# x402r Documentation

## Docs

- [What is x402r?](https://docs.x402r.org/index.md): x402r adds escrow deposits, refund windows, and dispute resolution to HTTP-native payments
- [X402 Protocol Overview](https://docs.x402r.org/x402-integration/overview.md): How x402r extends the x402 HTTP payment protocol with escrow capabilities
- [auth-capture Scheme](https://docs.x402r.org/x402-integration/auth-capture/index.md): Concept, flow diagrams, and captureAuthorizer model for the x402 auth-capture payment scheme
- [Wire Format](https://docs.x402r.org/x402-integration/auth-capture/wire-format.md): PaymentRequirements, PaymentPayload, and Extra-field reference for the auth-capture scheme
- [Verification and Settlement](https://docs.x402r.org/x402-integration/auth-capture/verification-and-settlement.md): Facilitator verification flow, settlement logic, EIP-6492 wallets, and error codes
- [PaymentInfo Struct](https://docs.x402r.org/x402-integration/auth-capture/payment-info.md): On-chain PaymentInfo struct, expiry ordering, and safety guarantees
- [Overview](https://docs.x402r.org/contracts/overview.md): Introduction to x402r smart contracts and their relationship to commerce-payments
- [Architecture](https://docs.x402r.org/contracts/architecture.md): System architecture, payment flows, and contract relationships
- [Commerce Payments](https://docs.x402r.org/contracts/periphery/auth-capture-escrow.md): AuthCaptureEscrow and the canonical token collectors that form the auth-capture base layer
- [PaymentOperator](https://docs.x402r.org/contracts/payment-operator.md): The core payment operator contract with pluggable conditions and fee management
- [Factories](https://docs.x402r.org/contracts/factories.md): Factory patterns, CREATE2 deployments, and deterministic addresses
- [Fee System](https://docs.x402r.org/contracts/fees.md): Additive modular fee architecture with protocol and operator fee layers
- [Configuration Examples](https://docs.x402r.org/contracts/examples.md): Complete configuration examples for common x402r use cases
- [Periphery Overview](https://docs.x402r.org/contracts/periphery/overview.md): Supporting contracts that extend the PaymentOperator: escrow, refund requests, token collectors, and more
- [RefundRequestEvidence](https://docs.x402r.org/contracts/periphery/refund-request-evidence.md): On-chain evidence submission for refund disputes
- [ReceiverRefundCollector](https://docs.x402r.org/contracts/periphery/receiver-refund-collector.md): Pulls funds from receiver for refunds
- [Conditions Overview](https://docs.x402r.org/contracts/conditions/overview.md): Pluggable condition system for flexible payment authorization and state tracking
- [PayerCondition](https://docs.x402r.org/contracts/conditions/payer.md): Singleton condition that restricts operator actions to the payment payer address
- [ReceiverCondition](https://docs.x402r.org/contracts/conditions/receiver.md): Singleton condition that restricts operator actions to the payment receiver address
- [StaticAddressCondition](https://docs.x402r.org/contracts/conditions/static-address.md): Restrict operator actions to a specific designated address via immutable check
- [AlwaysTrueCondition](https://docs.x402r.org/contracts/conditions/always-true.md): Allow anyone to call an action with no restrictions
- [EscrowPeriod](https://docs.x402r.org/contracts/conditions/escrow-period.md): Time-lock condition that records authorization time and enforces escrow windows
- [Freeze](https://docs.x402r.org/contracts/conditions/freeze.md): Block payment capture when frozen, with configurable freeze/unfreeze authorization
- [Combinators](https://docs.x402r.org/contracts/conditions/combinators.md): Compose conditions with And, Or, and Not logical operators
- [Custom Conditions](https://docs.x402r.org/contracts/conditions/custom.md): Build your own condition contracts for specialized authorization logic
- [Hooks Overview](https://docs.x402r.org/contracts/hooks/overview.md): State recording system for tracking payment lifecycle events
- [AuthorizationTimeRecorderHook](https://docs.x402r.org/contracts/hooks/authorization-time.md): Records authorization timestamp for time-based conditions
- [PaymentIndexRecorderHook](https://docs.x402r.org/contracts/hooks/payment-index.md): Index payments by sequential count for on-chain queries and repeated refund requests
- [HookCombinator](https://docs.x402r.org/contracts/hooks/combinator.md): Chain hooks into a single operator slot for composite state tracking
- [RefundRequest](https://docs.x402r.org/contracts/hooks/refund-request.md): Manages refund request lifecycle and approvals independent of operator implementation
- [Custom Hooks](https://docs.x402r.org/contracts/hooks/custom.md): Build your own hook contracts for specialized state tracking
- [Overview](https://docs.x402r.org/sdk/overview.md): TypeScript SDK for adding escrow, refunds, and dispute resolution to x402 payments
- [Create x402r Client](https://docs.x402r.org/sdk/create-client.md): Client factory, role presets, and configuration reference.
- [Deploy an operator](https://docs.x402r.org/sdk/deploy-operator.md): Deploy a PaymentOperator with escrow, freeze, and dispute resolution in one call
- [Merchant Server Quickstart](https://docs.x402r.org/sdk/merchant/getting-started.md): Accept escrow-backed refundable payments on your Express server in 5 minutes
- [Merchant SDK](https://docs.x402r.org/sdk/merchant/quickstart.md): Capture funds, charge payments, process refunds, and query escrow state
- [Refund handling](https://docs.x402r.org/sdk/merchant/refund-handling.md): Process, approve, deny, and manage refund requests as a merchant
- [Delivery Protection](https://docs.x402r.org/sdk/delivery-protection.md): Automated quality verification for every transaction.
- [forwardToArbiter()](https://docs.x402r.org/sdk/helpers/forward-to-arbiter.md): Forward settlement data to an arbiter service for quality evaluation
- [Merchant Setup](https://docs.x402r.org/sdk/delivery-merchant.md): Configure forwardToArbiter() to send responses to the arbiter for evaluation.
- [Arbiter Setup](https://docs.x402r.org/sdk/delivery-arbiter.md): Build a service that evaluates responses and releases funds.
- [CLI](https://docs.x402r.org/sdk/cli.md): One-shot command-line tool for paying x402 endpoints. Wallet-agnostic with zero provider dependencies.
- [Examples](https://docs.x402r.org/sdk/examples.md): Runnable examples for every SDK operation.
- [Gas Costs](https://docs.x402r.org/contracts/gas-costs.md): Foundry-measured gas costs for every on-chain x402r operation, with per-plugin overhead breakdown
- [Audits](https://docs.x402r.org/contracts/audits.md): Audit status, trust assumptions, and security roadmap for x402r contracts
- [License](https://docs.x402r.org/contracts/license.md): BUSL-1.1 licensing terms, permissions, and restrictions for x402r smart contracts