> ## Documentation Index > Fetch the complete documentation index at: https://developers.portao3.com.br/llms.txt > Use this file to discover all available pages before exploring further. # /realms/{realmId}/organizations/{organizationId}/accounts/{accountId}/wallets/{walletId}/transfer-requests/{transferRequestId}/request ## OpenAPI ````yaml /api-reference/banking.openapi.json post /realms/{realmId}/organizations/{organizationId}/accounts/{accountId}/wallets/{walletId}/transfer-requests/{transferRequestId}/request openapi: 3.0.3 info: title: Banking version: 1.0.0 description: >- Portão 3 banking API. Generated by tools/openapi from code (routes + security) and the hand-written spec (request/response bodies). Banking attaches a zod validationSchema at the route; request bodies are resolved from it (object + array roots). Responses have no presenter layer, so they stay tier=unknown. Confidence tiers: generated:typed=99 copied:manual=5 unknown=73. servers: - url: https://api.banking.v2.portao3.com.br/ description: production - url: https://api.banking.dev.3pers.com.br/ description: development security: - bearerAuth: [] tags: - name: Accounts - name: Wallets - name: Cards - name: PIX - name: PIX Keys (DICT) - name: PIX Charges - name: PIX Automatic - name: PIX Initiation (Open Finance) - name: PIX Infractions (MED) - name: Boleto - name: Boleto Charges - name: TED - name: Transfers - name: Transactions - name: Cashback paths: /realms/{realmId}/organizations/{organizationId}/accounts/{accountId}/wallets/{walletId}/transfer-requests/{transferRequestId}/request: post: tags: - Wallets summary: >- /realms/{realmId}/organizations/{organizationId}/accounts/{accountId}/wallets/{walletId}/transfer-requests/{transferRequestId}/request operationId: >- postRealmsByRealmIdOrganizationsByOrganizationIdAccountsByAccountIdWalletsByWalletIdTransferRequestsByTransferRequestIdRequest parameters: - name: realmId in: path required: true schema: type: string - name: organizationId in: path required: true schema: type: string - name: accountId in: path required: true schema: type: string - name: walletId in: path required: true schema: type: string - name: transferRequestId in: path required: true schema: type: string responses: '201': description: Successful response content: application/json: schema: type: object properties: id: type: string realmId: type: string organizationId: type: string accountId: type: string walletId: type: string originAccountId: type: string originWalletId: type: string sourceCategory: type: string enum: - FLEX_NATIONAL - FLEX_INTERNATIONAL - FOOD - GAS - MOBILITY - TOLL - FLEX_NATIONAL_WITHOUT_WITHDRAWALS - ADS - SAAS - HOTEL - AIRLINES - TRAVEL destinationCategory: type: string enum: - FLEX_NATIONAL - FLEX_INTERNATIONAL - FOOD - GAS - MOBILITY - TOLL - FLEX_NATIONAL_WITHOUT_WITHDRAWALS - ADS - SAAS - HOTEL - AIRLINES - TRAVEL amount: type: number description: type: string requester: type: object properties: userId: type: string name: type: string email: type: string required: - userId - name - email status: type: string enum: - PENDING_APPROVAL - REQUESTED - CONFIRMED - CANCELLED - EXPIRED - FAILED policyRequestId: type: string expiresAt: type: string confirmedAt: type: string cancelledAt: type: string failureReason: type: string createdAt: type: string updatedAt: type: string environment: type: string enum: - LIVE - TEST confirmingAt: type: string policyRequest: type: object properties: id: type: string realmId: type: string organizationId: type: string accountId: type: string description: >- Kept from the request payload so the subject can be fulfilled later. walletId: type: string context: anyOf: - type: string enum: - PAYMENT - SPEND_REVIEW - TRAVEL description: The business surface a policy governs. - type: string subjectType: type: string subjectId: type: string requester: type: object properties: userId: type: string name: type: string email: type: string required: - userId - name - email body: type: object additionalProperties: {} description: Full subject entity snapshot. policyId: type: string description: The matched business policy. status: type: string enum: - REQUESTED - APPROVED - DENIED - CANCELED - EXPIRED description: >- Root lifecycle: REQUESTED → APPROVED | DENIED | CANCELED | EXPIRED (terminal). executionStatus: type: string enum: - WAITING - PROCESSING - EXECUTED - FAILED description: Runs only after the root reaches APPROVED. executionFailReason: type: string approvalDeadline: anyOf: - type: string - type: string format: date-time description: >- createdAt + policy.actions.approvalDeadlineHours (default 72h). executionMoveBalance: type: object properties: addBalance: type: boolean fromAccountId: type: string description: Required when `addBalance` is true. fromWalletId: type: string description: Required when `addBalance` is true. required: - addBalance description: Copied from the matched policy at creation. approvalHierarchy: type: boolean description: Copied from policy.actions.hierarchy. approvals: type: array items: type: object properties: type: type: string enum: - USER - GROUP id: type: string description: userId when type=USER, groupId when type=GROUP. name: type: string status: type: string enum: - WAITING - REQUESTED - APPROVED - DENIED - CANCELED description: Per-approval / per-approver lifecycle. users: type: array items: type: object properties: userId: type: string userName: type: string userEmail: type: string status: type: string enum: - WAITING - REQUESTED - APPROVED - DENIED - CANCELED description: Per-approval / per-approver lifecycle. required: - userId - userName - userEmail - status description: >- 1 entry for USER, N for GROUP — resolved from identity at creation. createdAt: anyOf: - type: string - type: string format: date-time requestedAt: anyOf: - type: string - type: string format: date-time decisionAt: anyOf: - type: string - type: string format: date-time required: - type - id - name - status - users createdAt: anyOf: - type: string - type: string format: date-time updatedAt: anyOf: - type: string - type: string format: date-time required: - id - realmId - organizationId - accountId - walletId - context - subjectType - subjectId - requester - body - policyId - status - executionStatus - approvalDeadline - approvalHierarchy - approvals required: - accountId - amount - createdAt - destinationCategory - environment - id - organizationId - originAccountId - originWalletId - policyRequest - realmId - requester - sourceCategory - status - updatedAt - walletId description: >- Transient, never persisted — the policy-request ruleengine just opened. components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````