Skip to main content

Order-level totals, derived from line items. All fields are positive integers in minor currency units. net_payable is the only field that can be negative (on refunds).

Derivation: subtotal_gross − total_line_discounts = subtotal_after_line_discounts subtotal_after_line_discounts − total_cart_discounts = subtotal_after_all_discounts subtotal_after_all_discounts + rounding_adjustment = total_gross total_gross → total_net + total_tax

subtotal_gross
integer

Sum of all line item subtotal_gross values before any discounts

total_line_discounts
integer

Sum of all line-level discount amounts across all line items

subtotal_after_line_discounts
integer

subtotal_gross − total_line_discounts

total_cart_discounts
integer

Sum of all cart-level discount total_amounts

subtotal_after_all_discounts
integer

subtotal_after_line_discounts − total_cart_discounts

rounding_adjustment
integer

Cash rounding adjustment in minor currency units. Applied after discounts. Required in Austria and some Italian scenarios. Can be negative (round down) or positive (round up).

total_gross
integer

subtotal_after_all_discounts + rounding_adjustment. The total amount charged to the customer.

total_net
integer

total_gross excluding tax

total_tax
integer

Total tax amount across all line items

tax_breakdown
object[]
net_payable
integer

The net amount the customer owes (positive) or is owed (negative). Positive on a sale, negative on a refund.

Change is not represented here — it is modelled as a separate outbound cash payment line, making the full settlement picture explicit. This field reflects the value exchanged, not how it was settled.