Saltar al contenido
Docs

Referencia

Pagos de un link

GET/v1/partner/payment-links/{publicId}/paymentspayment-links:read

Pagos realizados contra un link: quién pagó, con qué tarjeta, cuánto y cuándo

Propósito

Obtiene la trazabilidad completa de los pagos realizados contra un link de pago. Este es el endpoint que responde a la pregunta: ¿quién pagó y cómo?

Datos de tarjeta

Los campos cardBrand, cardBin y cardLastFour solo se llenan cuando payerType es EXTERNAL. Para pagadores SLAN esos campos son null.

Paginación

  • limit: máx 50 por página.
  • cursor / nextCursor: misma lógica que los demás endpoints.

Seguridad

Un link de otro partner responde 404.

Parámetros de ruta

publicId
El link del que se quieren ver los pagos. ULID de 26 caracteres; ajeno o inexistente ⇒ 404 (nunca 403: un 403 confirmaría que existe). Ejemplo: 01JKX7CBRP0000000000000024

Parámetros de consulta

limit
cursor
Cursor opaco del `nextCursor` de la respuesta anterior; en la primera página se omite.

Respuesta 200

Pagos contra el link. Datos de tarjeta solo en pagadores EXTERNAL.

  • itemsarray de PartnerPaymentDto
    • amountobjeto
      • amountstring

        String decimal de dos decimales; nunca number

        Ejemplo: "1500.00"

      • currencystring

        Ejemplo: "MXN"

    • cardBinstringpuede venir null

      Primeros 6-8 dígitos de la tarjeta (BIN). Solo para pagadores externos.

      admite null

      Ejemplo: "411111"

    • cardBrandstringpuede venir null

      Marca de la tarjeta. Solo para pagadores externos.

      admite null

      Ejemplo: "VISA"

    • cardLastFourstringpuede venir null

      Últimos 4 dígitos de la tarjeta. Solo para pagadores externos.

      admite null

      Ejemplo: "4242"

    • paidAtstring

      Ejemplo: "2026-09-04T15:04:05.000Z"

    • payerEmailstringpuede venir null

      admite null

      Ejemplo: "juan.garcia@example.com"

    • payerNamestringpuede venir null

      admite null

      Ejemplo: "Juan García"

    • payerTypeenum

      Tipo de pagador: EXTERNAL (tarjeta) o SLAN_USER (transferencia interna).

      EXTERNALSLAN_USER

      Ejemplo: "EXTERNAL"

    • paymentMethodenum

      Método de pago.

      CARDSLAN_BALANCE

      Ejemplo: "CARD"

    • publicIdstring

      Ejemplo: "01JKX7PYMT0000000000000023"

    • statusenum

      PENDINGCOMPLETEDFAILED

      Ejemplo: "COMPLETED"

  • nextCursorobjetopuede venir null

    admite null

Errores

EstadoCódigosCuándo
401sin codeSin x-api-key válida
403sin codeLa llave no tiene el scope payment-links:read
404LINK_NOT_FOUNDError con code: LINK_NOT_FOUND
429RATE_LIMITEDLimite de uso: 120 por minuto por credencial. Respeta la cabecera `Retry-After`.