Agent Transaction Trust

Free, read-only entry point. Call this first when deciding whether Agent Transaction Trust fits an x402 purchase. Returns capabilities, supported authority modes, proof key, price/network information, and the endpoints needed for authorization and settlement verification.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Free prerequisite for AP2-native authorization. Call before authorize_x402_ap2, bind the returned challenge into the AP2 Payment Mandate proof, then pass that challenge token as ap2_authority.challenge_token. The challenge is short-lived and intended for one authorization flow.

{
  "type": "object",
  "properties": {
    "ttl_seconds": {
      "type": "integer",
      "minimum": 30,
      "maximum": 300,
      "description": "Challenge lifetime in seconds. Optional; must be 30-300 seconds when provided."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Free, read-only token check. Use this to validate the signature and expiry of a Trust policy, authorization token, or settlement receipt; it does not perform on-chain settlement verification.

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "minLength": 1,
      "description": "Signed Trust token returned by policy issuance, authorization, or settlement verification."
    }
  },
  "required": [
    "token"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Free post-payment step. Call only after the merchant x402 payment for a previously approved authorization. Verifies the Base USDC settlement on-chain and, when it matches the authorization, returns a signed settlement receipt. The authorization token comes from authorize_x402_ap2; payment_response is the merchant x402 PAYMENT-RESPONSE when available. No additional Trust fee is charged.

{
  "type": "object",
  "properties": {
    "authorization_token": {
      "type": "string",
      "minLength": 1,
      "description": "Signed authorization_token returned by authorize_x402_ap2 for the exact merchant request."
    },
    "payment_response": {
      "type": "string",
      "minLength": 1,
      "description": "Optional merchant x402 PAYMENT-RESPONSE header/value from the completed payment; omit only when on-chain reconciliation can identify the settlement."
    }
  },
  "required": [
    "authorization_token"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Paid pre-payment trust gate. Use after create_ap2_challenge and after receiving the merchant's real x402 PAYMENT-REQUIRED challenge, but before paying the merchant. Verifies AP2 v0.2 authority and binds approval to the exact merchant challenge and HTTP request. On approval returns authorization_token; next pay the merchant, then call verify_settlement. Machine price: $0.001 via x402. If authorization is denied, the Trust fee is not settled/charged.

{
  "type": "object",
  "properties": {
    "payment_required": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "object",
          "additionalProperties": {}
        }
      ],
      "description": "Merchant's real x402 PAYMENT-REQUIRED payload, either as the decoded object or the original encoded/string form."
    },
    "merchant_id": {
      "type": "string",
      "minLength": 1,
      "description": "Stable identifier for the merchant/resource being authorized."
    },
    "category": {
      "type": "string",
      "minLength": 1,
      "description": "Service/purchase category evaluated against the AP2 mandate constraints, for example ai-infrastructure."
    },
    "payer": {
      "type": "string",
      "minLength": 1,
      "description": "Base payer wallet address that will authorize the merchant x402 payment."
    },
    "request": {
      "type": "object",
      "properties": {
        "method": {
          "type": "string",
          "minLength": 1,
          "description": "HTTP method of the exact merchant request, for example POST."
        },
        "url": {
          "type": "string",
          "format": "uri",
          "description": "Absolute merchant resource URL that produced the x402 challenge."
        },
        "body": {
          "description": "Exact request body to bind to the authorization, when present."
        }
      },
      "required": [
        "method",
        "url"
      ],
      "additionalProperties": false,
      "description": "Exact HTTP request the agent intends to execute after approval; changing it invalidates the authorization binding."
    },
    "ap2_authority": {
      "type": "object",
      "properties": {
        "payment_mandate_chain": {
          "type": "string",
          "minLength": 1,
          "description": "AP2 v0.2 SD-JWT/KB-SD-JWT Payment Mandate delegation chain."
        },
        "challenge_token": {
          "type": "string",
          "minLength": 1,
          "description": "Short-lived challenge token obtained from create_ap2_challenge and bound into the AP2 proof."
        },
        "trusted_root_jwks": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": {}
          },
          "minItems": 1,
          "description": "Trusted P-256 public root JWKs used to verify the AP2 delegation chain."
        }
      },
      "required": [
        "payment_mandate_chain",
        "challenge_token",
        "trusted_root_jwks"
      ],
      "additionalProperties": false,
      "description": "AP2 authority proof for this exact purchase attempt."
    },
    "nonce": {
      "type": "string",
      "minLength": 1,
      "description": "Optional caller nonce for correlation; do not reuse across distinct purchase attempts."
    }
  },
  "required": [
    "payment_required",
    "merchant_id",
    "category",
    "payer",
    "request",
    "ap2_authority"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}