{"uid":"cap_mHrnWrzwjoNuCkkg8kYcY","slug":"runonproof-uk-vendor-payment-detail-change-authorization-e49466b1","name":"RunOnProof UK Vendor Payment-Detail Change Authorization","description":"Authorize one UK vendor payment-detail change using current supplier controls, an existing authorization reference and a fresh independent challenge. Use before updating a payee record. The result is expiring and single-use; raw bank data is not accepted.","url":"https://cdo-production.up.railway.app/v1/gb/vendors/authorize-payment-detail-change","method":"POST","headers":{},"bodySchema":{"type":"object","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."}}},"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_eGcfjyHUmzz4Ra0YI4J-K","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-use, expiring change to a UK vendor's payment details by validating existing supplier controls, a prior authorization reference, and a fresh independent challenge—without accepting raw bank data.","exampleAgentPrompt":"I need to authorize a payment-detail change for UK vendor company number 12345678 — the current payee fingerprint is 'fpOLD-abc123', the proposed one is 'fpNEW-xyz789', the prior authorization reference is 'AUTH-REF-2024-001', and I have a CHALLENGE-type evidence reference 'CHAL-EV-0042' verified today and valid until tomorrow noon. Please get a single-use approval so I can safely update the payee record.","exampleUseCases":[{"title":"Secure supplier bank account update","prompt":"Our finance team needs to change the payment details for UK supplier number 09876543 — current payee fingerprint is 'fp-CURR-9912', proposed is 'fp-NEW-4481', prior auth ref is 'VEND-AUTH-88', and we have a BANK_PROVIDER_CONFIRMATION reference 'BPCONF-2025-77' verified an hour ago, valid for the next 24 hours. Can you get the authorization so we can safely update the payee record?"},{"title":"Fraud-check before payee record edit","prompt":"Before my accounts-payable system updates the bank details for Companies House number OC112233, I need a single-use authorization. Current fingerprint is 'fing-OLD-332', proposed is 'fing-NEW-881', existing authorization ref is 'AP-BIND-2025-55', and the challenge is a CUSTOMER_CONFIRMATION type with reference 'CUST-CONF-101', verified just now, expiring in 6 hours."},{"title":"Automated vendor onboarding payee change gate","prompt":"As part of our automated vendor onboarding pipeline, I need to authorize a payment-detail change for UK company 00445566 — old payee fingerprint 'payee-hash-AA1', new fingerprint 'payee-hash-BB2', prior authorization reference 'ONBOARD-AUTH-2025-9', with a PREVIOUSLY_VERIFIED_BINDING challenge reference 'PVB-REF-007' verified yesterday, valid until end of day today. Generate the expiring approval so the pipeline can proceed."}],"resultDescription":"Returns a single-use, expiring authorization reference confirming that the proposed vendor payment-detail change is approved under the current supplier controls and challenge evidence. The result is time-limited and must be consumed immediately when updating the payee record; raw bank data is never returned.","failureModes":["Challenge expired (valid_until in the past) — authorization rejected","Prior authorization reference not found or already consumed — request fails","Payee fingerprint mismatch with existing records — authorization denied","Company number format invalid or not found at Companies House — validation error","Idempotency key reuse with differing parameters — conflict error","Challenge type not accepted given current supplier controls — rejected","Authorization result already consumed (single-use exhausted) — cannot reuse"],"whenToPreferThis":"Use this endpoint specifically when you need to authorize a change to an existing UK vendor's payment details before updating a payee record, and you already hold a prior authorization reference and a fresh independent challenge. It is the right choice when raw bank data must never be transmitted and the approval must be single-use and time-limited. Prefer it over generic authorization flows when UK Companies House company controls and payee fingerprinting are the required security model.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:42:17.748Z","isFirstParty":false}