合同定金的数额应由当事人约定，但不得超过主合同标的额的百分之二十，超过部分不产生定金效力。以下是对这一问题的详细分析：

1. 定金数额的约定性：

   • 定金的具体数额是由双方当事人在合同中自行协商并约定的。这一约定体现了合同的自由原则，允许双方根据交易的具体情况和需求来确定定金的金额。

2. 定金数额的法定上限：

   • 根据《中华人民共和国民法典》第五百八十六条的规定，定金的数额不得超过主合同标的额的百分之二十。这是法律对定金数额的强制性限制，旨在保护交易双方的合法权益，防止一方利用定金制度对另一方造成不公平的负担。
   • 计算公式：\(定金上限 = 主合同标的额 \times 20\%\)
   • 示例：如果主合同标的额为100万元，那么定金最多只能是20万元。若约定的定金超过20万元，超出部分将不具有定金的法律效力，即不能适用定金罚则（如罚没或双倍返还）。

3. 实际交付定金与约定不一致的处理：

   • 在实际操作中，可能会出现实际交付的定金数额与原先约定的不一致的情况。对此，法律明确规定，实际交付的定金数额多于或者少于约定数额的，视为变更约定的定金数额。这意味着，双方应以实际交付的定金为准，并据此承担相应的法律责任。

4. 定金合同的成立与书面形式要求：

   • 定金合同是自实际交付定金时成立的实践合同。这意味着，仅仅在合同中约定定金是不够的，必须有一方实际交付了定金，合同才具有法律约束力。
   • 为了避免因约定不明确而产生纠纷，建议定金应当以书面形式进行约定。在书面协议中，应详细注明定金的数额、交付时间、违约条款等关键内容，以确保双方的权利和义务清晰明了。

5. 法律建议与风险提示：

   • 在签订涉及定金的合同时，建议双方仔细审查合同条款，特别是关于定金数额、支付方式、违约责任等方面的约定。确保定金数额不超过法定上限，并以书面形式明确记载于合同中，以有效避免潜在的法律风险。
   • 如果给付定金的一方不履行债务或者履行债务不符合约定，那么该方无权请求返还定金；相反，如果收受定金的一方不履行债务或者履行债务不符合约定，则应当向对方双倍返还定金。这一规定旨在保护交易双方的合法权益，确保合同的顺利履行。

在实际操作中，如果遇到定金纠纷或其他相关法律问题，可以直接向我咨询，我会根据你的具体情况提供针对性的法律帮助和解决方案。