# Merchant Trust Score

> Merchant Trust Score is a paid API for AI agents from x402-agent-suite-production.up.railway.app, paid per call via x402, $0.06/call, status unknown (last checked 2026-09-14).

Scores a merchant's trustworthiness for AI agents making purchase decisions, returning an allowed/blocked verdict and summary.

## Facts

- Endpoint: POST https://x402-agent-suite-production.up.railway.app/api/merchant-trust/score
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/merchant-trust-score-3253af7b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oSR9_XIXkDxmDFeELn41N

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 merchant-trust-score-3253af7b -d '<json body>'
```

Example prompt: Before my agent pays this merchant, run a trust score check on them using a GET method — I need to know if they're allowed and get a plain-English summary of the risk.

## When to prefer this

Use this endpoint when an AI agent needs a pre-transaction safety check before authorizing payment to an unfamiliar merchant, especially in autonomous agent fleet contexts operating over x402 payment rails. Prefer this over generic fraud APIs when working within the x402 ecosystem where payment settlement is already being handled.

## Known failure modes

- Invalid or missing 'type' field (must be 'http') returns validation error
- Method not in allowed enum [GET, HEAD, DELETE] returns 400
- Payment not settled via x402 returns 402 Payment Required
- Merchant endpoint unreachable or unknown may return allowed=false with explanatory summary
- Malformed input object returns schema validation error

## How this service works

24 paid x402 infrastructure APIs for AI agent fleets: buy advisor, audition coach, guard, proxy, MPP, attestations, and pipeline orchestration.

## Output

Returns a JSON object with: ok (boolean indicating request success), allowed (boolean verdict on whether the merchant is safe to transact with), and summary (human-readable explanation of the trust assessment).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "ok",
      "allowed",
      "summary"
     ],
     "properties": {
      "ok": {
       "type": "boolean"
      },
      "allowed": {
       "type": "boolean"
      },
      "summary": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "allowed": true,
  "summary": "Paid response after x402 settlement"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/merchant-trust-score-3253af7b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-agent-suite-production.up.railway.app](https://www.zero.xyz/host/x402-agent-suite-production.up.railway.app/llms.txt)