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

# Listar pagos del link

> Devuelve los pagos recibidos a través de un link de pago.



## OpenAPI

````yaml /api-reference/openapi.yaml get /payment-links/{id}/payments
openapi: 3.0.0
info:
  title: TapiPay Facade API
  version: 1.0.0
  description: >
    Facade API pública de la plataforma de cobranzas TapiPay.  Ofrece un
    contrato limpio y desacoplado del modelo interno del OFU,  permitiendo a los
    clientes crear y gestionar cobros (deudas puntuales,  suscripciones
    recurrentes, links de pago, productos y contactos)  sin conocer detalles
    internos de Company, Modalities o GenerationData.
  contact:
    name: TapiPay Team
    url: https://www.tapipay.com
  license:
    name: Proprietary
servers:
  - url: https://tapipay-facade.dev.tapila.cloud
    description: Desarrollo
security:
  - apiKeyAuth: []
    tapiAuth: []
paths:
  /payment-links/{id}/payments:
    get:
      tags:
        - Payment Links
      summary: Listar pagos del link
      description: Devuelve los pagos recibidos a través de un link de pago.
      operationId: getPaymentLinkPayments
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            pattern: ^plk_[a-zA-Z0-9]+$
        - name: page
          in: query
          schema:
            type: integer
            default: 1
            minimum: 1
        - name: limit
          in: query
          schema:
            type: integer
            default: 50
            minimum: 1
            maximum: 500
      responses:
        '200':
          description: Lista de pagos del link (deudas OFU bajo el identifier del link)
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Payment'
                  meta:
                    $ref: '#/components/schemas/PaginationMeta'
                  requestId:
                    type: string
        '401':
          description: No autenticado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Link de pago no encontrado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Payment:
      type: object
      required:
        - paymentId
        - amount
        - amountPaid
        - currency
        - status
        - createdAt
      properties:
        paymentId:
          type: string
          description: >-
            ID único del pago recibido (en OFU términología, es una deuda pagada
            o parcialmente pagada)
        amount:
          type: number
          description: Monto del pago en pesos (hasta 2 decimales)
        amountPaid:
          type: number
          description: Monto pagado acumulado en pesos (desde la creación de la deuda)
        currency:
          $ref: '#/components/schemas/Currency'
        status:
          $ref: '#/components/schemas/DebtStatus'
          description: >-
            Estado de la deuda asociada (PENDING, PARTIALLY_PAID, PAID, OVERDUE,
            CANCELLED)
        createdAt:
          type: string
          format: date-time
          description: Timestamp de creación del pago (ISO 8601)
    PaginationMeta:
      type: object
      required:
        - page
        - limit
        - total
        - hasMore
      properties:
        page:
          type: integer
          minimum: 1
        limit:
          type: integer
          minimum: 1
          maximum: 500
        total:
          type: integer
          minimum: 0
        hasMore:
          type: boolean
        capped:
          type: boolean
          description: >
            Indica si el total está truncado por cap interno. Cuando es true, la
            cantidad exacta de resultados no se puede determinar (el cursor fue
            alcanzado antes de iterar  toda la colección). El cliente debe
            asumir que hasMore puede seguir siendo true incluso si llega a este
            límite. Se usa para prevenir queries scans costosos.
          default: false
    Error:
      type: object
      required:
        - error
        - requestId
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              enum:
                - INVALID_REQUEST
                - AUTHENTICATION_FAILED
                - RESOURCE_NOT_FOUND
                - RESOURCE_CONFLICT
                - RESOLUTION_ERROR
                - BUSINESS_RULE_VIOLATION
                - RATE_LIMITED
                - INTERNAL_ERROR
              description: Código de error estándar
            message:
              type: string
              description: Mensaje legible del error
            details:
              type: array
              description: Array de detalles adicionales (validaciones por campo, etc.)
              items:
                type: object
                properties:
                  field:
                    type: string
                  issue:
                    type: string
        requestId:
          type: string
          pattern: ^req_[a-zA-Z0-9]+$
          description: ID único del request para trazabilidad
    Currency:
      type: string
      enum:
        - MXN
        - ARS
        - PEN
        - COP
        - CLP
        - USD
      default: MXN
      description: >
        Código de moneda ISO 4217. Whitelist de monedas aceptadas por la Facade.
        Si no se envía, se usa el default de la organización (fallback: MXN). Si
        se envía un valor fuera de este whitelist, la Facade devuelve 400
        INVALID_REQUEST.
    DebtStatus:
      type: string
      enum:
        - PENDING
        - PARTIALLY_PAID
        - PAID
        - OVERDUE
        - CANCELLED
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >
        API key del API Gateway de Tapi. Requerida en todas las operaciones.
        Distinta por ambiente (desarrollo, homologación, producción).
    tapiAuth:
      type: apiKey
      in: header
      name: x-authorization-token
      description: >
        Token TAPI JWT. Requerido en todas las operaciones. Se envía sin prefijo
        "Bearer". Ej: x-authorization-token: eyJhbGci...

````