# RunOnProof Release Payment to Supplier

> RunOnProof Release Payment to Supplier is a paid API for AI agents from api.runonproof.com, paid per call via x402, $0.79/call, status unknown (last checked 2026-09-13).

Decides whether to ALLOW, HOLD, or BLOCK a US supplier payment before funds move, returning a signed proof capsule with reasons and remediation steps.

## Facts

- Endpoint: POST https://api.runonproof.com/v1/us/decision-gates/release-payment-to-supplier
- Price: $0.79/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/runonproof-release-payment-to-supplier-93cb42a0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PHn8qw11UjM1aT32lNpFg

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability runonproof-release-payment-to-supplier-93cb42a0 -d '<json body>'
```

Example prompt: Before we release the $47,500 wire to supplier Acme Industrial (entity ID SUP-00291), run a RunOnProof payment decision check against invoice INV-2024-8821 for buyer org ORG-10045 — apply our standard federal-only risk policy with low tolerance and give me the signed decision and reasons.

## When to prefer this

Choose this endpoint when you need a cryptographically signed, auditable go/no-go decision on a US supplier payment before funds are released — especially in accounts payable workflows requiring fraud prevention, buyer mandate verification, or compliance proof. Prefer it over generic fraud APIs when you need deterministic replay, a Proof Capsule for audit, or structured remediation guidance. Note it is FEDERAL_ONLY and does not execute payments or initiate monitoring.

## Known failure modes

- Missing required fields (buyer, payee, invoice, supplier, amount) returns a 400 validation error
- Invalid or mismatched digests/fingerprints return a signature verification failure
- Stale freshness_requirements (max_age_seconds exceeded) return a freshness violation error
- Duplicate idempotency_key with differing parameters returns a conflict error
- Unsupported jurisdiction or coverage values (non-US or non-FEDERAL_ONLY) return a 422 unprocessable entity
- Agent request_signature validation failure returns an authentication error
- Service unavailability returns a 503 with retry guidance

## How this service works

RunOnProof Payment Decision decides whether to release a US supplier payment before funds move. 0.79 USDC: scoped checks, reasons, evidence and signed proof binding supplier, invoice digest, amount, payee/destination and mandate. FEDERAL_ONLY. No state checks, bank ownership or invoice authenticity guarantee; never executes payment. HOLD/UNDETERMINED are not permission to pay; HOLD may be paid. Recover the same acquired result without paying again. See the provider guide.

## Output

Returns a decision of ALLOW, HOLD, or BLOCK for the supplier payment, along with structured reasons for the decision, remediation steps if the payment is held or blocked, a cryptographically signed Proof Capsule for audit and compliance, and a deterministic replay identifier. Coverage is FEDERAL_ONLY; no state-level checks are performed. The endpoint never executes the actual payment.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "buyer": {
   "type": "object",
   "required": [
    "organization_id",
    "organization_digest"
   ]
  },
  "payee": {
   "type": "object",
   "required": [
    "type",
    "value",
    "fingerprint"
   ]
  },
  "amount": {
   "type": "string"
  },
  "intent": {
   "const": "RELEASE_PAYMENT_TO_SUPPLIER"
  },
  "invoice": {
   "type": "object",
   "required": [
    "obligation_id",
    "document_digest"
   ]
  },
  "coverage": {
   "const": "FEDERAL_ONLY"
  },
  "currency": {
   "type": "string"
  },
  "supplier": {
   "type": "object",
   "required": [
    "entity_id",
    "identifiers"
   ]
  },
  "disclosure": {
   "type": "object",
   "required": [
    "profile",
    "audience_digest"
   ]
  },
  "correlation": {
   "type": "object",
   "required": [
    "correlation_id",
    "trace_id"
   ]
  },
  "risk_policy": {
   "type": "object",
   "required": [
    "policy_id",
    "tolerance"
   ]
  },
  "jurisdiction": {
   "const": "US"
  },
  "buyer_mandate": {
   "type": "object",
   "required": [
    "payload",
    "mandate_digest",
    "signature"
   ]
  },
  "schema_version": {
   "const": "1.0.0"
  },
  "idempotency_key": {
   "type": "string"
  },
  "economic_purpose": {
   "type": "string"
  },
  "requesting_agent": {
   "type": "object",
   "required": [
    "agent_id",
    "key_id",
    "request_signature"
   ]
  },
  "decision_fee_payer": {
   "type": "string"
  },
  "evidence_references": {
   "type": "array",
   "items": {}
  },
  "payment_destination": {
   "type": "object",
   "required": [
    "type",
    "value",
    "fingerprint"
   ]
  },
  "coverage_requirements": {
   "type": "object",
   "required": [
    "jurisdiction",
    "coverage"
   ]
  },
  "freshness_requirements": {
   "type": "object",
   "required": [
    "max_age_seconds",
    "evaluated_at"
   ]
  },
  "exposure_valuation_basis": {
   "type": "string"
  },
  "payment_instruction_digest": {
   "type": "string"
  },
  "payment_exposure_usdc_equivalent_atomic": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "policy": {
   "id": "US_DECISION_GATE_RELEASE_PAYMENT_TO_SUPPLIER_V1",
   "version": "1.0.0"
  },
  "replay": {
   "reference": "/v1/us/decision-gates/release-payment-to-supplier/replays/dgdec_example_001",
   "deterministic": true,
   "additional_charge": false,
   "sources_reexecuted": false
  },
  "billing": {
   "model": "ONE_TIME_DECISION_FEE",
   "charged": true,
   "maximum_charges": 1,
   "settlement_state": "SETTLED",
   "charges_for_decision": 1,
   "settlement_reference": "settlement_example_001"
  },
  "product": "decision-gate.release-payment-to-supplier.v1",
  "coverage": {
   "scope": "FEDERAL_ONLY",
   "limitations": [],
   "jurisdiction": "US",
   "state_coverage": "NONE_PHASE_1",
   "state_good_standing": "NOT_ASSERTED"
  },
  "decision": "HOLD",
  "delivery": {
   "state": "DELIVERED",
   "response_digest": "sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
   "delivery_reference": "delivery_example_001"
  },
  "freshness": {
   "status": "CURRENT",
   "valid_as_of": "2026-09-02T12:00:00.000Z",
   "valid_until": "2026-09-03T00:00:00.000Z"
  },
  "conditions": [],
  "request_id": "req_example_001",
  "decision_id": "dgdec_example_001",
  "remediation": [],
  "uncertainty": {
   "present": true,
   "reason_codes": []
  },
  "valid_as_of": "2026-09-02T12:00:00.000Z",
  "valid_until": "2026-09-03T00:00:00.000Z",
  "reason_codes": [],
  "risk_signals": [],
  "checks_waived": [],
  "decision_cost": {
   "asset": "USDC",
   "amount": "0.79",
   "network": "eip155:8453",
   "amount_atomic": "790000"
  },
  "economic_risk": {
   "mode": "BINDING",
   "assessed_at": "2026-09-02T12:00:00.000Z",
   "assumptions": [],
   "decision_fee": {
    "asset": "USDC",
    "amount": "0.79",
    "network": "eip155:8453",
    "amount_atomic": "790000"
   },
   "assessment_id": "dgrisk_example_001",
   "policy_version": "1.0.0",
   "assessment_digest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
   "observed_risk_range": {
    "lower_ppm": "0",
    "upper_ppm": "1000"
   },
   "break_even_risk_rate": "0.00079",
   "mandatory_verifications": [],
   "break_even_risk_rate_ppm": "790",
   "exposure_valuation_basis": "Buyer-declared basis",
   "verification_economically_justified": "UNCERTAIN",
   "mandatory_verifications_may_be_skipped": false,
   "payment_exposure_usdc_equivalent_atomic": "1000000000"
  },
  "proof_capsule": {
   "payload": {
    "payment_executed": false
   }
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/runonproof-release-payment-to-supplier-93cb42a0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.runonproof.com](https://www.zero.xyz/host/api.runonproof.com/llms.txt)
