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

# Ver pagamento agendado

> Obtém detalhes de um pagamento agendado específico.



## OpenAPI

````yaml /api-reference/banking/openapi.pt.json get /v1/scheduled-payments/{id}
openapi: 3.1.0
info:
  title: API Conta Digital
  description: API pública para gerenciamento de conta, extrato e operações PIX
  license:
    name: ''
  version: 0.1.0
servers:
  - url: https://conta-public-api.kiwify.com
    description: Production environment
security: []
tags:
  - name: Conta
    description: Detalhes da conta, saldo, limites e chaves PIX
  - name: Extrato
    description: Extrato e histórico de transações
  - name: Enviar Pix
    description: Enviar dinheiro via transferências PIX
  - name: Receber Pix
    description: Reembolsar transações PIX
  - name: Pagar boletos
    description: Pagar boletos via API
  - name: QR Codes PIX
    description: Geração de QR codes PIX para receber pagamentos
  - name: Webhooks
    description: >-
      Gerenciamento de assinaturas de webhook para recebimento de notificações
      de eventos
paths:
  /v1/scheduled-payments/{id}:
    get:
      tags:
        - Extrato
      summary: Ver pagamento agendado
      description: Obtém detalhes de um pagamento agendado específico.
      operationId: get_scheduled_payment_details
      parameters:
        - name: id
          in: path
          description: Scheduled payment identifier
          required: true
          schema:
            type: integer
            format: int64
      responses:
        '200':
          description: Scheduled payment details retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExternalScheduledPaymentDetails'
        '401':
          description: Authentication failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Access denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Scheduled payment not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - AccessId: []
          PoPChallenge: []
          PoPFormat: []
          PoPSignature: []
components:
  schemas:
    ExternalScheduledPaymentDetails:
      type: object
      required:
        - id
        - type
        - status
        - amount_in_cents
        - receiver
        - scheduled_date
        - created_at
        - details
      properties:
        amount_in_cents:
          type: integer
          format: int64
        cancelled_at:
          type:
            - string
            - 'null'
          format: date-time
          description: Cancellation timestamp (UTC, RFC 3339), if cancelled.
          example: '2026-05-28T14:30:00Z'
        created_at:
          type: string
          format: date-time
          description: Record creation timestamp (UTC, RFC 3339).
          example: '2026-05-28T14:30:00Z'
        details:
          $ref: '#/components/schemas/ExternalScheduledPaymentDetailsPayload'
        executed_at:
          type:
            - string
            - 'null'
          format: date-time
          description: Execution timestamp (UTC, RFC 3339). Null until processed.
          example: '2026-05-28T14:30:00Z'
        id:
          type: integer
          format: int64
        receiver:
          type: string
        scheduled_date:
          type: string
          format: date
          description: Scheduled execution date (`YYYY-MM-DD`).
          example: '2026-06-01'
        status:
          $ref: '#/components/schemas/ScheduledPaymentStatus'
        transaction_id:
          type:
            - integer
            - 'null'
          format: int64
        type:
          type: string
          example: pix
        updated_at:
          type:
            - string
            - 'null'
          format: date-time
          description: Last update timestamp (UTC, RFC 3339).
          example: '2026-05-28T14:30:00Z'
    ErrorResponse:
      type: object
      required:
        - error
        - timestamp
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetails'
          description: Error payload.
        timestamp:
          type: string
          format: date-time
          description: ISO 8601 / RFC 3339 UTC timestamp of when the error occurred.
          example: '2026-05-28T14:30:00Z'
    ExternalScheduledPaymentDetailsPayload:
      oneOf:
        - $ref: '#/components/schemas/PixDetails'
          title: PixDetails
        - $ref: '#/components/schemas/BoletoDetails'
          title: BoletoDetails
    ScheduledPaymentStatus:
      type: string
      enum:
        - pending
        - processing
        - executed
        - failed
        - cancelled
    ErrorDetails:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: string
          description: >-
            Machine-readable error code. Use this for branching logic, not
            `message`.
          example: INVALID_REQUEST
        details:
          type: object
          description: >-
            Optional structured details. For `INVALID_REQUEST`, may be an array
            of field validation errors or a `validation_failed` object depending
            on the endpoint.
        message:
          type: string
          description: >-
            Human-readable error description. Do not rely on this text for
            programmatic handling.
    PixDetails:
      type: object
      required:
        - pix_type
        - sender
        - receiver
        - end_to_end_id
      properties:
        end_to_end_id:
          type: string
        message:
          type:
            - string
            - 'null'
        pix_key:
          type:
            - string
            - 'null'
        pix_type:
          type: string
        receiver:
          $ref: '#/components/schemas/PartyInfo'
        sender:
          $ref: '#/components/schemas/PartyInfo'
    BoletoDetails:
      type: object
      required:
        - bar_code
        - inputtable_line
        - sender
        - receiver
        - assignor
      properties:
        assignor:
          type: string
        bar_code:
          type: string
        due_date:
          type:
            - string
            - 'null'
          format: date
          description: Boleto due date (`YYYY-MM-DD`).
          example: '2026-06-01'
        inputtable_line:
          type: string
        receiver:
          $ref: '#/components/schemas/BoletoReceiverInfo'
        sender:
          $ref: '#/components/schemas/PartyInfo'
    PartyInfo:
      type: object
      required:
        - name
        - document
        - bank
        - bank_code
        - account_number
        - account_type
      properties:
        account_number:
          type: string
        account_type:
          $ref: '#/components/schemas/AccountType'
        bank:
          type: string
        bank_code:
          type: string
        document:
          type: string
        name:
          type: string
    BoletoReceiverInfo:
      type: object
      required:
        - name
      properties:
        document:
          type:
            - string
            - 'null'
        name:
          type: string
    AccountType:
      type: string
      enum:
        - checking_account
        - savings_account
        - prepaid_payment_account
        - payment_account
  securitySchemes:
    AccessId:
      type: apiKey
      in: header
      name: x-access-id
      description: UUID of the service account (e.g., 550e8400-e29b-41d4-a716-446655440000)
    PoPChallenge:
      type: apiKey
      in: header
      name: X-PoP-Challenge
      description: >-
        Unix timestamp in milliseconds (e.g., 1704636800000). Must be within 5
        minutes of server time.
    PoPFormat:
      type: apiKey
      in: header
      name: X-PoP-Format
      description: Must be 'service-account' for service account authentication
    PoPSignature:
      type: apiKey
      in: header
      name: X-PoP-Signature
      description: >-
        EdDSA signature of the request in base64 format. Signs:
        uri:method:body:timestamp

````