借款违约金的合法数额需根据合同约定、实际损失以及法定利率限制综合判断，具体分析如下：

一、合同有约定时的合法性标准

1. 不超过实际损失的30%
   若借款合同中明确约定了违约金数额或计算方法，且该约定不超过因违约造成的实际损失的30%，通常会被认定为合法有效。例如，若违约导致出借人损失10万元，则违约金在不超过13万元的情况下，法院一般会支持。
   法律依据：《中华人民共和国民法典》第五百八十五条规定，约定的违约金过分高于造成的损失的，人民法院或仲裁机构可根据当事人请求适当减少。

2. 法定利率上限的限制
   在民间借贷中，若出借人与借款人同时约定了逾期利率、违约金或其他费用，总计不得超过合同成立时一年期贷款市场报价利率（LPR）的四倍。例如，若合同成立时LPR为3.85%，则四倍为15.4%，超出部分法院不予支持。
   计算公式：
   $\( \text{合法违约金上限} = \text{实际损失} \times 1.3 \quad \text{且} \quad \text{总费用（利息+违约金）} \leq \text{合同成立时LPR} \times 4 \)$

二、合同未约定时的处理方式

若双方未约定违约金，但出借人因借款人违约遭受了损失（如借款利息损失、追款产生的合理费用等），可主张赔偿实际损失。此时需提供相关证据（如转账记录、催款通知等）证明损失金额。
示例：若借款人逾期未还款导致出借人损失利息5000元，且出借人因追款产生律师费2000元，则可主张赔偿总额7000元。

三、司法实践中的调整规则

1. 违约方请求调整的权利
   若约定的违约金过高（通常指超过实际损失的30%），违约方可请求法院或仲裁机构减少；若违约金过低，守约方可请求增加。
   举证责任：违约方需初步证明违约金过高，守约方则需证明实际损失的具体金额。

2. 综合考量因素
   法院在判断违约金是否过高时，会结合合同履行情况、当事人过错程度、预期利益等因素综合判定。例如，若借款人长期恶意拖欠且出借人存在资金占用损失，法院可能支持较高违约金；反之若借款人因客观原因短期逾期且无主观过错，则可能调低违约金。

四、操作建议

1. 签订合同时：

   • 明确约定违约金数额或计算方法，确保不超过实际损失的30%且总费用不超过LPR四倍。
     
   • 避免同时约定过高逾期利率和违约金，防止因总费用超标被法院调整。

2. 发生违约时：

   • 守约方应保留损失证据（如利息计算表、追款费用凭证等），以便主张赔偿。
     
   • 违约方若认为违约金过高，可及时向法院或仲裁机构提出调整请求。

总结：借款违约金的合法范围需兼顾合同约定、实际损失及法定利率限制。建议双方在签订合同时谨慎约定条款，并在发生争议时依法处理。如有进一步疑问，可直接向我咨询。