# RunOnProof UK Payee Binding Evaluation

> RunOnProof UK Payee Binding Evaluation is a paid API for AI agents from cdo-production.up.railway.app, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Evaluates time-bound caller or provider payee-binding control evidence for a UK company before paying a known supplier, returning MATCH, NO_MATCH, or REVIEW based on opaque fingerprint evidence.

## Facts

- Endpoint: POST https://cdo-production.up.railway.app/v1/gb/payees/match-business
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/runonproof-uk-payee-binding-evaluation-df9c5a3e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_d0L7oj7_CVhPHC66NNYwS

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability runonproof-uk-payee-binding-evaluation-df9c5a3e -d '<json body>'
```

Example prompt: Before we pay Acme Supplies Ltd (company number 09876543), run a payee binding check using our existing PREVIOUSLY_VERIFIED_BINDING evidence referenced as 'acme-binding-2024-001', which was verified on 2024-11-01 and is valid until 2025-06-30, against their payee fingerprint 'fp-acme-uk-9a3b2c1d'.

## When to prefer this

Use this endpoint when you already hold caller-side or provider-side binding evidence (e.g. a previous verification, a bank confirmation, or a challenge response) for a known UK supplier and need a lightweight, time-bound control check before releasing a payment. It is not a first-pass identity lookup (use the UK Companies House resolution endpoint for that), nor does it independently prove bank-account ownership — it evaluates the evidence you supply via opaque fingerprints only.

## Known failure modes

- Evidence valid_until is in the past — binding is expired, returns REVIEW or NO_MATCH
- Company number format invalid — 422 validation error
- Payee fingerprint below minimum length — validation error
- Binding evidence reference missing or empty — schema validation failure
- Idempotency key reused with different payload — conflict error
- Future-dated verified_at timestamp — rejected as invalid evidence

## How this service works

Evaluate a time-bound caller or provider payee-binding control for a UK company. Use before paying a known supplier. It accepts opaque fingerprints only and does not independently prove bank-account ownership; missing evidence returns REVIEW.

## Output

Returns a structured evaluation result indicating MATCH, NO_MATCH, or REVIEW for the payee binding control. MATCH means evidence is valid and within its time bounds; NO_MATCH means evidence fails the check; REVIEW is returned when evidence is missing or insufficient for a determination. No raw bank-account data is returned or required.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "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."
  },
  "idempotency_key": {
   "type": "string",
   "pattern": "^[A-Za-z0-9._:-]{8,120}$",
   "description": "Caller-generated key. Send the identical value in the Idempotency-Key header."
  },
  "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."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/runonproof-uk-payee-binding-evaluation-df9c5a3e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from cdo-production.up.railway.app](https://www.zero.xyz/host/cdo-production.up.railway.app/llms.txt)