Saltar al contenido
Docs

Referencia

Listar links de pago

GET/v1/partner/payment-linkspayment-links:read

Lista los links de pago de este partner, paginados por cursor

Propósito

Obtiene todos los links de pago que creaste, incluyendo los vencidos y cancelados. Útil para dashboards o auditoría.

Paginación

  • limit: tamaño de página (máx 50).
  • cursor: valor de nextCursor de la respuesta anterior.
  • Cuando nextCursor es null, ya no hay más páginas.

Nota

shareUrl puede ser null en entorno local/sandbox.

Parámetros de consulta

limit
Tamaño de página. Default 20, tope 100 aplicado en el repositorio.
cursor
Cursor opaco: el `nextCursor` de la página anterior, tal cual. No es un offset y no se interpreta; basura ⇒ 400 CURSOR_INVALID. En la primera página se omite.

Respuesta 200

Links del partner, incluidos los vencidos y cancelados

  • itemsarray de PartnerPaymentLinkDto
    • amountobjeto
      • amountstring

        String decimal de dos decimales; nunca number

        Ejemplo: "1500.00"

      • currencystring

        Ejemplo: "MXN"

    • cancelledAtobjetopuede venir null

      admite null

    • conceptstringpuede venir null

      admite null

      Ejemplo: "Pago de servicio fotográfico"

    • createdAtstring

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

    • expiresAtstringpuede venir null

      admite null

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

    • maxUsesnumber

      Ejemplo: 1

    • ownerUserPublicIdstring

      Dueño de la wallet.

      Ejemplo: "01JKX7PEND0000000000000036"

    • publicIdstring

      Ejemplo: "01JKX7CBRP0000000000000024"

    • shareUrlstringpuede venir null

      URL para compartir por WhatsApp, correo o QR.

      admite null

      Ejemplo: "https://pay.slan.mx/l/abc123"

    • statusenum

      Estado derivado del reloj: un link vencido nunca dice ACTIVE.

      ACTIVEEXHAUSTEDEXPIREDCANCELLED

      Ejemplo: "ACTIVE"

    • usesCountnumber

      Ejemplo: 0

    • walletPublicIdstring

      Wallet asociada al link.

      Ejemplo: "01JKX7MNDR0000000000000037"

  • 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
429RATE_LIMITEDLimite de uso: 120 por minuto por credencial. Respeta la cabecera `Retry-After`.