Callbacks service docs updated

interface/api/payments/response/payment.yaml

@@ -1,6 +1,7 @@
 components:
   schemas:
     PaymentQuoteData:
+      description: Response payload for a single payment quote.
       type: object
       additionalProperties: false
       required:
@@ -8,13 +9,17 @@ components:
         - quote
       properties:
         accessToken:
+          description: Refreshed access token to be used in subsequent API calls.
           $ref: ../../../models/auth/token_data.yaml#/components/schemas/TokenData
         idempotencyKey:
+          description: Idempotency key associated with the quote response.
           type: string
         quote:
+          description: Generated quote data for the requested payment intent.
           $ref: ../../../models/payment/payment.yaml#/components/schemas/PaymentQuote
 
     PaymentQuotesData:
+      description: Response payload for a batch quote request.
       type: object
       additionalProperties: false
       required:
@@ -22,21 +27,27 @@ components:
         - quote
       properties:
         accessToken:
+          description: Refreshed access token to be used in subsequent API calls.
           $ref: ../../../models/auth/token_data.yaml#/components/schemas/TokenData
         quote:
+          description: Batch quote summary and quoted items.
           type: object
           additionalProperties: false
           properties:
             idempotencyKey:
+              description: Idempotency key associated with the batch quote response.
               type: string
             quoteRef:
+              description: Reference to the generated batch quote.
               type: string
             items:
+              description: Collection of quotes for each requested payment intent.
               type: array
               items:
                 $ref: ../../../models/payment/payment.yaml#/components/schemas/PaymentQuote
 
     PaymentsData:
+      description: Response payload containing a list of payments.
       type: object
       additionalProperties: false
       required:
@@ -44,15 +55,19 @@ components:
         - payments
       properties:
         accessToken:
+          description: Refreshed access token to be used in subsequent API calls.
           $ref: ../../../models/auth/token_data.yaml#/components/schemas/TokenData
         payments:
+          description: Collection of payment records.
           type: array
           items:
             $ref: ../../../models/payment/payment.yaml#/components/schemas/Payment
         page:
+          description: Pagination cursor metadata for payment listing endpoints.
           $ref: ../../../models/common/pagination.yaml#/components/schemas/CursorPageResponse
 
     PaymentData:
+      description: Response payload containing a single payment record.
       type: object
       additionalProperties: false
       required:
@@ -60,6 +75,8 @@ components:
         - payment
       properties:
         accessToken:
+          description: Refreshed access token to be used in subsequent API calls.
           $ref: ../../../models/auth/token_data.yaml#/components/schemas/TokenData
         payment:
+          description: Requested payment record.
           $ref: ../../../models/payment/payment.yaml#/components/schemas/Payment