{"uid":"cap_m6Qr69v2_SYVNWSYMD1oU","slug":"runonproof-uk-payment-authorization-gate-d2014409","name":"RunOnProof UK Payment Authorization Gate","description":"Authorize one bounded UK company payment by composing supplier, invoice, payee and optional vendor-change gates. Use immediately before releasing a payment. Any incomplete, unavailable or mismatched gate returns HOLD or DENY, not approval.","url":"https://cdo-production.up.railway.app/v1/gb/payments/authorize","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.15","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.15/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jQgr2qYKp9Z3nZerrqjCX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.15","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 company payment by composing supplier identity, invoice, payee binding, and optional vendor-change gates — returning APPROVE, HOLD, or DENY based on all gate outcomes.","exampleAgentPrompt":"Before we release the £4,250.00 GBP payment to supplier company number 12345678 — with payee fingerprint 'fp_abc123xyz456' and a previously-verified binding confirmed today valid until end of year — can you run it through the RunOnProof payment authorization gate to make sure everything checks out?","exampleUseCases":[{"title":"Accounts payable fraud prevention check","prompt":"We're about to release a £12,500 GBP payment to UK company 09876543 — the invoice is from company number 09876543 and we have a bank-provider confirmation binding verified this morning, valid until December 31st, with payee fingerprint 'fp_vendor_secure_99aa'. Can you authorize this payment before we send it?"},{"title":"Blocked payment due to incomplete payee binding","prompt":"I need to know if we can pay this invoice: £3,800 GBP to UK company number 00123456, payee fingerprint 'fp_newvendor_zz8812', but we only have a customer confirmation binding verified last week valid until next month. Will the payment gate approve or hold it?"},{"title":"High-value supplier payment with vendor-change gate","prompt":"Our supplier Acme Ltd (company number 01234567) just updated their bank details and we want to pay their invoice for £28,000 GBP — payee fingerprint is 'fp_acme_newbank_2024' with a challenge-type binding verified today valid until March 31st. Please run the full RunOnProof payment authorization including the vendor-change gate before we proceed."}],"resultDescription":"Returns a structured authorization decision (APPROVE, HOLD, or DENY) for the payment, along with individual gate outcomes for the supplier identity, invoice matching, payee binding, and any vendor-change gate. HOLD or DENY responses include specific reasons indicating which gate failed or was incomplete, giving the caller actionable guidance on what to resolve before retrying.","failureModes":["Missing or invalid company number format returns validation error before authorization runs","Payee fingerprint below minimum length (8 chars) causes request rejection","Binding evidence with expired valid_until date causes gate to return HOLD or DENY","Mismatched invoice company number vs payee company number triggers DENY","Unavailable or unresolvable Companies House data causes affected gate to return HOLD","Payment amount in wrong format (e.g. more than 2 decimal places) causes schema validation failure","Any incomplete gate (missing required binding evidence) returns HOLD rather than approval"],"whenToPreferThis":"Use this endpoint immediately before releasing any outbound payment to a UK registered company, especially when you need a composable multi-gate check that combines supplier identity, invoice matching, and payee binding verification in a single call. Prefer it over manual checks or single-factor verification when your workflow requires an auditable authorization reference and explicit APPROVE/HOLD/DENY outcomes. It is particularly suited to automated accounts payable pipelines where vendor-change events (new bank details) require an additional authorization gate.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:34:11.152Z","isFirstParty":false}