{"uid":"cap_PHn8qw11UjM1aT32lNpFg","slug":"runonproof-release-payment-to-supplier-93cb42a0","name":"RunOnProof Release Payment to Supplier","description":"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.","url":"https://api.runonproof.com/v1/us/decision-gates/release-payment-to-supplier","method":"POST","headers":{},"bodySchema":{"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"}}},"responseSchema":{"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},"signature":{"value":"AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA","key_id":"runonproof_example","algorithm":"Ed25519"},"capsule_digest":"sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc"},"machine_action":"HOLD_PAYMENT","request_digest":"sha256:2222222222222222222222222222222222222222222222222222222222222222","schema_version":"1.0.0","checks_executed":[],"evidence_bundle":{"digest":"sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb","references":[]},"product_version":"1.0.0","payment_executed":false,"decision_request_id":"dgreq_example_001"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.79","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.79/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.79","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.79","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zqLiyw-qcJkY2bkSTUBIq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.79","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Decides whether to ALLOW, HOLD, or BLOCK a US supplier payment before funds move, returning a signed proof capsule with reasons and remediation steps.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Pre-payment vendor fraud check","prompt":"We're about to pay a new vendor $120,000 for equipment — can you run a RunOnProof supplier payment decision for supplier entity SUP-00788, invoice INV-9902, buyer org ORG-20011, with low risk tolerance under our federal policy before we move the funds?"},{"title":"Accounts payable invoice verification","prompt":"Our AP team has invoice INV-2024-5530 from supplier SUP-00134 for $32,000 — get a signed RunOnProof release-payment decision for buyer ORG-10099 using our standard risk policy so we have proof on file before we approve the payment."},{"title":"Disputed payee account verification","prompt":"Before we wire $85,000 to what looks like a new bank account for supplier SUP-00456, run a RunOnProof payment decision check on invoice INV-77231 for buyer ORG-30022 with high risk tolerance flagging — I need to know if this should be held or blocked and why."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:30:29.926Z","isFirstParty":false}