# Counterparty Invoice & Corporate Number Verification

> Counterparty Invoice & Corporate Number Verification is a paid API for AI agents from ai-agent-payment-safety-stack.onrender.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-13).

Verifies a payment counterparty's name, invoice registration number, and corporate number for format correctness and name consistency before an AI agent executes a payment.

## Facts

- Endpoint: POST https://ai-agent-payment-safety-stack.onrender.com/api/counterparty-invoice/check
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/counterparty-invoice-corporate-number-verification-ee2972c3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nvDcIe8EMXWPH3VApFt25

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 counterparty-invoice-corporate-number-verification-ee2972c3 -d '<json body>'
```

Example prompt: Before you pay this invoice, check the counterparty details: company name is 'Acme Supplies Ltd', invoice registration number is 'INV-2024-00847', and corporate number is '12345678' — do the name and numbers match up and are they correctly formatted?

## When to prefer this

Use this endpoint when an AI agent is about to execute a payment and needs a lightweight pre-payment sanity check to confirm the counterparty name, invoice registration number, and corporate number are internally consistent and correctly formatted. Prefer this over full KYC or AML services when you only need format and name-match validation, not regulatory compliance or legal opinions.

## Known failure modes

- Mismatched name and corporate number returns a failed match result
- Malformed invoice registration number fails format check
- Missing required fields returns a validation error
- Corporate number not found or unrecognized format returns an error
- Service unavailable on Render cold start returns a timeout or 503

## How this service works

Verify counterparty name, invoice registration number, and corporate number before AI-agent payment. Format check and name match only. No tax or legal advice.

## Output

Returns a verification result indicating whether the counterparty name matches the provided registration and corporate numbers, and whether each field passes format validation. Includes pass/fail status per field and overall match result. No tax or legal advice is provided.

## Example request

```json
{
 "amount": "5000.00",
 "task_id": "TASK-2024-001",
 "request_id": "REQ-2024-001",
 "evidence_ids": [
  "EV-001",
  "EV-002"
 ],
 "paid_endpoint": "https://api.example.com/payment",
 "payment_asset": "USD",
 "payer_agent_id": "agent-qa-001",
 "delivery_status": "completed",
 "corporate_number": "12345678",
 "counterparty_name": "Acme Supplies Ltd",
 "payment_reference": "PAY-2024-001",
 "transaction_reference": "TXN-123456",
 "actual_service_response": {
  "status": "success",
  "transaction_id": "TXN-123456"
 },
 "expected_service_response": {
  "status": "success",
  "transaction_id": "TXN-123456"
 },
 "service_response_received": true,
 "invoice_registration_number": "INV-2024-00847"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name_match_status": {
   "type": "string"
  },
  "wallet_match_status": {
   "type": "string"
  },
  "recommended_next_step": {
   "type": "string"
  },
  "requires_human_review": {
   "type": "boolean"
  },
  "counterparty_check_status": {
   "type": "string"
  },
  "invoice_number_format_valid": {
   "type": "boolean"
  },
  "corporate_number_format_valid": {
   "type": "boolean"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name_match_status": "match",
  "wallet_match_status": "format_valid",
  "recommended_next_step": "proceed_to_payment",
  "requires_human_review": false,
  "counterparty_check_status": "ok",
  "invoice_number_format_valid": true,
  "corporate_number_format_valid": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/counterparty-invoice-corporate-number-verification-ee2972c3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ai-agent-payment-safety-stack.onrender.com](https://www.zero.xyz/host/ai-agent-payment-safety-stack.onrender.com/llms.txt)