@gojinko/api-client 2.24.0 → 2.25.0

package/public-api.yaml

@@ -1,10 +1,10 @@
-# synced from jinko-api@cbb5c94917a182f5d2e50a6148e881ed1f0ccef8 (main, #97 squash-merged)
+# synced from jinko-api@c46664fb52f2597644c841a14abe5a1eb80cee21 (c46664fb)
 # Vendored copy of the canonical public contract. Do not hand-edit: change it in
-# jinko-api, regenerate there, copy the file here, then `pnpm generate:api-types`.
+# jinko-api, then `pnpm sync:api-spec <ref>` here, which also runs `pnpm generate:api-types`.
 openapi: 3.0.0
 info:
   title: Jinko Public API
-  version: 0.8.0
+  version: 0.10.0
   description: >-
     Curated public REST surface for Jinko. Authenticated with jnk_ API keys. See
     https://docs.gojinko.com for guides.
@@ -207,6 +207,16 @@ components:
             on a value-shaped object, fall back to the ISO digits for the
             currency."
           example: 2
+        display:
+          type: string
+          description: 'The same figure as a string ready to show: the ISO 4217 code, a
+            space, then the amount, e.g. "USD 159.77". With decimal_places it is
+            written at exactly that scale (value 1561500, JPY, decimal_places 2
+            is "JPY 15615.00"); without, at the ISO digits of the currency. Show
+            this; compute with the number. Absent when the figure is not money
+            (a cancellation step expressed as a percent or a number of nights)
+            or could not be read unambiguously.'
+          example: USD 412.50
       required:
         - value
         - currency
@@ -313,6 +323,7 @@ components:
                 - FORBIDDEN
                 - NOT_FOUND
                 - CONFLICT
+                - GONE
                 - QUOTE_EXPIRED
                 - TRIP_EXPIRED
                 - TRIP_STATE_CONFLICT
@@ -854,6 +865,22 @@ components:
             on a value-shaped object, fall back to the ISO digits for the
             currency."
           example: 2
+        display:
+          type: string
+          description: 'The same figure as a string ready to show: the ISO 4217 code, a
+            space, then the amount, e.g. "USD 159.77". With decimal_places it is
+            written at exactly that scale (value 1561500, JPY, decimal_places 2
+            is "JPY 15615.00"); without, at the ISO digits of the currency. Show
+            this; compute with the number. Absent when the figure is not money
+            (a cancellation step expressed as a percent or a number of nights)
+            or could not be read unambiguously.'
+          example: USD 412.50
+      description: "A money figure in one of two scales, told apart by one rule. When
+        `decimal_places` is present, `value` (or `amount`) is an INTEGER in
+        minor units: divide by 10 ** decimal_places. When it is absent, `amount`
+        is already in MAJOR units. Branch on whether decimal_places is present
+        in the response you received, never on the currency code or the field
+        name. `display` is the same figure as a string to show."
     CheckedBaggage:
       type: object
       properties:
@@ -1364,6 +1391,16 @@ components:
             on a value-shaped object, fall back to the ISO digits for the
             currency."
           example: 2
+        display:
+          type: string
+          description: 'The same figure as a string ready to show: the ISO 4217 code, a
+            space, then the amount, e.g. "USD 159.77". With decimal_places it is
+            written at exactly that scale (value 1561500, JPY, decimal_places 2
+            is "JPY 15615.00"); without, at the ISO digits of the currency. Show
+            this; compute with the number. Absent when the figure is not money
+            (a cancellation step expressed as a percent or a number of nights)
+            or could not be read unambiguously.'
+          example: USD 412.50
     MonitoredCarrier:
       type: object
       properties:
@@ -1542,39 +1579,7 @@ components:
         description:
           type: string
         price_per_unit:
-          type: object
-          properties:
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+          $ref: "#/components/schemas/Money"
         per_pax:
           type: boolean
           description: True when the price is charged per passenger rather than once per
@@ -1616,111 +1621,19 @@ components:
       type: object
       properties:
         original:
-          type: object
-          properties:
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: The selling price shown at search time, before the quote.
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: The selling price shown at search time, before the quote.
         current:
-          type: object
-          properties:
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: The selling price the trip is quoted at — the same figure as `price`.
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: The selling price the trip is quoted at — the same figure as
+                `price`.
         delta:
-          type: object
-          properties:
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: "`current` minus `original`, SIGNED: positive when the price rose,
-            negative when it fell."
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: "`current` minus `original`, SIGNED: positive when the price rose,
+                negative when it fell."
       required:
         - original
         - current
@@ -1751,6 +1664,16 @@ components:
             the guest pays it at the property on top. Getting this backwards
             misquotes the trip.
           example: true
+        display:
+          type: string
+          description: 'The same figure as a string ready to show: the ISO 4217 code, a
+            space, then the amount, e.g. "USD 159.77". With decimal_places it is
+            written at exactly that scale (value 1561500, JPY, decimal_places 2
+            is "JPY 15615.00"); without, at the ISO digits of the currency. Show
+            this; compute with the number. Absent when the figure is not money
+            (a cancellation step expressed as a percent or a number of nights)
+            or could not be read unambiguously.'
+          example: EUR 164.49
     CancellationStep:
       type: object
       properties:
