还款协议中违约金的合法性主要取决于其是否超过了法律规定的上限，以及是否由双方自愿、平等协商确定。一般来说，只要违约金数额合理且不超过法定上限，就是合法的。以下从几个方面进行详细分析：

1. 违约金的约定原则：

   • 违约金是双方当事人在合同中约定的，当一方违约时，应向对方支付的一定数额的金钱。其目的在于补偿因违约造成的损失，并具有一定的惩罚性。
   • 违约金的约定应当遵循自愿、平等、公平、诚实信用的原则，不得违反法律、行政法规的强制性规定。

2. 违约金的合法上限：

   • 根据《中华人民共和国民法典》的相关规定，如果约定的违约金过分高于造成的损失的，人民法院或者仲裁机构可以根据当事人的请求予以适当减少。这里的“过分高于”通常指的是违约金数额超过实际损失的30%以上。
   • 具体来说，如果双方约定的违约金超过了实际损失的30%，那么违约方可以请求法院或仲裁机构减少违约金数额。法院或仲裁机构在裁决时，会综合考虑合同的履行情况、当事人的过错程度以及预期利益等因素，来确定最终的违约金数额。

3. 违约金的计算方式：

   • 双方可以在还款协议中明确约定违约金的具体数额，也可以约定一定的比例（如按日计算违约金）。
   • 如果约定的是比例，那么违约金的数额将根据违约的天数和约定的比例来计算。例如，如果约定每日违约金为未还款金额的0.05%，那么违约一天的违约金就是未还款金额乘以0.05%。
   • 计算公式示例：假设未还款金额为100,000元，约定每日违约金为0.05%，违约天数为10天，则违约金数额为：100,000元 × 0.05% × 10天 = 500元。

4. 实际案例与法律建议：

   • 在实际案例中，法院或仲裁机构会根据双方提供的证据和合同约定，来判断违约金是否合法以及是否需要调整。
   • 建议：在签订还款协议时，双方应充分协商并明确约定违约金的数额或比例，同时确保该约定不违反法律、行政法规的强制性规定。如果发生违约情况，违约方应主动承担违约责任，守约方也有权依法要求违约方支付违约金。

5. 特殊情况下的处理：

   • 如果还款协议中未约定违约金，但违约行为确实给守约方造成了损失，守约方仍然有权要求违约方赔偿损失。此时的赔偿范围将根据实际损失来确定，并可能包括直接损失和间接损失。
   • 如果双方对违约金的数额或比例存在争议，且无法通过协商解决，那么可以寻求法律途径解决争议，如向法院提起诉讼或向仲裁机构申请仲裁。

总结来说，还款协议中违约金的合法性主要取决于其是否超过了法律规定的上限以及是否由双方自愿、平等协商确定。在签订还款协议时，双方应充分协商并明确约定违约金的数额或比例，以确保合同的合法性和有效性。如果发生违约情况或双方对违约金存在争议，建议及时咨询专业律师以获取更具体的法律建议。