{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/luniumpay-com/json-schema/luniumpay-com-reward-balance-schema.json",
  "title": "RewardBalance",
  "description": "Saldo do agent_id — nunca da credencial. Rotacionar chave nao perde saldo.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/luniumpay-com-mesh-economy-api-openapi.yml#/components/schemas/RewardBalance",
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string"
    },
    "own_volume_cents": {
      "type": "integer"
    },
    "direct_referral_volume_cents": {
      "type": "integer"
    },
    "network_volume_cents": {
      "type": "integer"
    },
    "pending_rewards_cents": {
      "type": "integer"
    },
    "available_rewards_cents": {
      "type": "integer"
    },
    "paid_rewards_cents": {
      "type": "integer"
    },
    "lifetime_rewards_cents": {
      "type": "integer"
    },
    "reward_events": {
      "type": "integer"
    },
    "reversals": {
      "type": "integer"
    },
    "policy": {
      "$ref": "#/$defs/MeshEconomyPolicy"
    },
    "ledger": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/RewardEvent"
      }
    }
  },
  "$defs": {
    "MeshEconomyPolicy": {
      "type": "object",
      "description": "Regras publicas da economia. NO SETTLEMENT → NO REWARD.",
      "properties": {
        "model": {
          "type": "string"
        },
        "direct_rate": {
          "type": "string"
        },
        "direct_rate_bps": {
          "type": "integer"
        },
        "max_paid_levels": {
          "type": "integer"
        },
        "recruitment_reward": {
          "type": "boolean"
        },
        "requires_settled_transaction": {
          "type": "boolean"
        },
        "revenue_share_cap": {
          "type": "string"
        }
      }
    },
    "RewardEvent": {
      "type": "object",
      "description": "Lancamento do ledger. Imutavel: estorno e um lancamento NEGATIVO novo, nunca UPDATE nem DELETE.",
      "properties": {
        "transaction_id": {
          "type": "string"
        },
        "transaction_kind": {
          "type": "string",
          "enum": [
            "cashout",
            "cashin"
          ]
        },
        "source_agent_id": {
          "type": "string",
          "description": "Quem gerou o volume."
        },
        "referral_level": {
          "type": "integer"
        },
        "volume_cents": {
          "type": "integer"
        },
        "rate_bps": {
          "type": "integer"
        },
        "gross_reward_cents": {
          "type": "integer"
        },
        "revenue_cents": {
          "type": "integer",
          "description": "Receita da Lunium na operacao."
        },
        "revenue_cap_cents": {
          "type": "integer",
          "description": "Teto aplicavel a recompensa."
        },
        "final_reward_cents": {
          "type": "integer",
          "description": "Negativo quando e estorno."
        },
        "reward_usdt": {
          "type": [
            "number",
            "null"
          ]
        },
        "status": {
          "type": "string",
          "enum": [
            "pending",
            "available",
            "paid",
            "reversed"
          ]
        },
        "motivo": {
          "type": [
            "string",
            "null"
          ]
        },
        "criado_em": {
          "type": "string",
          "format": "date-time"
        }
      }
    }
  }
}