{"uid":"cap_d0L7oj7_CVhPHC66NNYwS","slug":"runonproof-uk-payee-binding-evaluation-df9c5a3e","name":"RunOnProof UK Payee Binding Evaluation","description":"Evaluate a time-bound caller or provider payee-binding control for a UK company. Use before paying a known supplier. It accepts opaque fingerprints only and does not independently prove bank-account ownership; missing evidence returns REVIEW.","url":"https://cdo-production.up.railway.app/v1/gb/payees/match-business","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$","description":"Caller-generated key. Send the identical value in the Idempotency-Key header."},"binding_evidence":{"type":"object","required":["type","verified_at","valid_until","reference"],"properties":{"type":{"enum":["PREVIOUSLY_VERIFIED_BINDING","BANK_PROVIDER_CONFIRMATION","CUSTOMER_CONFIRMATION","CHALLENGE"]},"reference":{"type":"string","maxLength":200,"minLength":1,"description":"Non-secret reference to the evidence held by the caller."},"valid_until":{"type":"string","format":"date-time","description":"Expiry of the caller/provider evidence; must be in the future."},"verified_at":{"type":"string","format":"date-time","description":"When the caller or provider verified the binding."}},"additionalProperties":false},"payee_fingerprint":{"type":"string","maxLength":200,"minLength":8,"description":"Opaque caller-generated fingerprint; never send raw bank-account details."}}},"responseSchema":null,"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_eZqRDReZO_NBLlVNLgcEe","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":"Evaluates time-bound caller or provider payee-binding control evidence for a UK company before paying a known supplier, returning MATCH, NO_MATCH, or REVIEW based on opaque fingerprint evidence.","exampleAgentPrompt":"Before we pay Acme Supplies Ltd (company number 09876543), run a payee binding check using our existing PREVIOUSLY_VERIFIED_BINDING evidence referenced as 'acme-binding-2024-001', which was verified on 2024-11-01 and is valid until 2025-06-30, against their payee fingerprint 'fp-acme-uk-9a3b2c1d'.","exampleUseCases":[{"title":"Pre-payment supplier control check","prompt":"We're about to pay one of our regular UK suppliers, company number 04123456 — before we release the funds, can you evaluate our BANK_PROVIDER_CONFIRMATION binding evidence referenced as 'barclays-confirm-88xyz', verified on 2025-01-15 and valid until 2025-12-31, against their payee fingerprint 'fp-supplier-88xyz99aa'?"},{"title":"Recurring vendor payment validation","prompt":"We pay this UK vendor monthly — company number OC345678 — and I want to confirm our payee binding is still valid before this month's run. The binding type is PREVIOUSLY_VERIFIED_BINDING, reference 'monthly-vendor-bind-045', verified 2024-09-01, valid until 2025-09-01, fingerprint 'fp-oc345678-vendor-monthly'."},{"title":"Challenge-based payee re-verification","prompt":"Our finance team is flagging a payment to UK company 00445566 as needing a fresh payee check — we have a CHALLENGE binding type, reference 'challenge-ref-2025-q1', verified 2025-03-10 and valid until 2025-04-10, with fingerprint 'fp-00445566-challenge-q1'. Can you evaluate whether the binding control passes?"}],"resultDescription":"Returns a structured evaluation result indicating MATCH, NO_MATCH, or REVIEW for the payee binding control. MATCH means evidence is valid and within its time bounds; NO_MATCH means evidence fails the check; REVIEW is returned when evidence is missing or insufficient for a determination. No raw bank-account data is returned or required.","failureModes":["Evidence valid_until is in the past — binding is expired, returns REVIEW or NO_MATCH","Company number format invalid — 422 validation error","Payee fingerprint below minimum length — validation error","Binding evidence reference missing or empty — schema validation failure","Idempotency key reused with different payload — conflict error","Future-dated verified_at timestamp — rejected as invalid evidence"],"whenToPreferThis":"Use this endpoint when you already hold caller-side or provider-side binding evidence (e.g. a previous verification, a bank confirmation, or a challenge response) for a known UK supplier and need a lightweight, time-bound control check before releasing a payment. It is not a first-pass identity lookup (use the UK Companies House resolution endpoint for that), nor does it independently prove bank-account ownership — it evaluates the evidence you supply via opaque fingerprints only.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:40:34.864Z","isFirstParty":false}