Transactions API

Consulta las transacciones de tu cuenta. Cada vez que se recibe una transferencia bancaria (ya sea por un pago único o un cliente fijo), se genera una transacción.

Listar transacciones


GET https://api.talo.com.ar/transactions/

Sandbox


GET https://sandbox-api.talo.com.ar/transactions/

Requiere Authorization: Bearer header.

Query parameters

Campo	Tipo	Requerido	Descripción
`user_id`	`string`	Sí	ID del usuario cuyas transacciones se quieren listar
`team_id`	`string`	No	Filtrar por equipo
`limit`	`string`	No	Cantidad de resultados por página (numérico)
`start_date`	`string`	No	Fecha de inicio (ISO 8601)
`end_date`	`string`	No	Fecha de fin (ISO 8601)
`cursor_user_id`	`string`	No	User ID del cursor para paginación
`cursor_transaction_id`	`string`	No	Transaction ID del cursor para paginación
`cursor_creation_timestamp`	`string`	No	Timestamp del cursor para paginación

Para paginar, usa los valores cursor_user_id, cursor_transaction_id y cursor_creation_timestamp del campo lastEvaluatedKey de la respuesta anterior. A diferencia de GET /payments/, en este endpoint limit sí se respeta y la paginación con lastEvaluatedKey funciona — verificado en sandbox pidiendo limit=3 sobre una cuenta con más movimientos y encadenando dos páginas con el cursor de salida.

transaction_id viene con prefijo TX# (ej. TX#87723204-ba9e-4e70-afba-da165eac4a32), no como UUID limpio. Además, cada item trae un campo id adicional (no documentado antes) con el mismo UUID sin el prefijo. Si necesitás el UUID limpio para otra llamada, usá id, no transaction_id.

Ejemplo


curl -H "Authorization: Bearer $TALO_TOKEN" \
  "https://sandbox-api.talo.com.ar/transactions/?user_id=f61876b0-10a5-4e39-8e2c-17343b3fa1b6&limit=10"

Respuesta (real, sandbox)


{
	"message": "ok",
	"error": false,
	"code": 200,
	"data": {
		"transactions": [
			{
				"transaction_id": "TX#87723204-ba9e-4e70-afba-da165eac4a32",
				"id": "87723204-ba9e-4e70-afba-da165eac4a32",
				"user_id": "f61876b0-10a5-4e39-8e2c-17343b3fa1b6",
				"transactionType": "INBOUND",
				"amount": "1185.48",
				"gross_amount": "1200",
				"address": "0000716149000693369021",
				"address_alias": "jul.807995.talo",
				"currency": "ARS",
				"network": "POLLUX",
				"commission": 1.21,
				"commission_amount": "14.52",
				"taxes": [],
				"transaction_status": "PROCESSED",
				"payment_id": "VAR-f61876b0-DOCFIX-1784132231",
				"creation_timestamp": "2026-07-15T16:18:08.630Z"
			}
		],
		"lastEvaluatedKey": {
			"user_id": "f61876b0-10a5-4e39-8e2c-17343b3fa1b6",
			"transaction_id": "TX#87723204-ba9e-4e70-afba-da165eac4a32",
			"creation_timestamp": "2026-07-15T16:18:08.630Z"
		}
	}
}

Consultar una transacción


GET https://api.talo.com.ar/transactions/{transaction_id}

Sandbox


GET https://sandbox-api.talo.com.ar/transactions/{transaction_id}

Parámetros del path

Campo	Tipo	Descripción
`transaction_id`	`string`	ID de la transacción

Query parameters

Campo	Tipo	Requerido	Descripción
`user_id`	`string`	Sí	ID del usuario dueño de la transacción

Ejemplo


curl -H "Authorization: Bearer $TALO_TOKEN" \
  "https://sandbox-api.talo.com.ar/transactions/1b5a952a-8a79-4003-b06a-e4043d453456?user_id=f61876b0-10a5-4e39-8e2c-17343b3fa1b6"

Respuesta esperada (según el diseño de la API, no reproducible hoy)


{
	"message": "ok",
	"error": false,
	"code": 200,
	"data": {
		"transaction_id": "1b5a952a-8a79-4003-b06a-e4043d453456",
		"user_id": "f61876b0-10a5-4e39-8e2c-17343b3fa1b6",
		"transactionType": "INBOUND",
		"amount": "30000",
		"gross_amount": "30000",
		"address": "0000630500000060195375",
		"address_alias": "talo.ago.1468",
		"currency": "ARS",
		"network": "POLLUX",
		"commission": 0.605,
		"commission_amount": "1053.51",
		"taxes": [
			{
				"tax_type": "CREDIT",
				"tax_rate": 0.6,
				"tax_amount": 1044.80
			}
		],
		"transaction_status": "PROCESSED",
		"transaction_data": {
			"PROCESSED": {
				"amount": 30000,
				"currency": "ARS",
				"recipient": "0000630500000060195375",
				"recipientCuit": "30123456789",
				"recipientTitular": "EXAMPLE SA",
				"sender": "00000031123456789",
				"senderCuit": "20997654321",
				"senderTitular": "Carolina Perez",
				"trxId": "1b5a952a-8a79-4003-b06a-e4043d453456"
			}
		},
		"payment_id": "VAR-f61876b0-FDF_124",
		"creation_timestamp": "2025-03-12T03:35:32.405Z"
	}
}

Respuesta real (verificado en sandbox)


$ curl -H "Authorization: Bearer $TALO_TOKEN" \
  "https://sandbox-api.talo.com.ar/transactions/TX%2387723204-ba9e-4e70-afba-da165eac4a32?user_id=6a0031c1-57ac-4be1-8cd3-303ca25366cd"
 
HTTP/2 403
{"message":"Forbidden"}

Campos de la transacción

Campo	Tipo	Descripción
`transaction_id`	`string`	ID único de la transacción
`user_id`	`string`	ID del usuario dueño
`transactionType`	`string`	Tipo: `INBOUND`, `OUTBOUND`, `REFUND`
`amount`	`string`	Monto neto de la transacción
`gross_amount`	`string`	Monto bruto recibido
`address`	`string`	CVU receptor
`address_alias`	`string`	Alias receptor
`currency`	`string`	Moneda de la transacción
`network`	`string`	Red de procesamiento
`commission`	`number`	Porcentaje de comisión
`commission_amount`	`string`	Monto de la comisión
`taxes`	`array`	Impuestos aplicados (`tax_type`, `tax_rate`, `tax_amount`)
`transaction_status`	`string`	Estado: `PROCESSED`
`transaction_data`	`object`	Datos del procesamiento bancario
`payment_id`	`string`	ID del pago asociado (si aplica)
`customer_id`	`string`	ID del cliente asociado (si aplica)
`creation_timestamp`	`string`	Fecha de creación (ISO 8601)