> ## Documentation Index
> Fetch the complete documentation index at: https://docs.azentech.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Enviar posição financeira

> Registra os saldos informados pelo estabelecimento de apostas.

## Comportamento observado

* O Gateway exige os quatro campos e aceita somente valores numéricos não negativos.
* O Gateway não verifica se `total_balance` é a soma dos outros dois valores. Calcule e envie a soma correta.
* Em erros de data, a resposta HTTP é 422 e a chave de erro pode ser `external_timestamp`.

> [!NOTE]
>
> Os exemplos usam identificadores e credenciais sintéticos. Os resultados do processador dependem do credenciamento e da configuração do estabelecimento.


## OpenAPI

````yaml openapi.json POST /api/merchant/report_financial_info
openapi: 3.1.0
info:
  title: Azentech Payments API
  version: 1.0.0
  description: >-
    Contrato HTTP público das operações de pagamento, consulta, sandbox e
    webhooks da Azentech. A especificação contém apenas o ambiente de
    homologação confirmado.
servers:
  - url: https://gateway.staging.azentech.dev
    description: Homologação (staging)
security: []
tags:
  - name: Pix
    description: Cobranças, pagamentos, aportes, retiradas e jornada biométrica.
  - name: Transações
    description: Consulta e reembolso de transações.
  - name: Saldos
    description: Saldos atuais, históricos e resumo financeiro.
  - name: Relatórios
    description: Extrato e posição financeira.
  - name: Sandbox
    description: Simulações disponíveis para processadores elegíveis em modo de teste.
paths:
  /api/merchant/report_financial_info:
    post:
      tags:
        - Relatórios
      summary: Enviar posição financeira
      description: Registra os saldos informados pelo estabelecimento de apostas.
      operationId: reference_reports_financial-info
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              properties:
                players_total_balance:
                  type: number
                  description: Saldo total dos jogadores em reais.
                  minimum: 0
                open_bets_balance:
                  type: number
                  description: Total em apostas abertas em reais.
                  minimum: 0
                total_balance:
                  type: number
                  description: Saldo total informado em reais.
                  minimum: 0
                timestamp:
                  type: string
                  description: >-
                    Data e hora UTC. O Gateway converte esta entrada para
                    external_timestamp.
                  format: date-time
                  pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$
              required:
                - players_total_balance
                - open_bets_balance
                - total_balance
                - timestamp
            example:
              players_total_balance: 1000
              open_bets_balance: 250
              total_balance: 1250
              timestamp: '2026-10-23T14:30:00Z'
      responses:
        '200':
          description: Posição registrada.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    const: Financial info received successfully.
                required:
                  - message
              example:
                message: Financial info received successfully.
        '401':
          description: Token ausente, inválido ou sem acesso.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GatewayError'
              example:
                error:
                  message:
                    base:
                      - Not authenticated
                  status: 401
        '422':
          description: Dados inválidos.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationError'
              example:
                message: The given data was invalid.
                errors:
                  external_timestamp:
                    - >-
                      The external timestamp field must be in the format Y-m-d
                      H:i:s.
        '500':
          description: Falha interna ou falha não traduzida do processador.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GatewayError'
              example:
                error:
                  message:
                    fatal: >-
                      Something went wrong. Please refer to support with the
                      following code: 0000000000
                  status: 500
      security:
        - BearerAuth: []
components:
  schemas:
    GatewayError:
      type: object
      additionalProperties: false
      properties:
        error:
          type: object
          additionalProperties: false
          properties:
            message:
              oneOf:
                - type: string
                - type: object
                  additionalProperties:
                    oneOf:
                      - type: string
                      - type: array
                        items:
                          type: string
              description: Mensagem simples ou mapa de campos para listas de mensagens.
            status:
              type: integer
              description: Código HTTP devolvido.
          required:
            - message
            - status
      required:
        - error
    ValidationError:
      type: object
      additionalProperties: false
      properties:
        message:
          type: string
          description: Resumo da falha de validação.
        errors:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
      required:
        - message
        - errors
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: token
      description: Token de acesso fornecido para o estabelecimento.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.