# Payment receipts

> MCP tools to list receipts of approved charges and resend a customer the receipt for their payment.

- kind: mcp-tool
- status: stable
- access: write
- last_verified: 2026-10-07
- url: https://tilopay.com/en/developers/agentes/mcp/comprobantes

## What it covers [#que-cubre]

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 [#herramientas]

### List payment receipts [#tilopay-list-receipts]

- `tilopay_list_receipts`
- Access: Read only

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 [#tilopay-send-receipt]

- `tilopay_send_receipt`
- Access: Write

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 | — | Order number of the charge |
| `client_name` | string | — | Name of the charge's customer, to find the receipt |
| `channel` | string (whatsapp | email) | — | whatsapp (default) or email |
| `email` | string | — | Customer email, if sending by email |
| `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.