{"uid":"cap_EA40OZh3lJH12lJmXEXV2","slug":"runonproof-uk-vendor-payment-detail-change-continuous-authorization-996ccdee","name":"RunOnProof UK Vendor Payment-Detail Change Continuous Authorization","description":"Authorize a scoped UK vendor payment-detail change with current company/sanctions controls and a fresh independent challenge. Use before changing the payee, then continue monitoring through separate technical controls. The authorization is expiring and single-use.","url":"https://cdo-production.up.railway.app/v1/gb/solutions/vendor-change-continuous-authorization","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"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},"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.2","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.2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4_bIzjWWznUZUQ8cOTetA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.2","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Authorize a scoped, single-use UK vendor payment-detail change with company/sanctions controls and a fresh independent challenge before updating payee details.","exampleAgentPrompt":"I need to authorize a payment detail change for UK company 12345678 — the current payee fingerprint is 'fp-vendor-old-001' and the proposed one is 'fp-vendor-new-001'. The prior authorization reference is 'AUTH-2024-XYZ', the challenge type is BANK_PROVIDER_CONFIRMATION with reference 'CHK-REF-001' verified just now and valid until tomorrow, and the idempotency key is 'idem-key-20240601-001'. Can you get continuous authorization for this change?","exampleUseCases":[{"title":"Approving a supplier bank account update","prompt":"We need to change the bank account details for our UK supplier registered as company 07654321. The old payee fingerprint is 'payee-hash-old-abc', the new one is 'payee-hash-new-xyz', the prior auth reference is 'AUTH-SUPP-2024-009', the challenge is a CUSTOMER_CONFIRMATION with reference 'CC-EVD-007' verified at noon today and valid until end of day, and the idempotency key is 'supp-chg-20240601-007'. Please get authorization to proceed."},{"title":"Fraud prevention on payee change","prompt":"Before we update the payee for UK company 09876543, I need a fresh single-use continuous authorization. Current payee fingerprint is 'fp-cur-543', proposed is 'fp-new-543', the existing auth reference is 'AUTH-PREV-543', and we have a BANK_PROVIDER_CONFIRMATION challenge with reference 'BPC-REF-543', verified an hour ago and valid for 24 hours. Idempotency key is 'fraud-check-543-v1'. Can you authorize this change?"},{"title":"Sanctioned entity check before payee switch","prompt":"We're about to switch the payee for UK vendor with company number 00112233. The current payee fingerprint is 'cp-fingerprint-00112233', proposed is 'np-fingerprint-00112233', prior authorization reference is 'AUTH-VND-00112233', challenge type is PREVIOUSLY_VERIFIED_BINDING with reference 'PVB-112233' verified yesterday and valid for 48 hours, and idempotency key is 'vendor-upd-112233-2024'. Please run continuous authorization including sanctions controls before we make the change."}],"resultDescription":"Returns a scoped, single-use authorization decision indicating whether the proposed payee change is approved under current company and sanctions controls, along with an authorization reference, expiry timestamp, and details of the control checks performed. The authorization is time-limited and cannot be reused.","failureModes":["Challenge expired (valid_until in the past) — authorization refused","Company number not found or invalid format — validation error","Proposed payee fingerprint matches a sanctioned entity — authorization denied","Prior authorization reference not recognized or already consumed — rejection","Idempotency key mismatch between body and header — request rejected","Challenge type not accepted for the requested change scope — error response","Company has active sanctions flags — authorization blocked"],"whenToPreferThis":"Use this endpoint specifically when you need a continuous, scoped, single-use authorization for a UK vendor payment-detail change — particularly when you already have a prior authorization reference and a fresh independent challenge. It is distinct from a one-shot payment authorization and from initial onboarding checks. Prefer it when your compliance workflow requires an expiring authorization gate before updating payee details, with sanctions and Companies House controls applied at the moment of change rather than at onboarding.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:32:07.163Z","isFirstParty":false}