# Order: difference of net\_amount\_due\_money and total\_money fields **URL:** \ **Category:** Questions\ **Tags:** orders-api\ **Created:** [May 11, 2024, 7:47pm UTC](https://developer.squareup.com/forums/t/order-difference-of-net-amount-due-money-and-total-money-fields/15695 "2024-05-11T19:47:37Z")\ **Posts on this page:** 4\ **Page:** 1
**Author:** ![DevelopingForFun](https://avatars.discourse-cdn.com/v4/letter/d/4bbf92/32.png) [@DevelopingForFun](https://developer.squareup.com/forums/u/DevelopingForFun)\ **Post date:** [May 11, 2024, 7:47pm UTC](https://developer.squareup.com/forums/t/order-difference-of-net-amount-due-money-and-total-money-fields/15695/1 "2024-05-11T19:47:37Z")
Reading [Order Object - Square API Reference](https://developer.squareup.com/reference/square/objects/Order), can you please add updated documentation or this page to explain how these are different? Or link to a guide which does? ```auto total_money Read only The total amount of money to collect for the order ``` ```auto net_amount_due_money Read only The net amount of money due on the order. ``` I could imagine one gross and one net, and the difference is discounts. But “money to collect” sure sounds like it would be after discounts. Please help us understand when this differs, thanks! There is also `net_amounts` (an object) which is clear. It applies after refunds. ```auto net_amounts Read only The net money amounts (sale money - return money). ``` I could also imagine e.g. if a payment has been applied but money is still owed, then they might differ. This guide [Orders API: How It Works](https://developer.squareup.com/docs/orders-api/how-it-works) could have a sentence added here to explain it: > In the response, the `gross_sales_money` elements reflect the item totals, while `net_amount_due_money` reflects the subtotal for the order ($116.00). **[INSERT HERE: The `total_money` matches the net amount because [reason] although other times [it would not because].]** EDIT: looking at some other example orders I see one (it was a refund exchange order created in app) with a total\_money of \>0 and net\_amount\_due\_money = 0. That is a case when they differ. Maybe when the order is paid in full net\_amount\_due\_money will change to 0? **Whatever the case it really could be documented on the API reference, please.** Any guarantees about mutability vs immutability and how it may change based on the state of the order would be helpful in the docs too. ---
**Author:** ![Square-Dev-AI](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/square-dev-ai/32/2513_2.png) [@Square-Dev-AI](https://developer.squareup.com/forums/u/Square-Dev-AI)\ **Post date:** [May 11, 2024, 7:47pm UTC](https://developer.squareup.com/forums/t/order-difference-of-net-amount-due-money-and-total-money-fields/15695/2 "2024-05-11T19:47:54Z")
👋 I’m Square Dev AI, here to help answer your question! Based on the information you’ve provided, the following documentation will help answer your question: > **[Working with Monetary Amounts in Square APIs](https://developer.squareup.com/docs/build-basics/common-data-types/working-with-monetary-amounts)** > > Learn how the Square API model works with monetary amounts. > **[Working with Monetary Amounts in Square APIs](https://developer.squareup.com/docs/build-basics/working-with-monetary-amounts)** > > Learn how the Square API model works with monetary amounts. > **Additional Documentation** > > [Orders API: How It Works](https://developer.squareup.com/docs/orders-api/how-it-works) > [Orders API Overview](https://developer.squareup.com/docs/orders-api/what-it-does) > [Common Data Types](https://developer.squareup.com/docs/build-basics/common-data-types) If this documentation helped you find a solution, please check the box indicating that this reply solves the problem. Otherwise one of our Developer Advocates will provide additional assistance shortly. ---
**Author:** ![Square-Dev-AI](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/square-dev-ai/32/2513_2.png) [@Square-Dev-AI](https://developer.squareup.com/forums/u/Square-Dev-AI)\ **Post date:** [May 13, 2024, 5:23pm UTC](https://developer.squareup.com/forums/t/order-difference-of-net-amount-due-money-and-total-money-fields/15695/3 "2024-05-13T17:23:45Z")
The `total_money` field in the Order object represents the total amount of money calculated for all items, taxes, discounts, and service charges in the order. This is the gross amount before any payments or refunds are applied. On the other hand, `net_amount_due_money` represents the net amount that is due for the order. This is the amount that still needs to be collected after any payments or refunds have been applied to the order. In other words, `total_money` is the total cost of the order, while `net_amount_due_money` is the remaining balance that needs to be paid. If no payments or refunds have been applied, these two values would be the same. However, if a payment has been made or a refund has been issued, `net_amount_due_money` would be less than `total_money`. _This answer was reviewed by @Bryan-Square._ ---
**Author:** ![DevelopingForFun](https://avatars.discourse-cdn.com/v4/letter/d/4bbf92/32.png) [@DevelopingForFun](https://developer.squareup.com/forums/u/DevelopingForFun)\ **Post date:** [May 14, 2024, 6:10pm UTC](https://developer.squareup.com/forums/t/order-difference-of-net-amount-due-money-and-total-money-fields/15695/4 "2024-05-14T18:10:29Z")
Thank you, can this _please_ be added to the documentation under each type? The existing content is so very brief, this actually is really helpful. Thanks!