> ## 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}/transactions/{transactionId}/reversals/{reversalId}/cancel



## OpenAPI

````yaml /api-reference/banking.openapi.json post /realms/{realmId}/organizations/{organizationId}/accounts/{accountId}/wallets/{walletId}/transactions/{transactionId}/reversals/{reversalId}/cancel
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=107 copied:manual=7
    unknown=79.
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
  - name: Currency Codes
  - name: Reversals
paths:
  /realms/{realmId}/organizations/{organizationId}/accounts/{accountId}/wallets/{walletId}/transactions/{transactionId}/reversals/{reversalId}/cancel:
    post:
      tags:
        - Transactions
      summary: >-
        /realms/{realmId}/organizations/{organizationId}/accounts/{accountId}/wallets/{walletId}/transactions/{transactionId}/reversals/{reversalId}/cancel
      operationId: >-
        postRealmsByRealmIdOrganizationsByOrganizationIdAccountsByAccountIdWalletsByWalletIdTransactionsByTransactionIdReversalsByReversalIdCancel
      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: transactionId
          in: path
          required: true
          schema:
            type: string
        - name: reversalId
          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
                    enum:
                      - LIVE
                      - TEST
                  realmId:
                    type: string
                  organizationId:
                    type: string
                  accountId:
                    type: string
                  walletId:
                    type: string
                  transactionId:
                    type: string
                  status:
                    type: string
                    enum:
                      - INITIATED
                      - REQUESTED
                      - CONFIRMED
                      - FAILED
                      - CANCELED
                  requestedAt:
                    type: string
                    format: date-time
                  originalPixId:
                    type: string
                  originalPixBillingId:
                    type: string
                  originalReceipt:
                    type: object
                    properties:
                      endToEndId:
                        type: string
                    required:
                      - endToEndId
                  originalEffectiveAt:
                    type: string
                    format: date-time
                  originalAmount:
                    type: number
                  originalCurrency:
                    type: string
                    enum:
                      - '784'
                      - '971'
                      - '008'
                      - '051'
                      - '973'
                      - '032'
                      - '036'
                      - '533'
                      - '944'
                      - '977'
                      - '052'
                      - '050'
                      - '048'
                      - '108'
                      - '060'
                      - '096'
                      - '068'
                      - '984'
                      - '986'
                      - '044'
                      - '064'
                      - '072'
                      - '933'
                      - '084'
                      - '124'
                      - '976'
                      - '947'
                      - '756'
                      - '948'
                      - '990'
                      - '152'
                      - '156'
                      - '170'
                      - '970'
                      - '188'
                      - '192'
                      - '132'
                      - '203'
                      - '262'
                      - '208'
                      - '214'
                      - '012'
                      - '818'
                      - '232'
                      - '230'
                      - '978'
                      - '242'
                      - '238'
                      - '826'
                      - '981'
                      - '936'
                      - '292'
                      - '270'
                      - '324'
                      - '320'
                      - '328'
                      - '344'
                      - '340'
                      - '332'
                      - '348'
                      - '360'
                      - '376'
                      - '356'
                      - '368'
                      - '364'
                      - '352'
                      - '388'
                      - '400'
                      - '392'
                      - '404'
                      - '417'
                      - '116'
                      - '174'
                      - '408'
                      - '410'
                      - '414'
                      - '136'
                      - '398'
                      - '418'
                      - '422'
                      - '144'
                      - '430'
                      - '426'
                      - '434'
                      - '504'
                      - '498'
                      - '969'
                      - '807'
                      - '104'
                      - '496'
                      - '446'
                      - '929'
                      - '480'
                      - '462'
                      - '454'
                      - '484'
                      - '979'
                      - '458'
                      - '943'
                      - '516'
                      - '566'
                      - '558'
                      - '578'
                      - '524'
                      - '554'
                      - '512'
                      - '590'
                      - '604'
                      - '598'
                      - '608'
                      - '586'
                      - '985'
                      - '600'
                      - '634'
                      - '946'
                      - '941'
                      - '643'
                      - '646'
                      - '682'
                      - '090'
                      - '690'
                      - '938'
                      - '752'
                      - '702'
                      - '654'
                      - '925'
                      - '706'
                      - '968'
                      - '728'
                      - '930'
                      - '222'
                      - '760'
                      - '748'
                      - '764'
                      - '972'
                      - '934'
                      - '788'
                      - '776'
                      - '949'
                      - '780'
                      - '901'
                      - '834'
                      - '980'
                      - '800'
                      - '840'
                      - '997'
                      - '940'
                      - '858'
                      - '927'
                      - '860'
                      - '926'
                      - '928'
                      - '704'
                      - '548'
                      - '882'
                      - '396'
                      - '950'
                      - '961'
                      - '959'
                      - '955'
                      - '956'
                      - '957'
                      - '958'
                      - '951'
                      - '532'
                      - '960'
                      - '952'
                      - '964'
                      - '953'
                      - '962'
                      - '994'
                      - '963'
                      - '965'
                      - '999'
                      - '886'
                      - '710'
                      - '967'
                      - '924'
                  originalCreditParty:
                    type: object
                    properties:
                      bankIspb:
                        type: string
                      accountType:
                        type: string
                        enum:
                          - CACC
                          - SLRY
                          - SVGS
                          - TRAN
                      document:
                        type: string
                      keyType:
                        type: string
                        enum:
                          - PHONE
                          - EMAIL
                          - CPF
                          - CNPJ
                          - EVP
                      key:
                        type: string
                      name:
                        type: string
                      street:
                        type: string
                      city:
                        type: string
                      state:
                        type: string
                      postalCode:
                        type: string
                      branch:
                        type: string
                      accountNumber:
                        type: number
                  originalDebitParty:
                    type: object
                    properties:
                      bankIspb:
                        type: string
                      accountType:
                        type: string
                        enum:
                          - CACC
                          - SLRY
                          - SVGS
                          - TRAN
                      document:
                        type: string
                      keyType:
                        type: string
                        enum:
                          - PHONE
                          - EMAIL
                          - CPF
                          - CNPJ
                          - EVP
                      key:
                        type: string
                      name:
                        type: string
                      street:
                        type: string
                      city:
                        type: string
                      state:
                        type: string
                      postalCode:
                        type: string
                      branch:
                        type: string
                      accountNumber:
                        type: number
                  reversalReason:
                    type: string
                    enum:
                      - USER_REQUESTED
                  reversalDescription:
                    type: string
                    nullable: true
                  reversalEffectiveAt:
                    type: string
                    format: date-time
                    nullable: true
                  reversalAmount:
                    type: number
                  reversalCurrency:
                    type: string
                    enum:
                      - '784'
                      - '971'
                      - '008'
                      - '051'
                      - '973'
                      - '032'
                      - '036'
                      - '533'
                      - '944'
                      - '977'
                      - '052'
                      - '050'
                      - '048'
                      - '108'
                      - '060'
                      - '096'
                      - '068'
                      - '984'
                      - '986'
                      - '044'
                      - '064'
                      - '072'
                      - '933'
                      - '084'
                      - '124'
                      - '976'
                      - '947'
                      - '756'
                      - '948'
                      - '990'
                      - '152'
                      - '156'
                      - '170'
                      - '970'
                      - '188'
                      - '192'
                      - '132'
                      - '203'
                      - '262'
                      - '208'
                      - '214'
                      - '012'
                      - '818'
                      - '232'
                      - '230'
                      - '978'
                      - '242'
                      - '238'
                      - '826'
                      - '981'
                      - '936'
                      - '292'
                      - '270'
                      - '324'
                      - '320'
                      - '328'
                      - '344'
                      - '340'
                      - '332'
                      - '348'
                      - '360'
                      - '376'
                      - '356'
                      - '368'
                      - '364'
                      - '352'
                      - '388'
                      - '400'
                      - '392'
                      - '404'
                      - '417'
                      - '116'
                      - '174'
                      - '408'
                      - '410'
                      - '414'
                      - '136'
                      - '398'
                      - '418'
                      - '422'
                      - '144'
                      - '430'
                      - '426'
                      - '434'
                      - '504'
                      - '498'
                      - '969'
                      - '807'
                      - '104'
                      - '496'
                      - '446'
                      - '929'
                      - '480'
                      - '462'
                      - '454'
                      - '484'
                      - '979'
                      - '458'
                      - '943'
                      - '516'
                      - '566'
                      - '558'
                      - '578'
                      - '524'
                      - '554'
                      - '512'
                      - '590'
                      - '604'
                      - '598'
                      - '608'
                      - '586'
                      - '985'
                      - '600'
                      - '634'
                      - '946'
                      - '941'
                      - '643'
                      - '646'
                      - '682'
                      - '090'
                      - '690'
                      - '938'
                      - '752'
                      - '702'
                      - '654'
                      - '925'
                      - '706'
                      - '968'
                      - '728'
                      - '930'
                      - '222'
                      - '760'
                      - '748'
                      - '764'
                      - '972'
                      - '934'
                      - '788'
                      - '776'
                      - '949'
                      - '780'
                      - '901'
                      - '834'
                      - '980'
                      - '800'
                      - '840'
                      - '997'
                      - '940'
                      - '858'
                      - '927'
                      - '860'
                      - '926'
                      - '928'
                      - '704'
                      - '548'
                      - '882'
                      - '396'
                      - '950'
                      - '961'
                      - '959'
                      - '955'
                      - '956'
                      - '957'
                      - '958'
                      - '951'
                      - '532'
                      - '960'
                      - '952'
                      - '964'
                      - '953'
                      - '962'
                      - '994'
                      - '963'
                      - '965'
                      - '999'
                      - '886'
                      - '710'
                      - '967'
                      - '924'
                  reversalAdditionalInformation:
                    type: string
                  reversalReceipt:
                    type: object
                    properties:
                      endToEndId:
                        type: string
                    required:
                      - endToEndId
                  errorCode:
                    type: string
                  errorDescription:
                    type: string
                  external:
                    type: object
                    properties:
                      reversalId:
                        type: string
                  processingType:
                    type: string
                    enum:
                      - INSTANT
                      - DELAYED
                  createdAt:
                    type: string
                    format: date-time
                  updatedAt:
                    type: string
                    format: date-time
                  confirmingAt:
                    type: string
                    format: date-time
                    description: >-
                      Banking-internal atomic-claim lock, taken by the confirm
                      before any money moves and never exposed on the wire (the
                      model's toJSON strips it).
                required:
                  - environment
                  - realmId
                  - organizationId
                  - accountId
                  - walletId
                  - transactionId
                  - status
                  - originalEffectiveAt
                  - originalAmount
                  - originalCurrency
                  - originalCreditParty
                  - originalDebitParty
                  - reversalReason
                  - reversalDescription
                  - reversalEffectiveAt
                  - reversalAmount
                  - reversalCurrency
                description: >-
                  A reversal of a pix we RECEIVED — money goes back OUT to the
                  original sender.


                  ⚠️ Not to be confused with the legacy `PixInReversal*` webhook
                  family
                  (`connectors/swapBanking/types/webhooks/PIXInReversal.ts`) or
                  the domain-side `PixRollback`, both of which describe the
                  OPPOSITE direction: SWAP telling us a pix we SENT was
                  reversed, money coming back IN.


                  The `original*` fields snapshot the CREDIT transaction being
                  reversed; the `reversal*` fields describe the outgoing refund
                  itself.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````