👤 Customers API

Crea un cliente con su propio CVU/alias para que pueda pagarte las veces que quiera sin generar nuevos datos de pago.

Endpoint Alta de CVU/Alias

Prod

POST https://api.talo.com.ar/customers/

Sandbox

POST https://sandbox-api.talo.com.ar/customers/

Campos requeridos

Campo	Tipo	Descripción
`user_id`	`string`	Tu `user_id` de Talo
`alias`	`string`	Sufijo de alias deseado (ej. `abcdabcd`)
`customer_id`	`string`	ID único interno (DNI/CUIT o UUID)
`name`	`string`	Nombre del cliente
`contact.email`	`string`	E‑mail del cliente
`webhook_url`	`string`	URL donde Talo notificará cada pago

Ejemplo de solicitud

curl -X POST https://sandbox-api.talo.com.ar/customers/ \
  -H "Authorization: Bearer $TALO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "f61876b0-10a5-4e39-8e2c-17343b3fa1b6",
    "alias": "abcdabcd",
    "customer_id": "123456789",
    "name": "Carla Perez",
    "contact": { "email": "carlaperez@gmail.com" },
    "webhook_url": "https://tu-sitio.com/webhooks/talo"
  }'

Respuesta

{
	data: {
		customer_id: "123456789",
		bank_info: {
			cvu: "0000630500008064475741",
			alias: "bami.abcdabcd",
		},
		balance: 0,
		creation_timestamp: "2025-02-18T19:57:26.674Z",
	},
}

El cliente utiliza siempre ese CVU/alias. Cada vez que transfiera, Talo enviará un webhook.

Consultar balance & transacciones

# Balance
GET /customers/{customer_id}
 
# Detalle de transacción
GET /customers/{customer_id}/transactions/{transaction_id}

Ejemplo cURL

curl -H "Authorization: Bearer $TALO_TOKEN" \
  https://sandbox-api.talo.com.ar/customers/123456789/transactions/1b5a952a-8a79-4003-b06a-e4043d453456

Simular pago en sandbox

curl -X POST \
  "https://sandbox-api.talo.com.ar/cvu/0000630500008064475741/faucet" \
  -H "Authorization: Bearer $TALO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "amount": 15000 }'

Casos de uso frecuentes

Escenario	Cómo funciona
Suscripción mensual	El cliente transfiere cada mes al mismo alias. Tu sistema detecta el webhook y renueva su plan.
Cuentas por cobrar B2B	Asigna alias único por proveedor. Simplifica la conciliación de múltiples facturas a lo largo del mes.
Préstamo/cuotas	El deudor paga cuando quiera; Talo actualiza el balance y envía webhook.

Necesitas saber cómo escuchar notificaciones? Ve a Webhooks →

Payments API Webhooks