Skip to main content
GET
/
api
/
payment-requests
/
summary
Resumen agregado por período
curl --request GET \
  --url https://api.tupana.ai/api/payment-requests/summary/ \
  --header 'Authorization: <api-key>'
{
  "period": {
    "from": "2026-04-01",
    "to": "2026-04-30"
  },
  "total_gross": 600000,
  "total_fees": 18000,
  "total_net": 582000,
  "transaction_count": 12,
  "currency": "CLP"
}

​
¿Para qué se usa?

Retorna los totales agregados de cobros para un período de fechas dado. Evita tener que paginar y sumar del lado del cliente.

​
Qué hace

  • Calcula automáticamente la suma de montos brutos, comisiones de Tu Pana y montos netos.
  • Retorna el conteo de transacciones pagadas en el período.
  • Soporta filtro por recipient_id para obtener el resumen de un destinatario específico.

​
Ejemplos de uso

  • Liquidación mensual: Obtener el resumen del mes para mostrárselo a un profesional o empresa.
  • Dashboard de recaudación: Calcular las métricas del período actual para tu panel de control.
  • Cierre de período: Verificar los totales antes de generar reportes o conciliaciones.

Authorizations

​
Authorization
string
header
required

API Key para autenticación. Formato: Api-Key YOUR-API-KEY

Query Parameters

​
recipient_id
string

Filtrar por ID del destinatario.

​
from
string<date>
required

Fecha de inicio del período (YYYY-MM-DD).

Example:

"2026-04-01"

​
to
string<date>
required

Fecha de fin del período (YYYY-MM-DD, inclusiva).

Example:

"2026-04-30"

Response

Resumen del período

​
period
object
​
total_gross
integer

Suma de montos brutos cobrados.

Example:

600000

​
total_fees
integer

Suma de comisiones de Tu Pana.

Example:

18000

​
total_net
integer

Suma de montos netos depositados.

Example:

582000

​
transaction_count
integer

Número de cobros pagados en el período.

Example:

12

​
currency
string
Example:

"CLP"