Customers API

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

Crear un cliente

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

Campos opcionales

Campo	Tipo	Descripción
`contact`	`object`	Objeto de contacto (puede ser `null`)
`contact.email`	`string`	E-mail del cliente (requerido si se envía `contact`)
`webhook_url`	`string`	URL donde Talo notificará cada pago (debe ser URL válida)

El campo contact es nullable. Si se envía, el campo email dentro de contact es requerido.

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.

Listar clientes

GET https://sandbox-api.talo.com.ar/customers/?user_id={user_id}

Query parameters

Campo	Tipo	Requerido	Descripción
`user_id`	`string`	Sí	ID del usuario cuyos clientes se quieren consultar

Ejemplo

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

Respuesta

{
	"message": "ok",
	"error": false,
	"code": 200,
	"data": {
		"customers": [
			{
				"customer_id": "123456789",
				"name": "Carla Perez",
				"bank_info": {
					"cvu": "0000630500008064475741",
					"alias": "bami.abcdabcd"
				},
				"balance": 15000,
				"creation_timestamp": "2025-02-18T19:57:26.674Z"
			}
		]
	}
}

Consultar transacción de un cliente

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

Parámetros del path

Campo	Tipo	Descripción
`customer_id`	`string`	ID del cliente
`transaction_id`	`string`	ID de la transacción a consultar

Ejemplo

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 Transactions API