{"uid":"cap_qwwIYYTarskrZL3-kVV8L","slug":"runonproof-uk-invoice-payee-verification-a5da20d8","name":"RunOnProof UK Invoice-Payee Verification","description":"Verify UK invoice-company consistency and a time-bound payee-binding control in one call before payment. Use when the invoice and payee are already known. It does not prove invoice authenticity or bank-account ownership.","url":"https://cdo-production.up.railway.app/v1/gb/solutions/invoice-payee-verification","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"payee":{"type":"object","required":["company_number","payee_fingerprint"],"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."},"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."}},"additionalProperties":false},"invoice":{"type":"object","required":["company_number"],"properties":{"vat_number":{"type":"string","maxLength":20,"description":"Optional UK VAT number; this route does not independently verify VAT registration."},"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."},"invoice_address":{"type":"object","properties":{"line_1":{"type":"string","maxLength":300},"line_2":{"type":"string","maxLength":300},"country":{"type":"string","maxLength":80},"locality":{"type":"string","maxLength":200},"postal_code":{"type":"string","maxLength":20}},"additionalProperties":false},"invoice_company_name":{"type":"string","maxLength":300,"minLength":1,"description":"Legal name printed on the invoice."}},"additionalProperties":false},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$","description":"Caller-generated key. Send the identical value in the Idempotency-Key header."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.09","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.09/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.09","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.09","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_e9nXNIg-FyQmXO5X9JDej","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.09","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Verifies that the company number on a UK invoice matches the intended payee and validates a time-bound payee-binding control in a single pre-payment call.","exampleAgentPrompt":"Before we pay this invoice from Acme Supplies Ltd (Companies House number 12345678, VAT GB123456789), can you verify it's consistent with our payee fingerprint 'fp-acme-uk-9a2b3c4d' and confirm the binding evidence type PREVIOUSLY_VERIFIED_BINDING is still valid until 2025-12-31T23:59:59Z, verified on 2024-06-01T10:00:00Z with reference 'binding-ref-2024-001'?","exampleUseCases":[{"title":"Pre-payment invoice fraud check","prompt":"We've received an invoice from Global Tech Solutions Ltd (company number 09876543) and want to pay it — can you check that the company number on the invoice matches our payee with fingerprint 'fp-gts-uk-7x8y9z' and that our BANK_PROVIDER_CONFIRMATION binding, verified on 2024-11-15T09:00:00Z, valid until 2026-01-01T00:00:00Z, reference 'bpc-gts-nov2024', is still good before we release the payment?"},{"title":"Accounts payable batch pre-check","prompt":"Before approving payment to Meridian Consulting Ltd (Companies House 01234567, invoice name 'Meridian Consulting Limited'), verify that our payee fingerprint 'fp-meridian-4d5e6f' is correctly bound using our CUSTOMER_CONFIRMATION evidence referenced 'cc-meridian-2025', verified 2025-01-10T08:30:00Z and valid until 2025-07-10T08:30:00Z."},{"title":"New supplier first-payment clearance","prompt":"We're about to make our first payment to Bright Future Renewables (company number SC123456), whose invoice shows address line 1 '10 Industrial Park, Edinburgh', postal code 'EH1 1AB'. Can you confirm the invoice company number matches our payee fingerprint 'fp-bfr-sc-aa1b2c3d' and that our CHALLENGE binding evidence, reference 'chall-bfr-2025-03', verified at 2025-03-01T12:00:00Z and valid until 2025-09-01T12:00:00Z, is within its validity window?"}],"resultDescription":"Returns a structured outcome indicating whether the invoice's Companies House company number is consistent with the registered payee and whether the time-bound payee-binding control is currently valid. Does not independently verify bank account ownership or invoice authenticity.","failureModes":["Binding evidence expired (valid_until in the past) — returns validation failure","Company number format mismatch or invalid pattern — returns schema validation error","Payee fingerprint too short or missing — returns 400 bad request","Invoice company number does not match payee company number — returns consistency failure","Missing required fields (company_number or payee_fingerprint) — returns 422 unprocessable entity","Payment not made / x402 auth failure — returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you already know both the invoice details and the intended payee and need a fast, single-call pre-payment check that the invoice company number is consistent with the payee and that a time-bound binding control is still valid. Prefer this over broader supplier onboarding or full due-diligence endpoints when the goal is narrow invoice-payee consistency validation rather than company identity resolution or full payment authorization.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:31:07.329Z","isFirstParty":false}