{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://weverlabs.com/schemas/agent-settlement-receipt.schema.json",
  "title": "Agent Settlement Receipt",
  "description": "Receipt for provider settlement that funds Wever Labs OS credits. This is separate from usage receipts, which record credits consumed by agent work.",
  "type": "object",
  "required": [
    "receipt_id",
    "receipt_type",
    "settlement_id",
    "settlement_provider",
    "settlement_asset",
    "settlement_amount",
    "credit_entitlement_id",
    "credits_funded",
    "funded_account_id",
    "provider_status",
    "settlement_status",
    "issued_at"
  ],
  "additionalProperties": true,
  "properties": {
    "receipt_id": {
      "type": "string"
    },
    "receipt_type": {
      "type": "string",
      "const": "agent_settlement_receipt"
    },
    "settlement_id": {
      "type": "string"
    },
    "settlement_provider": {
      "type": "string",
      "enum": [
        "stripe_stablecoin",
        "x402",
        "circle_usdc",
        "manual_invoice",
        "other"
      ]
    },
    "settlement_asset": {
      "type": "string"
    },
    "settlement_amount": {
      "type": "number",
      "minimum": 0
    },
    "settlement_currency": {
      "type": "string"
    },
    "provider_reference": {
      "type": "string"
    },
    "payment_request_id": {
      "type": "string"
    },
    "payment_request_url": {
      "type": "string",
      "format": "uri"
    },
    "webhook_event_id": {
      "type": "string"
    },
    "webhook_verified": {
      "type": "boolean"
    },
    "settlement_status": {
      "type": "string",
      "enum": [
        "payment_requested",
        "provider_confirmed",
        "credits_funded",
        "voided",
        "refunded",
        "disputed"
      ]
    },
    "provider_status": {
      "type": "string"
    },
    "credit_entitlement_id": {
      "type": "string"
    },
    "funded_account_id": {
      "type": "string"
    },
    "credits_funded": {
      "type": "number",
      "minimum": 0
    },
    "credit_unit": {
      "type": "string",
      "default": "wever_labs_credit"
    },
    "release_policy": {
      "type": "string",
      "enum": [
        "automatic_on_provider_confirmation",
        "manual_release",
        "contract_rule"
      ]
    },
    "usage_receipt_policy": {
      "type": "string",
      "const": "usage_receipts_record_credits_consumed_after_work_runs"
    },
    "result_contract_url": {
      "type": "string",
      "format": "uri"
    },
    "public_safe_note": {
      "type": "string"
    },
    "issued_at": {
      "type": "string",
      "format": "date-time"
    },
    "os_support_matrix_url": {
      "type": "string",
      "format": "uri"
    },
    "rail_binding_url": {
      "type": "string",
      "format": "uri"
    },
    "runtime_execution_plan_url": {
      "type": "string",
      "format": "uri"
    }
  }
}