Comprobantes de cobro
EscrituraQué 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 lecturatilopay_list_receipts
Lista los últimos comprobantes de cobro del comercio (monto, cliente, orden y código). Cada uno tiene una imagen lista 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
Escrituratilopay_send_receipt
Prepara el reenvío del comprobante de un cobro por WhatsApp: devuelve un enlace wa.me con el mensaje y la imagen del comprobante ya listos. Si no se indica el código, usa el comprobante más reciente. Use send_now solo si el usuario pide que se envíe directamente.
Parámetros
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | string | — | Código del comprobante (8 caracteres) |
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-09-14 · Responsable: equipo-integraciones