Precise Amount Support & Enhanced Payment–Order Linking
Release
Author:
Yulia Andreyanova
Changed on:
17 Mar 2026
| Target release date: | 2026-03-16 |
|---|---|
| Release status: | Released |
Description
This release enhances the Payments model by introducing high-precision monetary support and extending how Payments can be associated with Orders.Monetary values can now be stored with greater precision, enabling more accurate handling of decimal amounts and reducing rounding discrepancies in financial integrations, reporting, and reconciliation processes. Payments may also be optionally linked directly to a specific Order, providing clearer traceability across different billing scenarios.Support for consolidated billing remains unchanged, allowing a single Payment to apply across multiple Orders. All changes are backward-compatible and do not affect existing workflows.Changelog
- Enabled precise monetary handling across core commerce entities (e.g. Orders, Payments, Returns, etc.)
- Added nullable
`NUMERIC`-based precise amount fields alongside existing monetary values, preserving legacy amount fields - Standardized currency column definitions by extending existing fields to
`VARCHAR(255)` - Implemented reusable
`PreciseAmountType`using`BigDecimal`scalar support - Extended the GraphQL schema to expose precise amount fields in existing queries and mutations
- Added an optional
`orderId`reference to`Payment` - Updated
`PaymentTransaction.cardType`to`String`in the Java domain model to align with the GraphQL schema and allow custom values. The field length was also increased to`VARCHAR(255)`.
| Released capability depth: | Enhancement |
|---|---|
| Release bundle / Capability type: | Platform |
