Comprobantes de cobro

Escritura

Qué cubre#

Cada cobro aprobado que pasa por el agente genera un comprobante con su propio código, una página para verlo y una imagen para compartir. Con estas dos herramientas el comercio lista los comprobantes de un período y reenvía uno al cliente por WhatsApp.

El comprobante es un documento informativo del cobro. No es una factura electrónica.

Herramientas#

Listar comprobantes de cobro

Sólo lectura

tilopay_list_receipts

Lista los últimos comprobantes de cobro del comercio (monto, cliente, orden y código). Cada uno trae un texto listo para reenviar al cliente. No cobra nada.

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
`limit`	integer	—	Cuántos comprobantes listar (5 por defecto)

Devuelve

{ receipts[] }

receipts = comprobantes de cobro con código, monto, moneda, cliente, número de orden, fecha de pago, enlace de la página del comprobante y enlace de la imagen.

Reenviar el comprobante de un cobro al cliente

Escritura

tilopay_send_receipt

Envía al cliente el comprobante de un cobro, por WhatsApp (por defecto: enlace wa.me de un toque) o por correo con la marca del comercio (channel=email). Busca por código, número de orden o nombre del cliente; sin datos usa el comprobante más reciente. Si el usuario dice «el último cobro» o «el último comprobante», llámala directamente sin code ni order_number (no consultes transacciones antes). Usa send_now solo si el usuario pide que se envíe directamente por WhatsApp. Nunca inventes el correo ni el teléfono del cliente: si faltan, pídelos.

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
`code`	string	—	Código del comprobante (8 caracteres)
`order_number`	string	—	Número de orden del cobro
`client_name`	string	—	Nombre del cliente del cobro, para buscar el comprobante
`channel`	string (whatsapp \| email)	—	whatsapp (por defecto) o email
`email`	string	—	Correo del cliente, si se envía por correo
`contact_name`	string	—	Nombre del contacto guardado o del cliente
`phone`	string	—	Teléfono de WhatsApp, ej. +50688887777
`message`	string	—	Texto propio para acompañar el comprobante
`save_contact`	boolean	—	Guardar el contacto en la agenda
`send_now`	boolean	—	true envía el comprobante directamente al cliente; por defecto se entrega el enlace wa.me

Devuelve

{ sent | code, page_url, image_url, whatsapp_url }

Reenvía el comprobante al cliente por WhatsApp: devuelve el código del comprobante, el enlace de su página, el de la imagen y, cuando no se envía directo, el enlace de WhatsApp listo para abrir.

Última verificación: 2026-10-07 · Responsable: equipo-integraciones

Ver como Markdown crudo