English source · 2 min

src/payments

This folder owns the Rust modules listed below. Each source begins with its responsibility contract. The crate currently shares internal types/imports through a facade; APIs, MCP and UCP delegate to shared domain operations.

• mod.rs: Provider-independent payment ledger and durable workers; the PayPal adapter supports explicit Sandbox/Live environments.
• operations.rs: Durable idempotent payment commands, customer context binding and serial refund admission.
• PayPal compatibility: Native PayPal Orders v2 sandbox wire adapter; credentials never enter prompts or browser responses.
• provider.rs: Payment provider identity, tenant account configuration and immutable wire context.
• receipt_guard.rs: Bind integer provider receipt amounts and status to the formally checked exact-match predicate.
• return_urls.rs: Provider return/cancel URLs preserve the tenant and sales channel; navigation is never payment evidence.
• routes.rs: Customer payment status/capture and merchant refund operations share the durable command API.
• storage.rs: Transactional provider receipts and order state updates; external responses cannot invent amounts or tenants.
• PayPal webhooks: PayPal verifies webhook signatures before inbox insertion; provider reconciliation confirms monetary state.
• worker.rs: Leased payment jobs; network runs after claim commit, fenced receipts prevent duplicate local effects.

The source inventory is checked in CI. The behavioral map identifies integration suites, and testing describes actual coverage and limits. Every file is limited to 320 lines; main.rs to 120.

Provider-specific implementation belongs to its app package; this folder keeps the common ledger, admission and order effects. The older PayPal adapter is still host-native compatibility, not a sandboxed plugin.