{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/agentpay-so/json-schema/agentpay-so-payment-verify-response-schema.json",
  "title": "PaymentVerifyResponse",
  "x-generated": "2026-11-01",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/agentpay-so-openapi.yml#/components/schemas/PaymentVerifyResponse",
  "type": "object",
  "properties": {
    "verified": {
      "type": "boolean"
    },
    "status": {
      "type": "string",
      "enum": [
        "unseen",
        "observed",
        "matched",
        "confirmed",
        "unmatched"
      ],
      "description": "- unseen: tx hash not found anywhere\n- observed: settlement event found, not yet confirmed\n- matched: on-chain confirmed, resolution engine pending\n- confirmed: fully resolved and verified\n- unmatched: resolution engine rejected or policy mismatch\n"
    },
    "intentId": {
      "type": [
        "string",
        "null"
      ]
    },
    "agentId": {
      "type": [
        "string",
        "null"
      ]
    },
    "merchantId": {
      "type": [
        "string",
        "null"
      ]
    },
    "settlementTimestamp": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "reasonCode": {
      "type": [
        "string",
        "null"
      ]
    },
    "signature": {
      "type": "string",
      "description": "HMAC-SHA256 of the payload — verify using your WEBHOOK_SECRET"
    },
    "verifiedAt": {
      "type": "string",
      "format": "date-time"
    }
  }
}