{"uid":"cap_7syMEVd8JdaHdIbvIVxPX","slug":"vrsai-payout-preflight-check-0ae25b79","name":"vrsai Payout Preflight Check","description":"Check an outbound payout immediately before authorization to catch changed destinations, duplicate payments, amount or currency drift, and malformed payment details.","url":"https://api.vrsai.tech/v1/capabilities/payout_preflight/versions/1.0.0/execute","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object"},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"checks":[{"id":"destination_structural_validity","status":"PASS","evidence":{"scheme":"iban","country":"PT","iban_masked":"…0154","checksum_valid":true,"country_length_checked":true}},{"id":"trusted_baseline_presence","status":"PASS","evidence":{"form":"raw","supplied":true}},{"id":"destination_match","status":"PASS","evidence":{"changed":false,"compared":true}},{"id":"beneficiary_id_match","status":"PASS","evidence":{"changed":false,"compared":true}},{"id":"currency_match","status":"PASS","evidence":{"changed":false,"compared":true}},{"id":"rail_match","status":"PASS","evidence":{"changed":false,"compared":true}},{"id":"reference_match","status":"PASS","evidence":{"compared":false}},{"id":"purpose_code_match","status":"PASS","evidence":{"compared":false}},{"id":"bic_match","status":"PASS","evidence":{"compared":false}},{"id":"expected_amount_match","status":"PASS","evidence":{"delta_minor":"0"}},{"id":"max_amount_policy","status":"PASS","evidence":{"compared":false}},{"id":"allowed_currency","status":"PASS","evidence":{"compared":false}},{"id":"allowed_destination_scheme","status":"PASS","evidence":{"compared":false}},{"id":"exact_duplicate_payout","status":"PASS","evidence":{"history_entries_considered":1}},{"id":"duplicate_reference","status":"PASS","evidence":{"matched":false,"compared":true}},{"id":"destination_first_seen","status":"PASS","evidence":{"matched":true}}],"coverage":{"history":"complete","checks_performed":["destination_structural_validity","trusted_baseline_comparison","expected_amount_policy","exact_duplicate_payout","duplicate_reference","destination_first_seen"],"trusted_baseline":"raw","checks_not_performed":["max_amount_policy","allowed_currency_and_scheme_policy","bank_account_existence_verification","beneficiary_ownership_verification","verification_of_payee","sanctions_screening","aml_screening","kyc","fraud_scoring","payment_settlement_confirmation","aba_routing_directory_lookup","evm_rpc_or_bytecode_inspection","payment_submission"],"complete_for_declared_scope":true},"decision":"PROCEED","candidate":{"currency":"EUR","payout_id":"pay_8831","amount_minor":"185000","beneficiary_id":"supplier_123","destination_scheme":"iban","payout_fingerprint":"sha256:c2219e731b7102ae397b1e09195a2fd73d5896778452fba41bc23ba090c7be71","destination_fingerprint":"sha256:5546cc5c8e73ac86f8251a94c345ee548e1a4f5bde7bf10e6fb2e12dec95c620"},"reason_codes":[],"machine_action":"AUTHORIZATION_NOT_BLOCKED_BY_PREFLIGHT","ruleset_version":"payout_preflight_r1"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vOO_xvYlRfbffiiULPQM1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates an outbound payout immediately before authorization to detect changed destinations, duplicate payments, amount/currency drift, and malformed payment details.","exampleAgentPrompt":"Before you send this $12,500 wire to our vendor Acme Corp at account 0012345678, run a preflight check to make sure the destination hasn't changed, there are no duplicate payments pending, and the amount and currency are what we authorized.","exampleUseCases":[{"title":"Vendor payment tamper detection","prompt":"We're about to send a $45,000 ACH payment to BuildRight Contractors — can you run a preflight check to confirm the bank account on file hasn't changed from what we approved last week and there's no duplicate payment already in flight?"},{"title":"Crypto payout destination drift","prompt":"Before authorizing this 2.5 ETH payout to wallet address 0xA3f9...B12C, check that the destination address matches what was originally set, the amount hasn't drifted, and the payment details aren't malformed."},{"title":"Payroll duplicate payment guard","prompt":"We're processing payroll for 50 employees today — before we release the batch, run a preflight validation on this payment to Sarah Chen for $3,200 USD to make sure it hasn't already been sent this cycle and the account details are correct."}],"resultDescription":"Returns a structured validation result indicating whether the payout is safe to authorize, along with specific flags for any issues detected — including changed destination warnings, duplicate payment alerts, amount or currency drift, and malformed payment detail errors.","failureModes":["Malformed input body returns a 400-level error with schema validation details","Payment details that cannot be parsed may return a malformed-detail flag rather than a hard error","Ambiguous duplicate detection may produce false positives if prior payment history is incomplete","Network timeout or service unavailability returns a 5xx error requiring retry before authorization"],"whenToPreferThis":"Use this endpoint as a mandatory gate immediately before any outbound payment authorization in automated or agentic workflows. Prefer this over manual review when processing high-volume payouts, when destination details are stored and may have drifted, or when duplicate-payment risk is high. It is especially valuable in pipelines where payment instructions originate from external or AI-generated sources that could be manipulated.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:36:36.751Z","isFirstParty":false}