@@ -1774,6 +1697,16 @@ components:
           type: string
           description: How the charge is expressed — "amount", "percent" or "nights".
           example: amount
+        display:
+          type: string
+          description: 'The same figure as a string ready to show: the ISO 4217 code, a
+            space, then the amount, e.g. "USD 159.77". With decimal_places it is
+            written at exactly that scale (value 1561500, JPY, decimal_places 2
+            is "JPY 15615.00"); without, at the ISO digits of the currency. Show
+            this; compute with the number. Absent when the figure is not money
+            (a cancellation step expressed as a percent or a number of nights)
+            or could not be read unambiguously.'
+          example: EUR 606.13
     HotelTerms:
       type: object
       properties:
@@ -1873,42 +1806,18 @@ components:
             came from. Hotel items only.
           example: lp1f2c3
         price:
-          type: object
-          properties:
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: Item total in major currency units. Absent until the trip has been
-            quoted — an unpriced item carries no `price` key at all, so absence
-            means "not priced yet", not "free".
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: Item total in major currency units. Absent until the trip has been
+                quoted — an unpriced item carries no `price` key at all, so
+                absence means "not priced yet", not "free".
+        price_display:
+          type: string
+          description: The item price as a string ready to show, e.g. "EUR 545.55". Sent
+            beside a `price` that arrives as a bare major-units number with
+            `currency` (the trip create response); a `price` object carries its
+            own `display` instead.
+          example: EUR 545.55
         pax_count:
           type: number
           example: 1
@@ -1931,42 +1840,11 @@ components:
             two figures and the signed difference. Absent when the price held.
           example: true
         original_price:
-          type: object
-          properties:
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: The snapshot price recorded at search time. Present only when
-            `price_changed` is true; compare it against `price` to show the
-            caller what moved.
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: The snapshot price recorded at search time. Present only when
+                `price_changed` is true; compare it against `price` to show the
+                caller what moved.
         price_change:
           $ref: "#/components/schemas/PriceChange"
         required_attributes:
@@ -2101,6 +1979,11 @@ components:
               type: string
             total:
               type: number
+            total_display:
+              type: string
+              description: The trip total as a string ready to show, e.g. "USD 318.40". Absent
+                with `total`.
+              example: USD 318.40
           example:
             currency: USD
             total: 318.4
@@ -2358,39 +2241,7 @@ components:
           items:
             $ref: "#/components/schemas/TripItem"
         total_amount:
-          type: object
-          properties:
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+          $ref: "#/components/schemas/Money"
         quote:
           type: object
           properties:
@@ -2475,39 +2326,7 @@ components:
           items:
             $ref: "#/components/schemas/SelectedAncillary"
         total_with_ancillaries:
-          type: object
-          properties:
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+          $ref: "#/components/schemas/Money"
     AncillaryRequest:
       type: object
       properties:
@@ -2606,15 +2425,19 @@ components:
           example: ready
         expires_at:
           type: string
-          description: "When the locked quote behind this checkout expires (RFC 3339).
-            Roughly five minutes from the call — pay before it passes. This is
-            NOT the lifetime of `checkout_url`, which the platform keeps
-            openable for longer. After this instant the platform REFUSES to take
-            payment rather than charging a stale price: `POST
-            /v1/agent_payment/submit` answers **410 `QUOTE_EXPIRED`** and no
-            payment object is created. To recover, call `POST /v1/checkout`
-            again on the same trip — it re-quotes — and pay against the new
-            `expires_at`. The hosted page offers the same refresh in one click."
+          description: "When the quote behind this checkout stops being payable (RFC
+            3339). Roughly fifteen minutes from the call — pay before it passes.
+            It is NOT a price hold: the supplier guarantees neither the price
+            nor availability for the window, so an offer can lapse inside it.
+            Nor is it the lifetime of `checkout_url`, which stays openable
+            longer. After this instant the platform REFUSES to take payment
+            rather than charging a stale price: `POST /v1/agent_payment/submit`
+            answers **410 `QUOTE_EXPIRED`** and no payment object is created. To
+            recover, call `POST /v1/checkout` again on the same trip — it
+            re-quotes at the current price — and pay against the new
+            `expires_at`. The hosted page cannot recover on its own: past this
+            instant it shows the price as expired and the customer has to be
+            sent a fresh checkout."
           example: "2026-06-01T12:39:56Z"
         payment_type:
           type: string
@@ -2630,39 +2453,7 @@ components:
             you."
           example: checkout
         total_amount:
-          type: object
-          properties:
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+          $ref: "#/components/schemas/Money"
         items:
           type: array
           items:
@@ -2725,6 +2516,12 @@ components:
           type: string
           description: The instant the refused quote expired (RFC 3339).
           example: "2026-09-04T12:39:56Z"
+        quoted_cart_id:
+          type: number
+          description: The quote that lapsed — the same `quoted_cart_id` the trip and
+            checkout responses carry, so a caller holding several can tell which
+            one this refusal is about.
+          example: 2097152
       required:
         - error
     AgentPaymentSubmitRequest:
@@ -2759,6 +2556,12 @@ components:
           description: Price for the whole stay in `currency`, at the currency’s own
             precision.
           example: 1818.4
