# Enlaces de pago

> Herramientas del MCP para crear, consultar y borrar enlaces de pago, y preparar su envío.

- kind: mcp-tool
- status: stable
- access: destructive
- last_verified: 2026-08-29
- url: https://www.tilopay.com/developers/agentes/mcp/enlaces-de-pago

## Qué cubre [#que-cubre]

Con este grupo el agente crea un enlace de cobro, consulta su detalle, lo borra y prepara el envío al cliente por WhatsApp o por correo. El envío por WhatsApp no manda el mensaje: devuelve un enlace listo para enviar.

## Herramientas [#herramientas]

### Crear enlace de pago [#tilopay-create-payment-link]

- `tilopay_create_payment_link`
- Acceso: Escritura
- Operación del API: `POST /api/v1/createLinkPayment` — https://www.tilopay.com/developers/api/links-de-pago/create-link-payment

Crea un enlace de pago para cobrar un monto específico.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `amount` | number | sí | Monto a cobrar, mayor que cero |
| `reference` | string | sí | Referencia interna del cobro |
| `description` | string | sí | Descripción del cobro |
| `currency` | string | — | Moneda, ej. USD o CRC (por defecto USD) |
| `client` | string | — | Nombre del cliente |
| `client_email` | string | — | Correo del cliente |
| `client_phone` | string | — | Teléfono del cliente |
| `type` | integer | — | Tipo de enlace (0 por defecto) |
| `callback_url` | string | — | URL de retorno tras el pago |
| `webhook_url` | string | — | URL de webhook de notificación |

**Devuelve**

`{ result, linkId, url }`

result es la respuesta cruda; linkId y url son el id y la URL del enlace ya extraídos. Si no se envía webhook_url, el servidor pone uno propio para poder avisar cuando se pague.

### Detalle de un enlace de pago [#tilopay-get-payment-link]

- `tilopay_get_payment_link`
- Acceso: Sólo lectura
- Operación del API: `GET /api/v1/getDetailLinkPayment/{link_payment_id}/{api_key}` — https://www.tilopay.com/developers/api/links-de-pago/detail-link-payment

Obtiene el detalle de un enlace de pago por su ID.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `linkPaymentId` | string | sí | ID del enlace de pago |

**Devuelve**

`{ result }`

Respuesta cruda del API de Tilopay bajo la llave `result`.

### Eliminar enlace de pago [#tilopay-delete-payment-link]

- `tilopay_delete_payment_link`
- Acceso: Sensible
- Operación del API: `POST /api/v1/deleteLinkPayment` — https://www.tilopay.com/developers/api/links-de-pago/delete-link-payment

Elimina un enlace de pago por su ID.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `id` | string | sí | ID del enlace de pago a eliminar |

**Devuelve**

`{ result }`

Respuesta cruda del API de Tilopay bajo la llave `result`.

### Enviar enlace de pago por WhatsApp [#tilopay-send-payment-link-whatsapp]

- `tilopay_send_payment_link_whatsapp`
- Acceso: Escritura

Prepara el envío del enlace de pago por WhatsApp: devuelve un enlace wa.me con el mensaje listo. Acepta el nombre de un contacto guardado o un teléfono.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `link_url` | string | sí | URL del enlace de pago |
| `contact_name` | string | — | Nombre del contacto guardado o del cliente |
| `phone` | string | — | Teléfono de WhatsApp, ej. +50688887777 |
| `amount` | number | — | — |
| `currency` | string | — | — |
| `description` | string | — | — |
| `message` | string | — | Texto propio del mensaje |
| `save_contact` | boolean | — | Guardar el contacto en la agenda |
| `send_now` | boolean | — | Obsoleto: se ignora. Siempre se devuelve el enlace wa.me. (obsoleto) |

**Devuelve**

`{ to, message, whatsapp_url }`

No envía el mensaje: devuelve el teléfono resuelto, el texto ya redactado y un enlace wa.me para enviarlo con un toque. Si no hay teléfono ni contacto guardado con ese nombre, devuelve error pidiéndolo. Guarda el contacto salvo que save_contact sea false.

### Enviar enlace de pago por correo [#tilopay-send-payment-link-email]

- `tilopay_send_payment_link_email`
- Acceso: Escritura

Envía el enlace de pago por correo electrónico al cliente. Acepta el nombre de un contacto guardado o un correo.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `link_url` | string | sí | URL del enlace de pago |
| `email` | string | — | Correo del destinatario |
| `contact_name` | string | — | Nombre del contacto guardado o del cliente |
| `amount` | number | — | — |
| `currency` | string | — | — |
| `description` | string | — | — |
| `message` | string | — | Nota adicional para el cliente |
| `save_contact` | boolean | — | Guardar el contacto en la agenda |

**Devuelve**

`{ sent, to }`

sent es true y to el correo al que se envió. Si no hay correo ni contacto guardado con ese nombre, devuelve error pidiéndolo.