借款违约金的合法数额需根据合同约定、实际损失以及法定利率限制综合判断，具体如下：
合同有约定时的合法范围
- 不超过实际损失的30%：若借款合同中明确约定了违约金数额或计算方法，且该数额未超过因违约造成的实际损失的30%，通常会被认定为合法有效。例如，若违约导致出借人损失10万元，则违约金在不超过13万元的情况下，法院一般会支持。
- 可请求调整：若约定的违约金低于实际损失，出借人可要求增加；若违约金过高（超过实际损失的30%），借款人可请求法院或仲裁机构适当减少。
合同未约定时的处理方式
- 按实际损失赔偿：若合同未约定违约金，但出借人因借款人违约遭受了损失（如借款利息损失、追款产生的合理费用等），出借人可主张借款人赔偿实际损失，但需提供相关证据证明。
法定利率限制
- 四倍LPR上限：在民间借贷中，若出借人与借款人同时约定了逾期利率、违约金或其他费用，出借人可选择主张其中一项或多项，但总计不得超过合同成立时一年期贷款市场报价利率（LPR）的四倍。例如，若合同成立时一年期LPR为3.85%，则四倍为15.4%，超出部分法院不予支持。
- 计算公式：
$\( \text{合法违约金上限} = \text{借款本金} \times \text{合同成立时一年期LPR} \times 4 \)$
司法实践中的考量因素
- 综合判断：法院或仲裁机构在判断违约金是否过高时，会综合考虑实际损失大小、合同履行情况、当事人过错程度及预期利益等因素。例如，若借款人已部分履行合同义务，或出借人存在过错，法院可能酌情调整违约金数额。
建议与注意事项：
- 合理约定违约金：在签订借款合同时，双方应谨慎约定违约金条款，确保其既不过高也不过低，以维护合同的公平性和有效性。
- 保留证据：若发生违约行为，受损方应及时收集并保留相关证据（如合同、转账记录、沟通记录等），以便在诉讼或仲裁中证明自己的损失和违约金的合理性。
- 依法处理争议：若对违约金的合法性存在疑问或争议较大，可直接向我咨询，我会结合具体案情提供专业法律意见。
总结：借款违约金的合法范围受合同约定、实际损失及法定利率限制三重约束。在签订合同时，双方应明确约定违约金条款；在发生违约时，应依法处理争议，确保自身合法权益得到妥善保护。