关于借款违约金的合法数额，这确实是一个涉及合同约定、实际损失以及法定利率限制等多个方面的复杂问题。以下是我为您详细梳理的解答：

一、合法性的基本原则

借款违约金的合法性判定，主要基于合同约定、实际损失以及不超过法定利率上限的原则。这意味着，违约金的数额并非随意设定，而是需要受到法律和合同条款的双重约束。

二、合同约定与实际损失

1. 有约定的情况：

   • 如果借贷双方在借款合同中明确约定了违约金，且该约定不超过因违约造成的实际损失的30%，那么这样的违约金通常会被认定为合法有效。例如，若违约造成出借人10万元损失，约定的违约金在不超过13万元的情况下，一般会得到法院的支持。

2. 未约定的情况：

   • 若双方未约定违约金，但出借人因借款人违约遭受了损失，出借人可以主张违约方赔偿实际损失。这包括借款利息损失、追款产生的合理费用等，但需要有相关证据来证明这些损失。

三、法定利率限制

• 在民间借贷中，如果出借人与借款人既约定了逾期利率，又约定了违约金或其他费用，出借人可以选择主张逾期利息、违约金或其他费用，也可以一并主张。但总计不得超过合同成立时一年期贷款市场报价利率的四倍。例如，若合同成立时一年期贷款市场报价利率为3.85%，则四倍为15.4%，超出此比例的部分，法院将不予支持。

四、司法实践中的考量

• 法院或仲裁机构在判断违约金是否过高时，会综合考虑多种因素，如实际损失的大小、合同的履行情况、当事人的过错程度以及预期利益等。这体现了法律对公平原则的遵循和对当事人合法权益的保护。

五、法律条款的引用

• 根据《中华人民共和国民法典》的相关规定，当事人可以约定一方违约时应当根据违约情况向对方支付一定数额的违约金。如果约定的违约金低于造成的损失，当事人可以请求人民法院或者仲裁机构予以增加；如果约定的违约金过分高于造成的损失，当事人可以请求人民法院或者仲裁机构予以适当减少。

六、总结与建议

• 借款违约金的合法范围受到多方面因素的限制。在签订借款合同时，双方应合理约定违约金条款，确保其符合相关法律法规的规定。
• 如果发生违约情况，双方应依法处理争议，维护自身合法权益。建议在实际操作中寻求专业法律人士的帮助，以确保合同条款的合法性和有效性。

综上所述，借款违约金的合法数额并非一个固定的数字，而是需要根据合同约定、实际损失以及法定利率限制等多个因素来综合判断。希望这个解答能够帮助您更好地理解借款违约金的合法性问题。