docs fix

interface/models/payment/payment.yaml

@@ -13,6 +13,9 @@ components:
 
     LedgerEndpoint:
       type: object
+      additionalProperties: false
+      required:
+        - ledger_account_ref
       properties:
         ledger_account_ref:
           type: string
@@ -21,6 +24,9 @@ components:
 
     ManagedWalletEndpoint:
       type: object
+      additionalProperties: false
+      required:
+        - managed_wallet_ref
       properties:
         managed_wallet_ref:
           type: string
@@ -29,6 +35,10 @@ components:
 
     ExternalChainEndpoint:
       type: object
+      additionalProperties: false
+      required:
+        - asset
+        - address
       properties:
         asset:
           $ref: ./payment.yaml#/components/schemas/Asset
@@ -39,6 +49,9 @@ components:
 
     CardEndpoint:
       type: object
+      additionalProperties: false
+      required:
+        - pan
       properties:
         pan:
           type: string
@@ -49,20 +62,34 @@ components:
         exp_month:
           type: integer
           format: int32
+          minimum: 0
         exp_year:
           type: integer
           format: int32
+          minimum: 0
         country:
           type: string
 
     CardTokenEndpoint:
       type: object
+      additionalProperties: false
+      required:
+        - token
       properties:
         token:
           type: string
         masked_pan:
           type: string
 
+    WalletEndpoint:
+      type: object
+      additionalProperties: false
+      required:
+        - walletId
+      properties:
+        walletId:
+          type: string
+
     Endpoint:
       type: object
       additionalProperties: false
@@ -73,8 +100,13 @@ components:
         type:
           $ref: ../../external/endpoint_type.yaml#/components/schemas/EndpointType
         data:
-          type: object
-          additionalProperties: true
+          oneOf:
+            - $ref: ./payment.yaml#/components/schemas/LedgerEndpoint
+            - $ref: ./payment.yaml#/components/schemas/ManagedWalletEndpoint
+            - $ref: ./payment.yaml#/components/schemas/ExternalChainEndpoint
+            - $ref: ./payment.yaml#/components/schemas/CardEndpoint
+            - $ref: ./payment.yaml#/components/schemas/CardTokenEndpoint
+            - $ref: ./payment.yaml#/components/schemas/WalletEndpoint
         metadata:
           type: object
           additionalProperties:
@@ -121,6 +153,7 @@ components:
       type: object
       additionalProperties: false
       required:
+        - pair
         - side
       properties:
         pair:
@@ -159,8 +192,12 @@ components:
           $ref: ./payment.yaml#/components/schemas/FxIntent
         settlement_mode:
           $ref: ../../external/settlement_mode.yaml#/components/schemas/SettlementMode
-        settlement_currency:
+        fee_treatment:
           type: string
+          enum:
+            - unspecified
+            - add_to_source
+            - deduct_from_destination
         attributes:
           type: object
           additionalProperties:
@@ -168,27 +205,6 @@ components:
         customer:
           $ref: ./payment.yaml#/components/schemas/Customer
 
-    PaymentQuote:
-      type: object
-      additionalProperties: false
-      properties:
-        quoteRef:
-          type: string
-        debitAmount:
-          $ref: ../common/money.yaml#/components/schemas/Money
-        debitSettlementAmount:
-          $ref: ../common/money.yaml#/components/schemas/Money
-        expectedSettlementAmount:
-          $ref: ../common/money.yaml#/components/schemas/Money
-        expectedFeeTotal:
-          $ref: ../common/money.yaml#/components/schemas/Money
-        feeLines:
-          type: array
-          items:
-            $ref: ./payment.yaml#/components/schemas/FeeLine
-        fxQuote:
-          $ref: ./payment.yaml#/components/schemas/FxQuote
-
     FeeLine:
       type: object
       additionalProperties: false
@@ -206,6 +222,26 @@ components:
           additionalProperties:
             type: string
 
+    QuoteFees:
+      type: object
+      additionalProperties: false
+      properties:
+        lines:
+          type: array
+          items:
+            $ref: ./payment.yaml#/components/schemas/FeeLine
+
+    QuoteAmounts:
+      type: object
+      additionalProperties: false
+      properties:
+        sourcePrincipal:
+          $ref: ../common/money.yaml#/components/schemas/Money
+        sourceDebitTotal:
+          $ref: ../common/money.yaml#/components/schemas/Money
+        destinationSettlement:
+          $ref: ../common/money.yaml#/components/schemas/Money
+
     FxQuote:
       type: object
       additionalProperties: false
@@ -237,22 +273,43 @@ components:
         firm:
           type: boolean
 
-    PaymentQuoteAggregate:
+    PaymentQuote:
       type: object
       additionalProperties: false
       properties:
-        debitAmounts:
-          type: array
-          items:
-            $ref: ../common/money.yaml#/components/schemas/Money
-        expectedSettlementAmounts:
-          type: array
-          items:
-            $ref: ../common/money.yaml#/components/schemas/Money
-        expectedFeeTotals:
-          type: array
-          items:
-            $ref: ../common/money.yaml#/components/schemas/Money
+        quoteRef:
+          type: string
+        intentRef:
+          type: string
+        amounts:
+          $ref: ./payment.yaml#/components/schemas/QuoteAmounts
+        fees:
+          $ref: ./payment.yaml#/components/schemas/QuoteFees
+        fxQuote:
+          $ref: ./payment.yaml#/components/schemas/FxQuote
+
+    PaymentOperation:
+      type: object
+      additionalProperties: false
+      properties:
+        stepRef:
+          type: string
+        code:
+          type: string
+        state:
+          type: string
+        label:
+          type: string
+        failureCode:
+          type: string
+        failureReason:
+          type: string
+        startedAt:
+          type: string
+          format: date-time
+        completedAt:
+          type: string
+          format: date-time
 
     Payment:
       type: object
@@ -268,6 +325,10 @@ components:
           type: string
         failureReason:
           type: string
+        operations:
+          type: array
+          items:
+            $ref: ./payment.yaml#/components/schemas/PaymentOperation
         lastQuote:
           $ref: ./payment.yaml#/components/schemas/PaymentQuote
         createdAt: