> ## 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}/wallets/{walletId}/transactions/{transactionId}/custom-fields



## OpenAPI

````yaml /api-reference/platform.openapi.json put /realms/{realmId}/organizations/{organizationId}/wallets/{walletId}/transactions/{transactionId}/custom-fields
openapi: 3.0.3
info:
  title: Platform
  version: 1.0.0
  description: >-
    Portão 3 platform API. Generated by tools/openapi from code (routes +
    security) and the hand-written spec (request/response bodies). Confidence
    tiers: generated:typed=56 copied:manual=6 unknown=63.
servers:
  - url: https://api.platform.v2.portao3.com.br/
    description: production
  - url: https://api.platform.dev.3pers.com.br/
    description: development
security:
  - bearerAuth: []
tags:
  - name: Wallets
  - name: Cards
  - name: PIX
  - name: PIX Keys (DICT)
  - name: Boleto
  - name: Transfers
  - name: Scheduled Payments
  - name: Transactions & Statements
  - name: Invoices
  - name: Contracts & Deals
  - name: Billing
  - name: Notifications
  - name: Users
  - name: Vehicles
paths:
  /realms/{realmId}/organizations/{organizationId}/wallets/{walletId}/transactions/{transactionId}/custom-fields:
    put:
      tags:
        - Transactions & Statements
      summary: >-
        /realms/{realmId}/organizations/{organizationId}/wallets/{walletId}/transactions/{transactionId}/custom-fields
      operationId: >-
        putRealmsByRealmIdOrganizationsByOrganizationIdWalletsByWalletIdTransactionsByTransactionIdCustomFields
      parameters:
        - name: realmId
          in: path
          required: true
          schema:
            type: string
        - name: organizationId
          in: path
          required: true
          schema:
            type: string
        - name: walletId
          in: path
          required: true
          schema:
            type: string
        - name: transactionId
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  _id:
                    type: string
                  environment:
                    type: string
                  realmId:
                    type: string
                  organizationId:
                    type: string
                  accountId:
                    type: string
                  walletId:
                    type: string
                  balanceCategory: {}
                  cardId:
                    type: string
                  availableBalanceBefore:
                    type: number
                  financialImpactType: {}
                  responseCode:
                    type: string
                  msgType:
                    type: string
                  txnType:
                    type: string
                  effectiveAt:
                    type: string
                  billingAmount:
                    type: number
                  billingAmountAuthorized:
                    type: number
                  billingCurrency:
                    type: string
                  cardTransaction: {}
                  pixTransaction: {}
                  boletoTransaction: {}
                  p2pTransaction: {}
                  tedTransaction: {}
                  feeTransaction: {}
                  receiptsCount:
                    type: number
                  customFields:
                    type: object
                    additionalProperties: {}
                  description:
                    type: string
                  receipts:
                    type: array
                    items:
                      type: string
                  paymentInfo:
                    type: object
                    properties:
                      status:
                        type: string
                      external:
                        type: object
                        properties:
                          platformUserId:
                            type: string
                      owner:
                        type: string
                      description:
                        type: string
                      receipts:
                        type: array
                        items:
                          type: string
                    required:
                      - status
                  external:
                    type: object
                    properties:
                      transactionId:
                        type: string
                      pixId:
                        type: string
                      paymentId:
                        type: string
                      boletoId:
                        type: string
                      tedId:
                        type: string
                      platformUserId:
                        type: string
                  spendReview:
                    type: object
                    properties:
                      status:
                        anyOf:
                          - type: string
                            enum:
                              - PENDING_APPROVAL
                              - APPROVED
                              - DECLINED
                            description: >-
                              Where an after-the-fact spend review of a
                              transaction stands.
                          - type: string
                      source:
                        anyOf:
                          - type: string
                            enum:
                              - PAYMENT
                            description: >-
                              Marks a review that was never submitted through
                              SPEND_REVIEW at all.
                          - type: string
                        description: >-
                          Set to PAYMENT when the transaction was created by a
                          payment (PIX, boleto or P2P) that was already approved
                          before it was made. Such transactions are approved
                          from the start and can never be submitted for spend
                          review. Their custom fields REMAIN EDITABLE, so a
                          document that only exists after the purchase — a
                          fiscal receipt — can still be attached; a review
                          without this field (one a person opened or approved)
                          locks them instead.
                      policyRequestId:
                        type: string
                        description: The approval-engine request this review is tracked by.
                      policyId:
                        type: string
                        description: The business policy that governed the review.
                      autoApproved:
                        type: boolean
                        description: >-
                          Present only when the review was approved
                          automatically by the matched policy.
                      requester:
                        type: object
                        properties:
                          userId:
                            type: string
                          name:
                            type: string
                          email:
                            type: string
                        required:
                          - userId
                          - name
                          - email
                        description: Who submitted the transaction for review.
                      requestedAt:
                        anyOf:
                          - type: string
                          - type: string
                            format: date-time
                      approvalExpiresAt:
                        anyOf:
                          - type: string
                          - type: string
                            format: date-time
                        description: >-
                          The review deadline; after it the review is declined
                          with `declineOutcome: "EXPIRED"`.
                      decidedAt:
                        anyOf:
                          - type: string
                          - type: string
                            format: date-time
                      declineOutcome:
                        anyOf:
                          - type: string
                            enum:
                              - DENIED
                              - CANCELED
                              - EXPIRED
                            description: Why a spend review ended DECLINED.
                          - type: string
                        description: Only when `status` is `DECLINED`.
                      decisionReason:
                        type: string
                        description: The reviewer's free-text reason, when one was given.
                    required:
                      - status
                      - requestedAt
                    description: >-
                      Present once the transaction was submitted for spend
                      review.
                  createdAt:
                    type: string
                  createdBy:
                    type: string
                  updatedAt:
                    type: string
                  updatedBy:
                    type: string
                required:
                  - environment
                  - realmId
                  - organizationId
                  - accountId
                  - walletId
                  - availableBalanceBefore
                  - financialImpactType
                  - responseCode
                  - msgType
                  - txnType
                  - effectiveAt
                  - billingAmount
                  - billingAmountAuthorized
                  - billingCurrency
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````