document generation for ops

interface/api.yaml

@@ -95,6 +95,8 @@ paths:
     $ref: ./api/payments/by_multiquote.yaml
   /payments/{organizations_ref}:
     $ref: ./api/payments/list.yaml
+  /payments/documents/operation/{organizations_ref}:
+    $ref: ./api/payments/documents_operation.yaml
 
 components:
   securitySchemes:

interface/api/payments/documents_operation.yaml

@@ -1,27 +1,29 @@
 get:
   tags: [Payments]
-  summary: Download act document by payment reference
-  description: Returns the billing act document as binary content.
-  operationId: paymentsGetActDocument
+  summary: Download billing document by operation reference
+  description: |
+    Returns operation-level billing document as binary content.
+    The request is resolved by gateway service and operation reference.
+  operationId: paymentsGetOperationDocument
   security:
     - bearerAuth: []
   parameters:
     - $ref: ../parameters/organizations_ref.yaml#/components/parameters/OrganizationsRef
-    - name: payment_ref
+    - name: gateway_service
       in: query
-      required: false
-      description: Payment reference for which to fetch the act document.
+      required: true
+      description: Gateway service identifier (`chain_gateway`, `tron_gateway`, `mntx_gateway`, `payment_gateway`, `tgsettle_gateway`).
       schema:
         type: string
-    - name: paymentRef
+    - name: operation_ref
       in: query
-      required: false
-      description: Alias of `payment_ref`.
+      required: true
+      description: Operation reference for which to fetch billing document.
       schema:
         type: string
   responses:
     '200':
-      description: Act document file
+      description: Operation billing document file
       content:
         application/pdf:
           schema: