Enlaces de pago

Irreversible

Qué 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#

Crear enlace de pago

Escritura

tilopay_create_payment_link

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

Operación del API: POST /api/v1/createLinkPayment — ver la página de la operación

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

Sólo lectura

tilopay_get_payment_link

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

Operación del API: GET /api/v1/getDetailLinkPayment/{link_payment_id}/{api_key} — ver la página de la operación

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

Sensible

tilopay_delete_payment_link

Elimina un enlace de pago por su ID.

Operación del API: POST /api/v1/deleteLinkPayment — ver la página de la operación

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

Escritura

tilopay_send_payment_link_whatsapp

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

Escritura

tilopay_send_payment_link_email

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.

Última verificación: 2026-08-29 · Responsable: equipo-integraciones

Ver como Markdown crudo