借款违约金的合法性主要受到《中华人民共和国民法典》第五百八十五条及相关司法解释的约束。根据这些规定，借款违约金的合法范围如下：

违约金上限：

违约金的数额一般不得超过实际损失的30%。如果约定的违约金过分高于造成的损失，当事人可以请求人民法院或者仲裁机构予以适当减少。

计算方式：

违约金可以以事先确定的具体数额形式约定，也可以以逾期利息的形式出现。如果合同中只对违约金做了原则性规定，没有具体约定违约金的比例或数额，则可按《中华人民共和国民法典》中关于承担违约金责任的一般原则执行。

民间借贷的特殊规定：

在民间借贷纠纷中，如果出借人与借款人既约定了逾期利率，又约定了违约金或其他费用，出借人可以选择主张逾期利息、违约金或其他费用，但总计不得超过合同成立时一年期LPR的四倍。超出此利率部分的利息，借款人可以不用支付。

法院的裁量权：

法院在支持违约金时，会根据具体情况对违约金的数额进行调整。如果违约金超过造成损失的30%，法院一般可以认定为“过分高于造成的损失”，并可以适当减少违约金。

综上所述，借款违约金的合法性主要取决于双方当事人的约定，但有一个上限，即不得超过实际损失的30%。如果违约金过高，法院有权根据实际损失情况进行适当调整。此外，在民间借贷中，还需注意违约金与其他费用的总计不得超过一年期LPR的四倍。