---
title: "Transaction"
url: "https://devcenter.stone.com.br/apis/banking-statement/versions/6cf07218-05b9-47de-a54e-a2fcbd87ce72/schemas/Transaction"
---

> Full API specification: https://devcenter.stone.com.br/apis/banking-statement/versions/6cf07218-05b9-47de-a54e-a2fcbd87ce72.md

# Transaction

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: Banking Statement API
  version: 1.0.0
servers:
  - url: https://api.stone.com.br
    description: Produção
  - url: https://sdx.api.stone.com.br
    description: Sandbox
components:
  schemas:
    CounterpartyAgent:
      type: object
      description: Informações sobre a contraparte envolvida na transação.
      properties:
        account:
          $ref: "#/components/schemas/CounterpartyAccount"
        entity:
          $ref: "#/components/schemas/CounterpartyEntity"
        institution:
          $ref: "#/components/schemas/CounterpartyInstitution"
    CounterpartyAccount:
      type: object
      description: Detalhes da conta da contraparte.
      properties:
        account_code:
          type: string
          description: Número/código da conta.
        branch_code:
          type: string
          nullable: true
          description: Código da agência, se aplicável.
        account_type:
          type: string
          description: "Tipo de conta. Valores observados: PG, CC, PP, CD, CG."
    CounterpartyEntity:
      type: object
      description: Detalhes de identidade da contraparte.
      properties:
        name:
          type: string
          description: Nome da contraparte.
        document_type:
          type: string
          description: "Tipo de documento (ex: cpf, cnpj)."
        document:
          type: string
          description: Número do documento.
    CounterpartyInstitution:
      type: object
      description: Detalhes da instituição financeira.
      properties:
        ispb:
          type: string
          description: Código ISPB (identificador do sistema de pagamentos brasileiro).
        compe:
          type: string
          description: Código COMPE (identificador do banco).
        name:
          type: string
          description: Nome da instituição.
    Transaction:
      type: object
      required:
        - id
        - account_id
        - amount
        - operation
        - type
        - created_at
        - balance_before
        - balance_after
      properties:
        id:
          type: string
          format: uuid
          description: Identificador único da transação.
        account_id:
          type: string
          format: uuid
          description: Identificador da conta associada à transação.
        amount:
          type: integer
          format: int64
          description: Valor da transação em centavos (menor unidade da moeda).
        fee_amount:
          type: integer
          format: int64
          description: Valor da taxa cobrada na transação, em centavos.
        operation_amount:
          type: integer
          format: int64
          description: Valor líquido da operação, em centavos. Pode incluir ou excluir
            taxas dependendo do contexto.
        created_at:
          type: string
          format: date-time
          description: Data e hora de criação da transação (UTC, ISO 8601).
        created_at_ts:
          type: string
          description: Componente de hora da criação da transação (HH:mm:ss.SSS).
          example: 11:46:38.550
        operation_id:
          type: string
          format: uuid
          description: Identificador da operação relacionada.
        operation:
          type: string
          description: Direção da movimentação.
          enum:
            - credit
            - debit
        type:
          type: string
          description: Tipo da transação. Valores conhecidos incluem inbound_pix,
            outbound_pix, pix_payment, pix_payment_pos, internal, investment e
            generic. Esta lista não é exaustiva.
          example: inbound_pix
        balance_after:
          type: integer
          format: int64
          description: Saldo da conta após a transação, em centavos.
        balance_before:
          type: integer
          format: int64
          description: Saldo da conta antes da transação, em centavos.
        title:
          type: string
          description: "Rótulo principal descrevendo a transação (ex: nome da contraparte)."
        subtitle:
          type: string
          description: 'Descrição secundária (ex: "Transferência | Pix").'
        counterparty_agent:
          $ref: "#/components/schemas/CounterpartyAgent"
```