合同约定定金返还是否合法，主要取决于合同的具体约定以及违约情况，需依据《中华人民共和国民法典》的相关规定来判断。以下是对这一问题的详细分析：
一、定金的基本法律特征与合同约定
定金作为一种常见的担保方式，具有双重担保性、从属性、实践性和预先支付性等法律特征。在合同中约定定金，通常是为了确保合同的履行，作为合同履行的一种保证。因此，合同中关于定金返还的约定，应当遵循定金的基本法律特征，并符合《民法典》的相关规定。
二、定金返还合法的情形
合同正常履行：如果合同双方均按照约定履行了合同义务，那么定金应当抵作价款或者收回。在这种情况下，定金返还的约定是合法的，也是合同正常履行的结果。
收受定金方违约：根据《民法典》第五百八十七条，如果收受定金的一方不履行债务或者履行债务不符合约定，致使不能实现合同目的的，应当双倍返还定金。这意味着，如果合同中约定了定金返还，且收受定金方违约，那么定金返还的约定是合法的，且收受定金方还需额外支付等额的赔偿金。
不可抗力等不可归责于双方的原因：如果合同无法履行是由于不可抗力、意外事件等不可归责于双方当事人的原因导致的，那么根据公平原则，收受定金的一方应当将定金返还给给付定金的一方。在这种情况下，定金返还的约定也是合法的。
三、定金返还不合法的情形
给付定金方违约：如果给付定金的一方不履行债务或者履行债务不符合约定，致使不能实现合同目的的，根据《民法典》第五百八十七条，该方无权请求返还定金。这意味着，如果合同中约定了定金返还，但给付定金方违约，那么定金返还的约定在违约方身上是不合法的，收受定金方有权不退还定金。
定金合同不成立或无效：如果定金合同不具备成立要件，如未采用书面形式约定定金条款，或者存在欺诈、胁迫等导致合同无效的情形，那么定金返还的约定也是不合法的。在这种情况下，收受定金的一方应退还定金，但可能不涉及双倍返还的问题。
四、实际操作建议
明确约定定金条款：在签订合同时，双方应明确约定定金的性质、数额、支付方式及违约责任等条款。这有助于避免定金纠纷，确保双方权益得到保障。
了解定金法律特征：双方应充分了解定金的法律特征和退还规则，以便在合同履行过程中能够正确行使权利和履行义务。
及时咨询专业律师：如果在合同履行过程中遇到定金纠纷，双方应及时咨询专业律师，以便根据具体情况制定合适的解决方案。
举例说明：假设甲向乙支付定金购买房屋，并约定如果甲违约则定金不退。后来，甲因自身原因放弃购买房屋，此时乙有权不退还定金，因为甲作为给付定金方违约了。但如果乙在收取定金后，因自身原因无法履行合同，那么乙不仅需要退还定金，还需额外支付等额的赔偿金给甲。
综上所述，合同约定定金返还是否合法，取决于合同的具体约定以及违约情况。在实际操作中，双方应严格遵守合同约定和法律法规，以维护合同的严肃性和有效性。如果您在合同纠纷方面有任何疑问或需要进一步的法律帮助，请随时向我咨询。