借款还款违约金的合法范围主要受到合同约定、实际损失以及法定利率上限的限制，具体来说，违约金数额一般不得超过合同成立时一年期贷款市场报价利率（LPR）的四倍，且通常不应超过实际损失的30%。以下是对这一问题的详细分析：
一、合同约定与实际损失
有约定的情况：
- 如果借贷双方在借款合同中对违约金有明确约定，且该约定合理反映了违约行为可能造成的损失，既不过高也不过低，那么该约定通常会被认定为合法有效。
- 一般来说，如果约定的违约金未超过实际损失的30%，法院往往会予以支持。例如，若违约造成出借人10万元损失，则约定的违约金在不超过13万元的情况下，一般会得到法院支持。
未约定的情况：
- 若双方未约定违约金，但出借人因借款人违约遭受了损失，出借人可以主张违约方赔偿实际损失。这包括借款利息损失、追款产生的合理费用等，但需要有相关证据证明。
二、法定利率限制
- 在民间借贷中，出借人与借款人既约定了逾期利率，又约定了违约金或其他费用时，出借人可以选择主张逾期利息、违约金或其他费用，也可以一并主张。但总计不得超过合同成立时一年期贷款市场报价利率（LPR）的四倍。
- 例如，若合同成立时一年期贷款市场报价利率为3.85%，则四倍为15.4%。超出此比例的部分，法院将不予支持。
三、司法实践中的考量
- 法院或仲裁机构在判断违约金是否过高时，会综合考虑多种因素，如实际损失的大小、合同的履行情况、当事人的过错程度以及预期利益等。
- 如果借款人已经部分履行合同义务，或者出借人也存在一定的过错，那么法院可能会酌情调整违约金的数额。
四、法律建议
合理约定违约金：
- 在签订借款合同时，双方应合理约定违约金条款，确保其符合相关法律法规的规定。违约金数额应既能起到约束作用，又不会过分高于实际损失。
保留相关证据：
- 一旦发生违约行为，受损方应及时收集并保留相关证据，如借款合同、转账记录、沟通记录等，以便在诉讼或仲裁中证明自己的损失和违约金的合理性。
寻求专业帮助：
- 如果对违约金的合法性存在疑问或争议较大，建议直接向我咨询，以获取更准确的法律意见和帮助。
综上所述，借款还款违约金的合法范围受到多方面因素的限制。在签订借款合同时，双方应仔细审查合同条款，确保违约金的约定合法合规。同时，在发生违约情况时，双方应依法处理争议，维护自身合法权益。