Payment receipts
WriteWhat it covers#
Every approved charge that goes through the agent produces a receipt with its own code, a page to view it and an image to share. With these two tools you list the receipts for a period and resends one to the customer over WhatsApp.
The receipt is an informational document about the charge. It is not an electronic invoice.
Tools#
List payment receipts
Read onlytilopay_list_receipts
Lists the merchant's latest payment receipts (amount, customer, order and code). Each one includes a text ready to forward to the customer. It does not charge anything.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | integer | — | How many receipts to list (5 by default) |
Returns
{ receipts[] }
receipts = payment receipts with code, amount, currency, customer, order number, payment date, receipt page link and image link.
Resend a payment's receipt to the customer
Writetilopay_send_receipt
Sends the customer the receipt of a charge, by WhatsApp (by default: a one-tap wa.me link) or by email with the merchant's branding (channel=email). It searches by code, order number or customer name; without data it uses the most recent receipt. If the user says 'the last charge' or 'the last receipt', call it directly without code or order_number (do not query transactions first). Use send_now only if the user asks for it to be sent directly by WhatsApp. Never make up the customer's email or phone: if they are missing, ask for them.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
code | string | — | Receipt code (8 characters) |
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 | — | Name of the saved contact or of the customer |
phone | string | — | WhatsApp phone, e.g. +50688887777 |
message | string | — | Your own text to go along with the receipt |
save_contact | boolean | — | Save the contact in the address book |
send_now | boolean | — | true sends the receipt directly to the customer; by default the wa.me link is delivered |
Returns
{ sent | code, page_url, image_url, whatsapp_url }
Resends the receipt to the customer over WhatsApp: it returns the receipt code, its page link, the image link and, when not sent directly, the wa.me link ready to open.
Last verified: 2026-10-07 · Owner: equipo-integraciones