+        total_amount_display:
+          type: string
+          description: 'The rate total as a string ready to show: the ISO 4217 code, a
+            space, then `total_amount` at the currency’s ISO digits, e.g. "EUR
+            606.13". Show this; compute with `total_amount`.'
+          example: EUR 606.13
         currency:
           type: string
           example: EUR
@@ -3207,6 +3010,15 @@ components:
           type: string
         decimal_places:
           type: integer
+        display:
+          type: string
+          description: 'The same figure as a string ready to show: the ISO 4217 code, a
+            space, then the amount, e.g. "USD 159.77". With decimal_places it is
+            written at exactly that scale (value 1561500, JPY, decimal_places 2
+            is "JPY 15615.00"); without, at the ISO digits of the currency. Show
+            this; compute with the number. Absent when the figure is not money
+            (a cancellation step expressed as a percent or a number of nights)
+            or could not be read unambiguously.'
       required:
         - value
         - currency
@@ -3528,6 +3340,16 @@ components:
             on a value-shaped object, fall back to the ISO digits for the
             currency."
           example: 2
+        display:
+          type: string
+          description: 'The same figure as a string ready to show: the ISO 4217 code, a
+            space, then the amount, e.g. "USD 159.77". With decimal_places it is
+            written at exactly that scale (value 1561500, JPY, decimal_places 2
+            is "JPY 15615.00"); without, at the ISO digits of the currency. Show
+            this; compute with the number. Absent when the figure is not money
+            (a cancellation step expressed as a percent or a number of nights)
+            or could not be read unambiguously.'
+          example: EUR 412.50
       description: The only amount Jinko charges at checkout.
     CarOfferPrice:
       type: object
@@ -4446,6 +4268,50 @@ components:
         `UNSUPPORTED` — the provider or fare does not allow it at all; nothing
         you send will change that. Do not treat MANUAL_REQUIRED as a failure,
         and do not retry UNSUPPORTED.
+    BookingCalendarFile:
+      type: object
+      properties:
+        method:
+          type: string
+          description: "The iTIP method (RFC 5546) this file carries: `REQUEST` for the
+            events the booking still holds, `CANCEL` for the ones it no longer
+            does. One file carries exactly one method — a booking that both
+            retires and confirms flights, which is what an exchange does, comes
+            back as two files rather than one mixed one."
+          example: REQUEST
+        filename:
+          type: string
+          description: The name the confirmation or cancellation email attached this same
+            file under.
+          example: jinko-JNK-A0AUR2.ics
+        content_type:
+          type: string
+          description: "The media type, including the `method` parameter. Attach or serve
+            the file under this exact value: the method parameter is what makes
+            a mail client act on the file instead of storing it as a plain
+            attachment."
+          example: text/calendar; charset=utf-8; method=REQUEST
+        content:
+          type: string
+          description: The iCalendar file itself. Real CRLF line endings, as iCalendar
+            requires — the example escapes them only so it can be read here.
+            Byte-identical to what the email carried for the current state of
+            this booking.
+          example: BEGIN:VCALENDAR\r\nVERSION:2.0\r\n…\r\nEND:VCALENDAR\r\n
+    BookingCalendar:
+      type: object
+      properties:
+        files:
+          type: array
+          items:
+            $ref: "#/components/schemas/BookingCalendarFile"
+          description: "The iCalendar files this booking is carried in, cancellation first
+            and then invitation — the order the emails attach them in. Never
+            empty: a booking with nothing to put in a calendar omits `calendar`
+            altogether."
+      description: The calendar entries for this booking, as iCalendar files. Absent —
+        not null, and never an empty list — when the booking holds no flight and
+        no hotel, and whenever the files could not be built.
     Booking:
       type: object
       properties:
@@ -4466,39 +4332,7 @@ components:
           type: string
           example: Carrard
         total_paid:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+          $ref: "#/components/schemas/Money"
         refund_support_level:
           $ref: "#/components/schemas/SupportLevel"
         exchange_support_level:
@@ -4506,6 +4340,8 @@ components:
         created_at:
           type: string
           example: "2026-05-20T09:14:00Z"
+        calendar:
+          $ref: "#/components/schemas/BookingCalendar"
       description: "The booked trip. Minimally described — the platform sends more
         (items, per-item confirmations, provider state) and all of it reaches
         you. The two `*_support_level` fields are a SNAPSHOT: a fare’s void
@@ -4528,6 +4364,12 @@ components:
             currency: USD
             decimal_places: 2
           created_at: "2026-05-20T09:14:00Z"
+          calendar:
+            files:
+              - method: REQUEST
+                filename: jinko-JNK-A0AUR2.ics
+                content_type: text/calendar; charset=utf-8; method=REQUEST
+                content: BEGIN:VCALENDAR\r\nVERSION:2.0\r\n…\r\nEND:VCALENDAR\r\n
     GetBookingRequest:
       type: object
       properties:
