Actualizar Link de pago

patch

https://api.akua.la/v1/links/{link_id}

Actualiza la información de un link de pago existente. Permite modificar campos como descripción, URLs de redirección, metadata, y otros datos configurables. IMPORTANTE: No todos los campos son actualizables; campos como 'type', 'merchant_id' y 'amount' generalmente son inmutables después de la creación. Este endpoint requiere el header 'Client-Id' para validar permisos de actualización. Soporta dos formatos de request: JSON simple para actualizaciones de datos, y multipart/form-data cuando se necesitan subir archivos adjuntos (útil para links de onboarding que requieren documentación).

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

link_id

string

required

Identificador del link de pago a actualizar. Los identificadores comienzan con el prefijo 'pl-'.

Body Params

metadata

object

Metadata personalizada a actualizar o agregar. Este objeto se fusiona con la metadata existente. Para eliminar una clave, envía su valor como null.

data

object

Objeto con los datos específicos del link a actualizar. Puede contener cualquier campo del tipo de link.

status

string

enum

Estado del link. Valores posibles: 'created' (recién creado), 'opened' (abierto pero no usado), 'used' (completado), 'expired' (expirado).

Allowed:

type

string

enum

Tipo de link. Normalmente no se modifica después de la creación.

Allowed:

attachments

array of objects

Array de archivos adjuntos asociados al link. Cada elemento contiene información sobre un archivo subido.

attachments

Headers

Client-Id

string

required

Identificador del cliente que solicita la actualización. REQUERIDO para validar que el cliente tiene permisos para modificar este link. Los IDs de cliente comienzan con 'cli-'.

Responses

Language

Credentials

OAuth2

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Link actualizado exitosamente

400Error en la solicitud. Puede ocurrir por datos inválidos, formato incorrecto, o archivos demasiado grandes (máximo 10MB por archivo, 32MB total).

403Acceso no autorizado. El Client-Id proporcionado no tiene permisos para actualizar este link. Solo el cliente que creó el link puede modificarlo.

410Link expirado. El link ha alcanzado su fecha de expiración y no puede ser actualizado. Los links expirados son inmutables.

500Error interno del servidor.