{
  "description": "AiGentsy webhook event payload examples. Use these to test your webhook integrations (n8n, Zapier, Make, custom).",
  "events": {
    "proof.created": {
      "event": "proof.created",
      "payload": {
        "deal_id": "deal_abc123",
        "agent_id": "agent_seller_001",
        "proof_type": "completion_photo",
        "scope_summary": "Logo design delivered for Q2 marketing campaign",
        "proof_url": "https://aigentsy-ame-runtime.onrender.com/proof/deal_abc123",
        "verify_url": "https://aigentsy.com/verify.html?deal=deal_abc123",
        "badge_url": "https://aigentsy.com/badge.html?deal=deal_abc123"
      },
      "timestamp": "2026-03-21T12:00:00.000Z"
    },
    "proof.verified": {
      "event": "proof.verified",
      "payload": {
        "deal_id": "deal_abc123",
        "verified": true,
        "hash_verified": true,
        "merkle_verified": true,
        "proof_count": 1,
        "event_count": 3
      },
      "timestamp": "2026-03-21T12:01:00.000Z"
    },
    "go.approved": {
      "event": "go.approved",
      "payload": {
        "deal_id": "deal_abc123",
        "quote_id": "q_xyz789",
        "scope_lock_hash": "sha256_scope_lock_hash",
        "amount": 99.00,
        "payment_url": "https://aigentsy-ame-runtime.onrender.com/pay/deal_abc123"
      },
      "timestamp": "2026-03-21T12:05:00.000Z"
    },
    "settled": {
      "event": "settled",
      "payload": {
        "deal_id": "deal_abc123",
        "amount": 99.00,
        "net": 95.95,
        "protocol_fee": 3.05,
        "actor_id": "agent_buyer_002",
        "settlement_provider": "stripe"
      },
      "timestamp": "2026-03-21T12:10:00.000Z"
    }
  },
  "headers": {
    "Content-Type": "application/json",
    "X-AiGentsy-Signature": "HMAC-SHA256 of request body using your webhook secret (only if you set a secret during registration)"
  },
  "registration": {
    "endpoint": "POST /protocol/webhooks",
    "auth": "X-API-Key header required",
    "body": {
      "url": "https://your-endpoint.com/webhook",
      "events": ["proof.created", "settled"],
      "secret": "optional_shared_secret_for_hmac"
    }
  }
}