@@ -4568,112 +4410,17 @@ components:
             MANUAL_REQUIRED`."
           example: fare rules require agent review
         refund_amount:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: "What would be refunded. **Absent is not zero** — on a voidable
-            ticket (`is_voidable: true`) the whole charge is reversed and no
-            amount is quoted, and on an unsupported refund nothing is computed
-            at all. Read `is_refundable` and `is_voidable` before showing a
-            figure."
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: "What would be refunded. **Absent is not zero** — on a voidable
+                ticket (`is_voidable: true`) the whole charge is reversed and no
+                amount is quoted, and on an unsupported refund nothing is
+                computed at all. Read `is_refundable` and `is_voidable` before
+                showing a figure."
         penalty_amount:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+          $ref: "#/components/schemas/Money"
         total_paid:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+          $ref: "#/components/schemas/Money"
         expires_at:
           type: string
           example: "2026-06-02T00:00:00Z"
@@ -4732,113 +4479,18 @@ components:
       type: object
       properties:
         refund_net:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+          $ref: "#/components/schemas/Money"
         penalty_net:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+          $ref: "#/components/schemas/Money"
         currency:
           type: string
           example: USD
         total_paid_net:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: What the airline recorded as paid to it for this item, net of
-            Jinko’s margin. The base `refund_net` is measured against, and not
-            what the customer paid.
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: What the airline recorded as paid to it for this item, net of
+                Jinko’s margin. The base `refund_net` is measured against, and
+                not what the customer paid.
       description: "The airline's own net figures, for reconciliation — never what the
         customer receives. `refund_net` is what the airline returns to Jinko,
         `penalty_net` what it withheld from Jinko and `total_paid_net` what it
@@ -4882,86 +4534,24 @@ components:
         operation_kind:
           $ref: "#/components/schemas/FlightOperationKind"
         refund_amount:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: "THE CUSTOMER FIGURE: what goes back to the payment method that
-            paid for this ticket — what they paid, less the penalty, or the
-            whole charge when the ticket was voided (`operation_kind: void`).
-            Show this one. `confirmed_refund_amount` beside it is the airline's
-            net figure and is smaller on any ticket sold at a margin. Absent is
-            not zero."
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: "THE CUSTOMER FIGURE: what goes back to the payment method that
+                paid for this ticket — what they paid, less the penalty, or the
+                whole charge when the ticket was voided (`operation_kind:
+                void`). Show this one. `confirmed_refund_amount` beside it is
+                the airline's net figure and is smaller on any ticket sold at a
+                margin. Absent is not zero."
         confirmed_refund_amount:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: The AIRLINE's net refund — what the supplier returns to Jinko, not
-            what the customer receives — kept unchanged for one contract version
-            under the name it has always had. Read `refund_amount` for the
-            customer and `provider_figures.refund_net` for reconciliation; this
-            field is removed in the next version. Omitted on a void, where no
-            supplier figure is read at all.
-          deprecated: true
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: The AIRLINE's net refund — what the supplier returns to Jinko, not
+                what the customer receives — kept unchanged for one contract
+                version under the name it has always had. Read `refund_amount`
+                for the customer and `provider_figures.refund_net` for
+                reconciliation; this field is removed in the next version.
+                Omitted on a void, where no supplier figure is read at all.
+              deprecated: true
         provider_figures:
           $ref: "#/components/schemas/FlightProviderFigures"
         refund_reference:
@@ -5018,42 +4608,11 @@ components:
         state:
           $ref: "#/components/schemas/ServicingState"
         refund_amount:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: "THE CUSTOMER FIGURE: what goes back to the payment method — the
-            settled figure once the refund has settled, the quoted one before.
-            Absent is not zero."
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: "THE CUSTOMER FIGURE: what goes back to the payment method — the
+                settled figure once the refund has settled, the quoted one
+                before. Absent is not zero."
         refund_reference:
           type: string
           example: rfnd_3c91f0a2
@@ -5101,39 +4660,7 @@ components:
             /v1/exchange_price is the binding figure.
           example: additional_payment_due
         estimated_amount:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+          $ref: "#/components/schemas/Money"
         validating_carrier:
           type: string
           example: AA
@@ -5177,148 +4704,20 @@ components:
         - booking_ref
         - last_name
       example: *a12
-    ExchangePriceResponse:
-      type: object
-      properties:
-        payment_outcome:
-          type: string
-          example: additional_payment_due
-        fare_difference:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-        penalty_amount:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-        total_due:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-        total_refund:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+    ExchangePriceResponse:
+      type: object
+      properties:
+        payment_outcome:
+          type: string
+          example: additional_payment_due
+        fare_difference:
+          $ref: "#/components/schemas/Money"
+        penalty_amount:
+          $ref: "#/components/schemas/Money"
+        total_due:
+          $ref: "#/components/schemas/Money"
+        total_refund:
+          $ref: "#/components/schemas/Money"
         session_reference:
           type: string
           example: exch_7a1c93f0
@@ -5456,73 +4855,9 @@ components:
       type: object
       properties:
         refund_net:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+          $ref: "#/components/schemas/Money"
         penalty_net:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+          $ref: "#/components/schemas/Money"
         currency:
           type: string
           example: USD
@@ -5555,124 +4890,31 @@ components:
         state:
           $ref: "#/components/schemas/ServicingState"
         refund_amount:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: "THE CUSTOMER FIGURE: what goes back to the payment method that
-            paid for this booking — what the customer paid for it, less
-            `penalty_amount`. Up to contract version 0.3.0 this field carried
-            the SUPPLIER's net refund instead, which on a booking sold at a
-            margin is a smaller number; the supplier's figure now lives in
-            `provider_figures.refund_net`. Absent when no refund was scheduled —
-            absent is not zero."
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: "THE CUSTOMER FIGURE: what goes back to the payment method that
+                paid for this booking — what the customer paid for it, less
+                `penalty_amount`. Up to contract version 0.3.0 this field
+                carried the SUPPLIER's net refund instead, which on a booking
+                sold at a margin is a smaller number; the supplier's figure now
+                lives in `provider_figures.refund_net`. Absent when no refund
+                was scheduled — absent is not zero."
         customer_refund_amount:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: Deprecated alias of `refund_amount`, carrying the same value. It
-            existed because `refund_amount` used to be the supplier figure; now
-            that `refund_amount` IS the customer figure the alias is redundant.
-            Read `refund_amount` — this field is removed in the next contract
-            version.
-          deprecated: true
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: Deprecated alias of `refund_amount`, carrying the same value. It
+                existed because `refund_amount` used to be the supplier figure;
+                now that `refund_amount` IS the customer figure the alias is
+                redundant. Read `refund_amount` — this field is removed in the
+                next contract version.
+              deprecated: true
         penalty_amount:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: "The cancellation penalty withheld from the customer, on the same
-            basis as `refund_amount`: what they paid, less this, is what they
-            get back. The penalty the SUPPLIER withheld from Jinko is
-            `provider_figures.penalty_net`."
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: "The cancellation penalty withheld from the customer, on the same
+                basis as `refund_amount`: what they paid, less this, is what
+                they get back. The penalty the SUPPLIER withheld from Jinko is
+                `provider_figures.penalty_net`."
         provider_figures:
           $ref: "#/components/schemas/ProviderFigures"
         connector_reference:
@@ -5765,89 +5007,32 @@ components:
             holding several items is quoted and cancelled one item at a time.
           example: itm_7f2c9a4e8b1d
         refund:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-            basis:
-              type: string
-              description: How the figure was computed. `sell_minus_penalty` — what the
-                customer paid for this item, less the penalty. `original_charge`
-                — the entire charge is reversed, penalty-free (a void). The
-                platform chooses; the caller cannot ask for one.
-              example: sell_minus_penalty
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - type: object
+              properties:
+                basis:
+                  type: string
+                  description: How the figure was computed. `sell_minus_penalty` — what the
+                    customer paid for this item, less the penalty.
+                    `original_charge` — the entire charge is reversed,
+                    penalty-free (a void). The platform chooses; the caller
+                    cannot ask for one.
+                  example: sell_minus_penalty
           description: "THE CUSTOMER FIGURE: what would go back to the payment method, on
             the basis named in `basis`. Show this one. Absent is not zero."
         penalty:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-            fee_known:
-              type: boolean
-              description: false means the penalty could not be established — UNKNOWN, not
-                zero. Render it as "we will confirm the fee", never as free
-                cancellation, and expect the final figure on the operation
-                status.
-              example: true
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - type: object
+              properties:
+                fee_known:
+                  type: boolean
+                  description: false means the penalty could not be established — UNKNOWN, not
+                    zero. Render it as "we will confirm the fee", never as free
+                    cancellation, and expect the final figure on the operation
+                    status.
+                  example: true
           description: What the customer would forfeit — read `fee_known` before showing it.
         policy:
           type: object
@@ -5872,43 +5057,7 @@ components:
                     description: When this step starts applying.
                     example: "2026-09-01T00:00:00Z"
                   amount:
-                    type: object
-                    properties:
-                      value:
-                        type: integer
-                        description: "Integer amount in MINOR units, always paired with decimal_places —
-                          divide by 10 ** decimal_places to display. Example:
-                          value 15977 with decimal_places 2 is 159.77 USD.
-                          Rendering this field directly shows prices 100x too
-                          high for 2-decimal currencies."
-                        example: 41250
-                      amount:
-                        type: number
-                        description: Alternative to `value` on some endpoints (the two never appear
-                          together); its scale depends on decimal_places. When
-                          this object carries decimal_places, amount is an
-                          INTEGER in minor units — divide by 10 **
-                          decimal_places (e.g. select_ancillaries
-                          total_with_ancillaries). When there is no
-                          decimal_places field, amount is a decimal in MAJOR
-                          units, safe to display as-is (e.g. trip and checkout
-                          totals).
-                      currency:
-                        type: string
-                        description: ISO 4217 currency code.
-                        example: USD
-                      decimal_places:
-                        type: integer
-                        description: "Scale of the integer value/amount: display = integer / 10 **
-                          decimal_places. Always sent alongside minor-unit
-                          amounts. Usually the ISO 4217 digits of the currency
-                          (2 for USD/EUR/GBP, 0 for JPY/KRW, 3 for BHD/JOD/KWD)
-                          but currency-converted prices can carry a different
-                          scale — ALWAYS use the decimal_places sent with the
-                          amount, never a hardcoded 2. Only if the field is
-                          genuinely absent on a value-shaped object, fall back
-                          to the ISO digits for the currency."
-                        example: 2
+                    $ref: "#/components/schemas/Money"
                   fraction:
                     type: number
                     description: The share of the paid price withheld from `from` onwards, when the
@@ -6024,41 +5173,7 @@ components:
           type: object
           properties:
             refund:
-              type: object
-              properties:
-                value:
-                  type: integer
-                  description: "Integer amount in MINOR units, always paired with decimal_places —
-                    divide by 10 ** decimal_places to display. Example: value
-                    15977 with decimal_places 2 is 159.77 USD. Rendering this
-                    field directly shows prices 100x too high for 2-decimal
-                    currencies."
-                  example: 41250
-                amount:
-                  type: number
-                  description: Alternative to `value` on some endpoints (the two never appear
-                    together); its scale depends on decimal_places. When this
-                    object carries decimal_places, amount is an INTEGER in minor
-                    units — divide by 10 ** decimal_places (e.g.
-                    select_ancillaries total_with_ancillaries). When there is no
-                    decimal_places field, amount is a decimal in MAJOR units,
-                    safe to display as-is (e.g. trip and checkout totals).
-                currency:
-                  type: string
-                  description: ISO 4217 currency code.
-                  example: USD
-                decimal_places:
-                  type: integer
-                  description: "Scale of the integer value/amount: display = integer / 10 **
-                    decimal_places. Always sent alongside minor-unit amounts.
-                    Usually the ISO 4217 digits of the currency (2 for
-                    USD/EUR/GBP, 0 for JPY/KRW, 3 for BHD/JOD/KWD) but
-                    currency-converted prices can carry a different scale —
-                    ALWAYS use the decimal_places sent with the amount, never a
-                    hardcoded 2. Only if the field is genuinely absent on a
-                    value-shaped object, fall back to the ISO digits for the
-                    currency."
-                  example: 2
+              $ref: "#/components/schemas/Money"
           description: The customer refund as it stands now, on `quote_drift`. This is
             what the customer would get if they accepted the new quote.
         active_operation:
@@ -6069,43 +5184,13 @@ components:
             /v1/flight_refund_status.
           example: svc_01J7ZR5Q2KME8V4T
         shortfall:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: How much of the refund could not be reserved, on
-            `funds_unavailable`. The refusal is about money still moving on the
-            original payment, not about this booking, so this is the figure that
-            says how much has to clear before a commit can succeed.
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: How much of the refund could not be reserved, on
+                `funds_unavailable`. The refusal is about money still moving on
+                the original payment, not about this booking, so this is the
+                figure that says how much has to clear before a commit can
+                succeed.
         blocking:
           type: array
           items:
@@ -6255,62 +5340,33 @@ components:
                   description: The reference the supplier issued for the cancellation or refund
                     itself, once it has issued one.
                   example: cxl_2f90a1c3
-          description: The supplier's record. It can say `cancelled` while the money is
-            still moving — that is the normal middle of a cancellation, not a
-            discrepancy.
-        money:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-            direction:
-              type: string
-              description: Which way the money moves. `refund` on a cancellation.
-              example: refund
-            vehicle_state:
-              type: string
-              description: "How far the money itself has got, independently of the supplier:
-                `reserved` (earmarked, nothing sent), `refund_pending`
-                (submitted to the payment provider), `payout_initiated` and
-                `payout_settled` (paid out to a third party), `paid` (it has
-                reached the customer), `released` (earmark dropped, nothing
-                owed), `refund_review` (a person at Jinko has to release it).
-                Only `paid` and `payout_settled` mean the customer has the
-                money."
-              example: paid
-            stripe_reference:
-              type: string
-              description: The payment provider's own refund id, once one exists.
-              example: re_3UBIxK2eZvKYlo2C
+          description: The supplier's record. It can say `cancelled` while the money is
+            still moving — that is the normal middle of a cancellation, not a
+            discrepancy.
+        money:
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - type: object
+              properties:
+                direction:
+                  type: string
+                  description: Which way the money moves. `refund` on a cancellation.
+                  example: refund
+                vehicle_state:
+                  type: string
+                  description: "How far the money itself has got, independently of the supplier:
+                    `reserved` (earmarked, nothing sent), `refund_pending`
+                    (submitted to the payment provider), `payout_initiated` and
+                    `payout_settled` (paid out to a third party), `paid` (it has
+                    reached the customer), `released` (earmark dropped, nothing
+                    owed), `refund_review` (a person at Jinko has to release
+                    it). Only `paid` and `payout_settled` mean the customer has
+                    the money."
+                  example: paid
+                stripe_reference:
+                  type: string
+                  description: The payment provider's own refund id, once one exists.
+                  example: re_3UBIxK2eZvKYlo2C
           description: The refund and where it has got to. Read `vehicle_state` before
             telling a customer they have been refunded.
     HotelCancelStatusRequest:
@@ -6469,92 +5525,35 @@ components:
           description: Which supplier the operation would be sent to. Informational.
           example: sabre-rest
         refund:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-            basis:
-              type: string
-              description: How the figure was computed. `sell_minus_penalty` — what the
-                customer paid for this item, less the penalty. `original_charge`
-                — the entire charge is reversed, penalty-free (a void). The
-                platform chooses; the caller cannot ask for one.
-              example: sell_minus_penalty
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - type: object
+              properties:
+                basis:
+                  type: string
+                  description: How the figure was computed. `sell_minus_penalty` — what the
+                    customer paid for this item, less the penalty.
+                    `original_charge` — the entire charge is reversed,
+                    penalty-free (a void). The platform chooses; the caller
+                    cannot ask for one.
+                  example: sell_minus_penalty
           description: "THE CUSTOMER FIGURE: what would go back to the payment method, on
             the basis named in `basis` — what they paid less the penalty, or the
             entire charge on a void. Show this one, never `provider_figures`.
             Absent is not zero: a quote whose penalty is unknown carries no
             refund figure at all."
         penalty:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-            fee_known:
-              type: boolean
-              description: false means the penalty could not be established — UNKNOWN, not
-                zero. Render it as "we will confirm the fee", never as free
-                cancellation, and expect the final figure on the operation
-                status.
-              example: true
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - type: object
+              properties:
+                fee_known:
+                  type: boolean
+                  description: false means the penalty could not be established — UNKNOWN, not
+                    zero. Render it as "we will confirm the fee", never as free
+                    cancellation, and expect the final figure on the operation
+                    status.
+                  example: true
           description: What the customer would forfeit, in the currency they were charged.
             Zero on a void. Read `fee_known` before showing it — false means
             UNKNOWN, not free.
@@ -6699,41 +5698,7 @@ components:
           type: object
           properties:
             refund:
-              type: object
-              properties:
-                value:
-                  type: integer
-                  description: "Integer amount in MINOR units, always paired with decimal_places —
-                    divide by 10 ** decimal_places to display. Example: value
-                    15977 with decimal_places 2 is 159.77 USD. Rendering this
-                    field directly shows prices 100x too high for 2-decimal
-                    currencies."
-                  example: 41250
-                amount:
-                  type: number
-                  description: Alternative to `value` on some endpoints (the two never appear
-                    together); its scale depends on decimal_places. When this
-                    object carries decimal_places, amount is an INTEGER in minor
-                    units — divide by 10 ** decimal_places (e.g.
-                    select_ancillaries total_with_ancillaries). When there is no
-                    decimal_places field, amount is a decimal in MAJOR units,
-                    safe to display as-is (e.g. trip and checkout totals).
-                currency:
-                  type: string
-                  description: ISO 4217 currency code.
-                  example: USD
-                decimal_places:
-                  type: integer
-                  description: "Scale of the integer value/amount: display = integer / 10 **
-                    decimal_places. Always sent alongside minor-unit amounts.
-                    Usually the ISO 4217 digits of the currency (2 for
-                    USD/EUR/GBP, 0 for JPY/KRW, 3 for BHD/JOD/KWD) but
-                    currency-converted prices can carry a different scale —
-                    ALWAYS use the decimal_places sent with the amount, never a
-                    hardcoded 2. Only if the field is genuinely absent on a
-                    value-shaped object, fall back to the ISO digits for the
-                    currency."
-                  example: 2
+              $ref: "#/components/schemas/Money"
           description: The customer refund as it stands now, on `quote_drift`. This is
             what the customer would get if they accepted the new quote.
         active_operation:
@@ -6744,43 +5709,13 @@ components:
             /v1/flight_refund_status.
           example: svc_01J7ZR5Q2KME8V4T
         shortfall:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: How much of the refund could not be reserved, on
-            `funds_unavailable`. The refusal is about money still moving on the
-            original payment, not about this booking, so this is the figure that
-            says how much has to clear before a commit can succeed.
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: How much of the refund could not be reserved, on
+                `funds_unavailable`. The refusal is about money still moving on
+                the original payment, not about this booking, so this is the
+                figure that says how much has to clear before a commit can
+                succeed.
         blocking:
           type: array
           items:
@@ -6964,58 +5899,29 @@ components:
             money is still moving — that is the normal middle of a refund, not a
             discrepancy.
         money:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-            direction:
-              type: string
-              description: Which way the money moves. `refund` on a cancellation.
-              example: refund
-            vehicle_state:
-              type: string
-              description: "How far the money itself has got, independently of the supplier:
-                `reserved` (earmarked, nothing sent), `refund_pending`
-                (submitted to the payment provider), `payout_initiated` and
-                `payout_settled` (paid out to a third party), `paid` (it has
-                reached the customer), `released` (earmark dropped, nothing
-                owed), `refund_review` (a person at Jinko has to release it).
-                Only `paid` and `payout_settled` mean the customer has the
-                money."
-              example: paid
-            stripe_reference:
-              type: string
-              description: The payment provider's own refund id, once one exists.
-              example: re_3UBIxK2eZvKYlo2C
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - type: object
+              properties:
+                direction:
+                  type: string
+                  description: Which way the money moves. `refund` on a cancellation.
+                  example: refund
+                vehicle_state:
+                  type: string
+                  description: "How far the money itself has got, independently of the supplier:
+                    `reserved` (earmarked, nothing sent), `refund_pending`
+                    (submitted to the payment provider), `payout_initiated` and
+                    `payout_settled` (paid out to a third party), `paid` (it has
+                    reached the customer), `released` (earmark dropped, nothing
+                    owed), `refund_review` (a person at Jinko has to release
+                    it). Only `paid` and `payout_settled` mean the customer has
+                    the money."
+                  example: paid
+                stripe_reference:
+                  type: string
+                  description: The payment provider's own refund id, once one exists.
+                  example: re_3UBIxK2eZvKYlo2C
           description: The refund and where it has got to. Read `vehicle_state` before
             telling a customer they have been refunded.
         operation_kind:
@@ -7308,6 +6214,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -7438,6 +6355,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -7569,6 +6497,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -7699,6 +6638,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -7828,6 +6778,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -7953,6 +6914,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -8093,10 +7065,15 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
                 status: expired
         "410":
-          description: The offer named in the request is no longer available.
-            **`OFFER_EXPIRED`** — The offer token is no longer in the platform’s
-            cache, so the item cannot be added. Search again and add the item
-            with a fresh token. Offers are short-lived by design.
+          description: The offer named in the request is no longer available, or another
+            resource the request names is gone. Tell the two apart by
+            `error.code`. **`OFFER_EXPIRED`** — The offer token is no longer in
+            the platform’s cache, so the item cannot be added. Search again and
+            add the item with a fresh token. Offers are short-lived by design.
+            **`GONE`** — The resource this request names existed and no longer
+            does. Re-acquire it — search again, or check out again to re-quote —
+            then retry with the new identifier. Repeating this request with the
+            same one cannot succeed.
           content:
             application/json:
               schema:
@@ -8228,6 +7205,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -8365,6 +7353,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -8490,6 +7489,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -8633,6 +7643,17 @@ paths:
                   code: CONFLICT
                   message: This trip is already being checked out; no second checkout was started.
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: The trip is not complete enough to check out. **`BAD_REQUEST`** —
             The request was malformed or failed validation. Fix the request as
@@ -8779,6 +7800,17 @@ paths:
                   - $ref: "#/components/schemas/TripStateResponse"
                   - $ref: "#/components/schemas/ErrorResponse"
               example: *a14
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: The trip is not complete enough to check out. **`BAD_REQUEST`** —
             The request was malformed or failed validation. Fix the request as
@@ -8908,22 +7940,29 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "410":
           description: The locked quote has expired, so nothing was redeemed and no
-            payment object was created. **`QUOTE_EXPIRED`** — The locked quote
-            behind this checkout passed its `expires_at`, so payment was refused
-            before any payment object was created. Call `POST /v1/checkout`
-            again on the same trip — it re-quotes — then mint a new Shared
-            Payment Token against the new `agent_spt_params` and submit that.
-            Nothing was charged.
+            payment object was created — or the resource the request names is
+            gone. Tell the two apart by `error.code`. **`QUOTE_EXPIRED`** — The
+            locked quote behind this checkout passed its `expires_at`, so
+            payment was refused before any payment object was created. Call
+            `POST /v1/checkout` again on the same trip — it re-quotes — then
+            mint a new Shared Payment Token against the new `agent_spt_params`
+            and submit that. Nothing was charged. **`GONE`** — The resource this
+            request names existed and no longer does. Re-acquire it — search
+            again, or check out again to re-quote — then retry with the new
+            identifier. Repeating this request with the same one cannot succeed.
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/QuoteExpiredResponse"
+                anyOf:
+                  - $ref: "#/components/schemas/QuoteExpiredResponse"
+                  - $ref: "#/components/schemas/ErrorResponse"
               example:
                 error:
                   code: QUOTE_EXPIRED
                   message: The quote behind this checkout expired at 2026-09-04T12:39:56Z.
                   doc_url: https://docs.gojinko.com/concepts/errors
                 expires_at: "2026-09-04T12:39:56Z"
+                quoted_cart_id: 2097152
         "422":
           description: Validation error
           content:
@@ -9049,6 +8088,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -9186,6 +8236,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -9316,6 +8377,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -9451,6 +8523,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -9593,6 +8676,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -9735,6 +8829,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -9876,6 +8981,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -10025,6 +9141,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -10173,6 +9300,17 @@ paths:
                   code: CONFLICT
                   message: the exchange preview is out of date — run a new preview and choose
                     again
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -10316,6 +9454,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -10571,6 +9720,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -10818,6 +9978,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -11052,6 +10223,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -11288,6 +10470,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -11540,6 +10733,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -11792,6 +10996,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -12031,6 +11246,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -12158,6 +11384,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -12283,6 +11520,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -12408,6 +11656,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -12544,6 +11803,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -12669,6 +11939,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -12794,6 +12075,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -12919,6 +12211,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -13044,6 +12347,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -13191,6 +12505,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -13338,6 +12663,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -13502,6 +12838,17 @@ paths:
                     value: 20500
                     currency: USD
                     decimal_places: 2
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -13646,6 +12993,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -13802,6 +13160,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -13972,6 +13341,17 @@ paths:
                     MANUAL_REQUIRED`; commit again with `manual_ok: true` to
                     hand it to a Jinko agent, then poll the operation."
                 code: manual_required
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -14120,6 +13500,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -14249,6 +13640,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -14368,6 +13770,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -14495,6 +13908,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -14621,6 +14045,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -14750,6 +14185,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content: