mock-pay · git:20260521.02561b0 · 2026-05-21 · sha256 f639a8635f4ad6c5

mock-pay git:20260521.02561b0A

Immutable. This exact content is served forever at /api/v1/blob/f639a8635f4ad6c5.

---
name: mock-pay
description: Run the deterministic mock payment graph from quote to sealed proof.
runx:
  category: payments
---

# Mock Pay

Run the deterministic local payment graph.

The graph turns a payment-required signal into a quote, selects and reserves a
payment decision, routes approval when required, fulfills the mock rail under
attenuated authority, and leaves recovery evidence if the rail result is
ambiguous.

This is the settlement-pinned mock marquee. It exists for local harnesses,
demos, and contract tests. It does not claim live provider behavior or accept
raw funding material.

## Quality Profile

- Purpose: execute a paid action through runx authority without hiding the
  payment governance path.
- Audience: agent hosts, operators, approval reviewers, and receipt verifiers.
- Artifact contract: `payment_execution`, `payment_quote_packet`,
  `payment_reservation_packet`, `payment_rail_packet`, and `recovery_packet`
  when needed.
- Evidence bar: every successful execution carries a quote, selected decision,
  reserved child authority, idempotency key, rail proof ref, and receipt seal
  requirement.
- Voice bar: operator-grade execution record; avoid wallet/product marketing.
- Strategic bar: keep rails pluggable while core owns payment authority.
- Stop conditions: stop before rail execution when quote, approval, parent
  authority, reservation, idempotency, or spend capability is missing.

## Output

- `payment_execution`: overall status and receipt/proof refs.
- `payment_quote_packet`: normalized quote output.
- `payment_reservation_packet`: selected reservation decision and child
  authority term.
- `payment_rail_packet`: rail proof and credential envelope.
- `recovery_packet`: recovery assessment when a rail result is ambiguous.

## Inputs

- `payment_signal` (required): payment-required signal or challenge.
- `parent_payment_authority` (required): parent payment authority term or ref.
- `rail_profile_ref` (required): configured rail profile reference.
- `realm` (optional): authority realm.
- `spend_policy` (optional): policy limits and approval thresholds.
- `approval_context` (optional): prior approval evidence.
- `idempotency_seed` (optional): stable idempotency material.