x402-secure-api-staging.t54.ai

{
  "capabilities": {
    "dashboard_fields": [
      "dashboard_summary.decision",
      "dashboard_summary.decision_id",
      "dashboard_summary.risk_level",
      "dashboard_summary.vi_verified",
      "dashboard_summary.constraint_violations",
      "dashboard_summary.issuer_profile",
      "dashboard_summary.evidence_ref"
    ],
    "headers": [
      "X-PAYMENT",
      "X-VERIFIABLE-INTENT",
      "X-AP2-EVIDENCE",
      "X-VI-DECISION-ID",
      "X-VI-EVIDENCE-REF"
    ],
    "policy_fields": [
      "requireVerifiableIntent",
      "requireVerifiedIntent",
      "requirePaymentMandate",
      "requireHolderBinding",
      "requireTrace",
      "acceptedIssuers",
      "reviewMode"
    ],
    "protocols": [
      "x402-secure.vi.v1",
      "mastercard-vi-v0.1",
      "ap2"
    ],
    "supported_evidence": [
      "verifiable_intent",
      "payment_context",
      "binding",
      "ap2_context",
      "trace_context",
      "agent_trace"
    ],
    "trustline_endpoint": "/api/v1/validation/assess-verifiable-intent"
  },
  "input": {
    "bodyFields": {
      "agent_id": {
        "description": "Optional agent identifier. Defaults to the wallet address when omitted.",
        "required": false,
        "type": "string"
      },
      "ap2_context": {
        "description": "Optional AP2 intent/cart/payment mandate references. Can also be supplied with X-AP2-EVIDENCE.",
        "required": false,
        "type": "object"
      },
      "authorization": {
        "description": "Upstream Authorization token.",
        "required": true,
        "type": "string"
      },
      "binding": {
        "description": "Optional normalized payment binding result produced by X402 Secure or a hosted facilitator.",
        "required": false,
        "type": "object"
      },
      "metadata": {
        "description": "Optional caller metadata for partner sandbox correlation.",
        "required": false,
        "type": "object"
      },
      "payment_context": {
        "description": "Normalized x402 payment context including chain/network, asset, amount, destination/payee, and resource when available.",
        "required": true,
        "type": "object"
      },
      "policy": {
        "description": "Optional VI/AP2 policy hints such as requireVerifiableIntent, requireTrace, acceptedIssuers, and reviewMode.",
        "required": false,
        "type": "object"
      },
      "trace_context": {
        "description": "Optional trace references such as riskSession, traceRef, traceparent, or tracestate.",
        "required": false,
        "type": "object"
      },
      "verifiable_intent": {
        "description": "Mastercard Verifiable Intent-style evidence envelope. Use camelCase 'verifiableIntent' or the X-VERIFIABLE-INTENT header if preferred.",
        "required": true,
        "type": "object"
      },
      "wallet_address": {
        "description": "Wallet address that will authorize or execute the payment.",
        "required": true,
        "type": "string"
      }
    },
    "bodyType": "json",
    "headerFields": {
      "X-AP2-EVIDENCE": {
        "description": "Optional compact AP2 mandate reference, JSON envelope, or base64url JSON envelope. Merged into ap2Context; body fields take precedence.",
        "required": false,
        "type": "string"
      },
      "X-PAYMENT": {
        "description": "Base64-encoded JSON PaymentPayload; automatically filled by x402scan",
        "required": false,
        "type": "string"
      },
      "X-VERIFIABLE-INTENT": {
        "description": "Optional compact VI evidence reference, JSON envelope, or base64url JSON envelope. Merged into verifiableIntent; body fields take precedence.",
        "required": false,
        "type": "string"
      },
      "X-VI-DECISION-ID": {
        "description": "Optional prior X402 Secure VI decision id for correlation and diagnostics. Settle-time receipt authority comes from the server-side VI assessment.",
        "required": false,
        "type": "string"
      },
      "X-VI-EVIDENCE-REF": {
        "description": "Optional Trustline evidence reference returned from a VI assessment.",
        "required": false,
        "type": "string"
      }
    },
    "method": "POST",
    "type": "http"
  },
  "output": {
    "binding": "object",
    "dashboard_summary": {
      "properties": {
        "binding_violations": "array",
        "constraint_satisfied": "boolean",
        "constraint_violations": "array",
        "decision": {
          "enum": [
            "allow",
            "deny",
            "review",
            "challenge",
            "unknown"
          ],
          "type": "string"
        },
        "decision_id": "string|null",
        "evidence_ref": "string|null",
        "issuer_profile": "object|null",
        "payment_bound": "boolean",
        "payment_network": "string|null",
        "reasons": "array",
        "risk_level": {
          "enum": [
            "low",
            "medium",
            "high",
            "critical",
            "unknown"
          ],
          "type": "string"
        },
        "trustline_status": {
          "enum": [
            "available",
            "unavailable"
          ],
          "type": "string"
        },
        "vi_parsed": "boolean",
        "vi_present": "boolean",
        "vi_profile": "string|null",
        "vi_verified": "boolean",
        "warnings": "array"
      },
      "type": "object"
    },
    "decision": {
      "enum": [
        "allow",
        "deny",
        "review",
        "challenge",
        "unknown"
      ],
      "type": "string"
    },
    "decision_id": "string",
    "reasons": "array",
    "risk_level": {
      "enum": [
        "low",
        "medium",
        "high",
        "critical",
        "unknown"
      ],
      "type": "string"
    },
    "trustline_assessment": "object|null",
    "ttl_seconds": "number",
    "vi": "object",
    "warnings": "array"
  }
}