Liquidaciones, depósitos y facturación

Escritura

Qué 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 lectura

tilopay_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 lectura

tilopay_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ámetroTipoObligatorioDescripción
pageinteger—Página (por defecto 1)
limitinteger—Registros por página (por defecto 20)
searchstring—Texto a buscar

Devuelve

Transacciones de una liquidación

Sólo lectura

tilopay_settlement_transactions

Transacciones incluidas en una liquidación ya procesada (id obtenido de tilopay_settlements_list).

Parámetros

ParámetroTipoObligatorioDescripción
settlement_idstringsíId de la liquidación

Devuelve

Depósitos de garantía (preautorizaciones)

Sólo lectura

tilopay_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ámetroTipoObligatorioDescripción
pageinteger—Página (por defecto 1)
limitinteger—Registros por página (por defecto 20)
searchstring—Texto a buscar

Devuelve

Detalle de un depósito de garantía

Sólo lectura

tilopay_deposit_detail

Detalle de un depósito de garantía (id de tilopay_deposits_list).

Parámetros

ParámetroTipoObligatorioDescripción
deposit_idstringsíId del depósito

Devuelve

Extender un depósito de garantía

Escritura

tilopay_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ámetroTipoObligatorioDescripción
deposit_idstringsíId del depósito

Devuelve

Facturas del servicio Tilopay

Sólo lectura

tilopay_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ámetroTipoObligatorioDescripción
pageinteger—Página (por defecto 1)
limitinteger—Registros por página (por defecto 20)
searchstring—Texto a buscar

Devuelve

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

Ver como Markdown crudo