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

# Obtener un cobro de Pix Automático

> Recupera un único cobro por id. Limitado al pagador autenticado: un cobro de otro pagador se reporta como no encontrado. La respuesta incluye el arreglo de intentos saneado; el código de resultado del débito interno nunca se expone.



## OpenAPI

````yaml es/openapi/v3-current/indirect-pix.yaml GET /v1/recurrences/payer/charges/{id}
openapi: 3.0.3
info:
  title: Plugin BR Pix Indirect - API completa
  description: |
    API completa para el sistema de pagos instantáneos Pix de Brasil, que
    incluye operaciones del diccionario de claves Pix, generación/decodificación
    de códigos QR, transacciones y límites transaccionales.
  version: 1.7.6
servers:
  - url: https://plugin-pix-indirect.api.lerian.net
security:
  - bearerAuth: []
paths:
  /v1/recurrences/payer/charges/{id}:
    get:
      tags:
        - Pix Automático API
      summary: Obtener un cobro de Pix Automático
      description: >-
        Recupera un único cobro por id. Limitado al pagador autenticado: un
        cobro de otro pagador se reporta como no encontrado. La respuesta
        incluye el arreglo de intentos saneado; el código de resultado del
        débito interno nunca se expone.
      parameters:
        - $ref: '#/components/parameters/XAccountId'
        - name: id
          in: path
          description: ID del cobro (formato UUID)
          required: true
          schema:
            type: string
          example: 019cf6ef-e418-7ced-80c0-7b9816faa798
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChargeOutput'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
      security:
        - bearerAuth: []
components:
  parameters:
    XAccountId:
      name: X-Account-Id
      in: header
      description: Identificador único de la cuenta del Ledger de Midaz (formato UUID).
      required: true
      example: 019c96a0-0a98-7287-9a31-786e0809c769
      schema:
        type: string
  schemas:
    ChargeOutput:
      properties:
        accountId:
          example: 019cf6ef-e418-7ced-80c0-7b9816faa798
          type: string
        amount:
          example: '29.90'
          type: string
        attemptCount:
          type: integer
          example: 1
        attempts:
          items:
            $ref: '#/components/schemas/ChargeAttemptOutput'
          type: array
        authorizationId:
          example: 019cf6ef-e418-7ced-80c0-7b9816faa798
          type: string
        authorizationRequestId:
          example: 019cf6ef-e418-7ced-80c0-7b9816faa798
          type: string
        cancelledAt:
          format: date-time
          type: string
        createdAt:
          format: date-time
          type: string
        currentDayIndex:
          type: integer
          example: 0
        currentScheduleId:
          example: 019cf6ef-e418-7ced-80c0-7b9816faa798
          type: string
        dueDate:
          example: '2026-04-25'
          format: date
          type: string
        executedAt:
          format: date-time
          type: string
        externalChargeId:
          example: 90d0b9e1551447f695985409bf9b7fb5
          type: string
        failedAt:
          format: date-time
          type: string
        failureCode:
          description: >-
            FailureCode es el código genérico que preserva la privacidad,
            reportado al receptor para el resultado actual del cobro (p. ej.
            CHARGE_REJECTED, OVER_LIMIT, ACCEPTED, DEBIT_FAILED). Es el ÚNICO
            código expuesto en la API de lectura y en el payload saliente; el
            motivo financiero interno nunca se incluye aquí.
          example: CHARGE_REJECTED
          type: string
        id:
          example: 019cf6ef-e418-7ced-80c0-7b9816faa798
          type: string
        journey:
          enum:
            - J1
            - J2
            - J3
            - J4
          example: J4
          type: string
        maxAttempts:
          example: 4
          type: integer
        recurrenceId:
          example: 019cf6ef-e418-7ced-80c0-7b9816faa798
          type: string
        status:
          enum:
            - RECEIVED
            - SCHEDULED
            - EXECUTED
            - FAILED
            - CANCELLED
          example: SCHEDULED
          type: string
        updatedAt:
          format: date-time
          type: string
      type: object
    ErrorFormat:
      type: object
      description: El mensaje de error de la respuesta.
      required:
        - code
        - title
        - message
      properties:
        code:
          type: string
          description: Un identificador único y estable para el error.
        title:
          type: string
          description: Un breve resumen del problema.
        message:
          type: string
          description: Orientación detallada para resolver el error.
    ChargeAttemptOutput:
      properties:
        attemptedAt:
          description: >-
            AttemptedAt es el instante en que se observó el resultado del
            intento: el instante canónico del intento, en ISO 8601 UTC. Se omite
            mientras el intento sigue abierto (aún no se observó un resultado
            terminal). Distinto de ScheduledFor, el instante de disparo
            planificado.
          format: date-time
          type: string
        dayIndex:
          type: integer
          example: 0
        endToEndId:
          description: >-
            EndToEndID es el id end-to-end del cashout generado para este
            intento, usado para conciliar la liquidación. Se omite para un
            intento heredado que no lo tiene.
          example: E30306294202606241200abcdef00001
          type: string
        failureCode:
          description: >-
            FailureCode es el código que preserva la privacidad ya reportado al
            receptor para este intento (p. ej. DEBIT_FAILED). Vacío cuando aún
            no se reportó nada. El motivo financiero interno nunca se incluye
            aquí.
          example: DEBIT_FAILED
          type: string
        failureMessage:
          description: >-
            FailureMessage es una descripción general y segura para el canal del
            resultado. Nunca revela el código de resultado interno.
          example: The debit attempt could not be completed.
          type: string
        outcome:
          enum:
            - EXECUTED
            - FAILED
            - CANCELLED
          example: EXECUTED
          type: string
        scheduleId:
          example: 019cf6ef-e418-7ced-80c0-7b9816faa798
          type: string
        scheduledFor:
          example: '2026-04-24T03:00:00Z'
          format: date-time
          type: string
      type: object
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````