Liquidaciones, depósitos y facturación
EscrituraQué cubre#
Este grupo cubre el dinero que Tilopay le liquida al comercio: el balance por liquidar y la fecha del próximo depósito, las liquidaciones ya procesadas con sus transacciones, los depósitos de garantía (preautorizaciones retenidas a clientes) y las facturas que Tilopay emite por el uso de la plataforma. Todo es de lectura salvo extender un depósito de garantía, que exige un código de seis dígitos que llega por correo.
Herramientas#
Próxima liquidación y balance por liquidar
Sólo lecturatilopay_settlement_balance
Dato OFICIAL de Tilopay: fecha del próximo depósito (next_settlement), frecuencia de liquidación, cuenta IBAN destino y, por moneda, el balance acumulado pendiente con su desglose (subtotal, commission, iva_commission, retention, retention_iva, cost, iva_tilopay, transfer, transfer_iva, total neto). Úsala para «¿cuándo me depositan?», «¿cuánto me van a liquidar?», «¿cuánto me cobran de comisión?».
Parámetros
Sin parámetros.
Devuelve
Historial de liquidaciones
Sólo lecturatilopay_settlements_list
Liquidaciones ya procesadas por Tilopay: fecha de depósito (date_to_report), periodo, monto bruto, deducciones y total transferido. Úsala para «¿ya me depositaron lo del viernes?» o «¿cuánto me depositaron el mes pasado?».
Parámetros
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
page | integer | — | Página (por defecto 1) |
limit | integer | — | Registros por página (por defecto 20) |
search | string | — | Texto a buscar |
Devuelve
Transacciones de una liquidación
Sólo lecturatilopay_settlement_transactions
Transacciones incluidas en una liquidación ya procesada (id obtenido de tilopay_settlements_list).
Parámetros
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
settlement_id | string | sí | Id de la liquidación |
Devuelve
Depósitos de garantía (preautorizaciones)
Sólo lecturatilopay_deposits_list
Depósitos de garantía o preautorizaciones retenidas a clientes (renta de autos, hotelería, depósitos de seguridad): monto, estado y vencimiento. No confundir con liquidaciones.
Parámetros
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
page | integer | — | Página (por defecto 1) |
limit | integer | — | Registros por página (por defecto 20) |
search | string | — | Texto a buscar |
Devuelve
Detalle de un depósito de garantía
Sólo lecturatilopay_deposit_detail
Detalle de un depósito de garantía (id de tilopay_deposits_list).
Parámetros
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
deposit_id | string | sí | Id del depósito |
Devuelve
Extender un depósito de garantía
Escrituratilopay_deposit_extend
Extiende la vigencia de la autorización de un depósito de garantía. Requiere el código de seis dígitos que llega por correo.
Parámetros
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
deposit_id | string | sí | Id del depósito |
Devuelve
Facturas del servicio Tilopay
Sólo lecturatilopay_billing_list
Facturas que Tilopay le emite al comercio por el uso de la plataforma (no son ventas del comercio). Úsala para «¿cuánto me cobró Tilopay este mes?» o «¿dónde está mi factura de Tilopay?».
Parámetros
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
page | integer | — | Página (por defecto 1) |
limit | integer | — | Registros por página (por defecto 20) |
search | string | — | Texto a buscar |
Devuelve
Última verificación: 2026-10-07 · Responsable: equipo-integraciones