Cancelar un link

POST/v1/partner/payment-links/{publicId}/cancelpayment-links:write

Cancela un link de pago. Un link cancelado ya no se puede pagar.

Propósito

Revoca un link de pago para que ya no acepte nuevos pagos. Si alguien intenta abrir el link después de cancelarlo, verá un mensaje de “no encontrado”.

Comportamiento especial

Pagos previos no se afectan: si alguien ya pagó antes de la cancelación, ese pago sigue siendo válido.
Cancelar un link ya cancelado responde 409 LINK_ALREADY_CANCELLED.
No requiere Idempotency-Key porque cancelar es naturalmente idempotente (cancelar dos veces da el mismo resultado).

Errores comunes

Código	Error	Causa	Solución
`404`	`LINK_NOT_FOUND`	El link no existe o no es tuyo	Verifica el `publicId`
`409`	`LINK_ALREADY_CANCELLED`	Ya fue cancelado antes	No necesitas hacer nada más

Parámetros de ruta

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

Respuesta 200

Link cancelado. Los pagos previos no se afectan.

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"

Errores

Estado	Códigos	Cuándo
`401`	sin code	Sin x-api-key válida
`403`	sin code	La llave no tiene el scope payment-links:write
`404`	`LINK_NOT_FOUND`	Error con code: LINK_NOT_FOUND
`409`	`LINK_ALREADY_CANCELLED`	Error con code: LINK_ALREADY_CANCELLED
`429`	`RATE_LIMITED`	Limite de uso: 120 por minuto por credencial. Respeta la cabecera `Retry-After`.