feat(docs): update with transfer api

src/swaggers/openpix.yml

@@ -1994,6 +1994,48 @@ paths:
                 properties:
                   error:
                     type: string
+  /api/v1/transfer:
+    post:
+      tags:
+        - transfer (request access)
+      summary: Create a Transfer
+      description: Endpoint to to transfer values between sub accounts
+      requestBody:
+        description: Data to create a transfer
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              $ref: '#/components/schemas/TransferCreatePayload'
+            example:
+              value: 100
+              fromPixKey: [email protected]
+              toPixKey: [email protected]
+      responses:
+        '200':
+          description: Transfer transaction information
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  transaction:
+                    $ref: '#/components/schemas/TransferTransaction'
+                example:
+                  transaction:
+                    value: 100
+                    time: 2023-06-22T15:33:27.165Z,
+                    correlationID: c782e0ac-833d-4a89-9e73-9b60b2b41d3a
+        '400':
+          description: An error message
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  error:
+                    type: string
   '/api/v1/webhook/{id}':
     delete:
       tags:
@@ -3145,6 +3187,32 @@ components:
           $ref: '#/components/schemas/Customer'
         type:
           type: string
+    TransferCreatePayload:
+      type: object
+      properties:
+        value:
+          type: number
+          description: value of the transfer in cents
+        fromPixKey:
+          type: string
+          description:
+            the pix key of the account the value of the transfer will come out
+            from
+        toPixKey:
+          type: string
+          description: the pix key of the account the value of the transfer will go to
+    TransferTransaction:
+      type: object
+      properties:
+        value:
+          type: number
+          description: value of the transaction generated by the transfer
+        time:
+          type: string
+          description: the time the transfer happened
+        correlationID:
+          type: string
+          description: your correlation ID to keep track of this transfer
     WebhookPayload:
       type: object
       properties:
@@ -3266,6 +3334,9 @@ tags:
   - name: transactions
     description: |
       Endpoint to manage Transactions
+  - name: transfer (request access)
+    description: |
+      Endpoint to transfer values between sub accounts.
   - name: webhook
     description: |
       Endpoint to manage Webhooks