Skip to main content
PATCH
Actualizar link de pago

Autorizaciones

x-api-key
string
header
requerido

API key del API Gateway de Tapi. Requerida en todas las operaciones. Distinta por ambiente (desarrollo, homologación, producción).

x-authorization-token
string
header
requerido

Token TAPI JWT. Requerido en todas las operaciones. Se envía sin prefijo "Bearer". Ej: x-authorization-token: eyJhbGci...

Parámetros de ruta

id
string
requerido

ID público con prefijo plk_ o el mismo valor sin prefijo.

Ejemplo:

"plk_61a837f5-3c67-423a-ade7-94b78e0007cb"

Cuerpo

application/json
description
string

Nueva descripción (string no vacío; vacía devuelve 400)

Minimum string length: 1
expiresAt
string<date-time>

Nueva fecha de expiración, date-time RFC 3339 en el futuro. null devuelve 400: no se permiten links sin vencimiento. Se guarda en UTC con Z y actualiza también el vencimiento de la deuda asociada a la fecha UTC de expiresAt (ej. 2027-02-10T23:30:00-06:00 hace que la deuda venza el 2027-02-11). Si la deuda asociada ya fue cancelada, solo se actualiza el link.

metadata
object

Nuevos metadatos, objeto plano (reemplaza completamente los existentes). null o un valor que no es objeto devuelve 400.

Respuesta

Link de pago actualizado

data
object

externalPaymentLinkId, expiresAt, successUrl, metadata, identifierValue, contact y product siempre vienen, con null cuando no hay valor.

Ejemplo:
requestId
string