{"uid":"cap_EILcryGCOaOCRytDH5xyT","slug":"runonproof-uk-payment-authorization-f62aefc3","name":"RunOnProof UK Payment Authorization","description":"Authorize one UK business payment by composing supplier, invoice and payee controls into a single decision and settlement. Use immediately before payment release. Missing or source-conditioned evidence produces HOLD; the token is bounded and single-use.","url":"https://cdo-production.up.railway.app/v1/gb/solutions/payment-authorization","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},"amount":{"type":"string","pattern":"^\\d+(?:\\.\\d{1,2})?$","description":"Positive decimal payment amount in the declared currency; not the x402 fee."},"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},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"ISO 4217 currency code for the business payment instruction."},"supplier":{"type":"object","required":["company_number","policy_id"],"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},"policy_id":{"type":"string","maxLength":120,"minLength":3,"description":"Declared onboarding policy, normally GB_NEW_SUPPLIER_V1."},"vat_number":{"type":"string","maxLength":20},"eori_number":{"type":"string","maxLength":30},"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."},"sanctions_subject_names":{"type":"array","items":{"type":"string","maxLength":300,"minLength":3},"maxItems":25,"uniqueItems":true}},"additionalProperties":false},"vendor_change":{"type":"object","required":["company_number","current_payee_fingerprint","proposed_payee_fingerprint","prior_authorization_reference","challenge","idempotency_key"],"properties":{"challenge":{"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},"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."},"current_payee_fingerprint":{"type":"string","maxLength":200,"minLength":8,"description":"Opaque caller-generated fingerprint; never send raw bank-account details."},"proposed_payee_fingerprint":{"type":"string","maxLength":200,"minLength":8,"description":"Opaque caller-generated fingerprint; never send raw bank-account details."},"prior_authorization_reference":{"type":"string","maxLength":200,"minLength":1,"description":"Reference to the currently approved vendor/payee binding."}},"additionalProperties":false},"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."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_M2FlXzeqXuYn4dFx9JZVJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Authorizes a single UK business payment by composing supplier identity, invoice, and payee binding controls into one decision, returning approval or a HOLD with traceable evidence.","exampleAgentPrompt":"Can you run a payment authorization for our UK supplier Acme Widgets Ltd (Companies House number 12345678) — we have a BANK_PROVIDER_CONFIRMATION binding on payee fingerprint 'fp-acme-sort-acc-9876', verified yesterday and valid until end of March, reference 'BPC-2024-001' — and the invoice is from the same company for £4,750.00?","exampleUseCases":[{"title":"Accounts payable release gate","prompt":"We're about to release a £12,500 payment to our UK supplier (company number 09876543). We have a previously verified payee binding, reference 'PVB-SUP-0042', verified last week and valid until June 30. Can you run the payment authorization check before we release funds to payee fingerprint 'fp-supplier-gbp-0042'?"},{"title":"Invoice-to-pay compliance check","prompt":"Before we pay this invoice from UK company SC123456, I need to authorize the payment of £3,200.00. The payee fingerprint is 'fp-sc-invoice-7731', we have a CUSTOMER_CONFIRMATION binding verified this morning with reference 'CC-2024-SC-01' and it's valid until end of month. Run the authorization for me."},{"title":"Flagging suspicious payee for HOLD","prompt":"We've received a change to supplier bank details for company 00123456 and need to authorize a payment of £8,900.00 before it goes out. The payee fingerprint is 'fp-new-details-8801' — we only have a CHALLENGE-type binding reference 'CHG-2024-04' verified two days ago, valid until next Friday. Can RunOnProof tell us whether to approve or hold this payment?"}],"resultDescription":"Returns a structured authorization decision: APPROVED (with a bounded, single-use settlement token) or HOLD (with a reason code and traceable evidence references explaining which control — supplier identity, invoice match, or payee binding — was missing or failed). The token is time-bounded and must be used immediately before payment release.","failureModes":["Missing or expired payee binding evidence produces a HOLD decision rather than an error","Payee fingerprint too short or company number format invalid returns a 400 validation error","Source-conditioned evidence (e.g. binding verified by an untrusted source) causes a HOLD","Payment amount with more than 2 decimal places rejected by schema validation","Invoice company number mismatch with payee triggers a HOLD","Attempting to reuse a single-use token results in rejection","Stale valid_until timestamp (in the past) causes binding evidence to be rejected"],"whenToPreferThis":"Use this endpoint immediately before releasing any UK business payment where you need a single composed decision across supplier identity (Companies House), invoice provenance, and payee bank-account binding. Prefer it over separate due-diligence checks when you need a single-use, bounded authorization token as a control gate in your payment workflow. It is especially suited for automated accounts-payable pipelines where the HOLD/APPROVE signal must be machine-readable and auditable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:40:19.931Z","isFirstParty":false}