Skip to Content
Transferencias BancariasCustomers API (Clientes fijos)

Customers API

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

Prerequisito: tu cuenta necesita un alias_prefix configurado antes de poder crear clientes. Si no lo tenés, este endpoint devuelve un error 400 con mensaje user.alias.prefix.not.set. Configuralo desde el dashboard (Settings → Alias) o vía API con PATCH a tu recurso de usuario (/users/<user_id>), enviando alias_prefix (3 a 8 caracteres alfanuméricos, único por cuenta).

Crear un cliente

Prod

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

Sandbox

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

Campos requeridos

CampoTipoDescripción
user_idstringTu user_id de Talo
aliasstringSufijo de alias deseado (ej. abcdabcd)
customer_idstringID único interno (DNI/CUIT o UUID)
namestringNombre del cliente

Campos opcionales

CampoTipoDescripción
contactobjectObjeto de contacto (puede ser null)
contact.emailstringE-mail del cliente (requerido si se envía contact)
webhook_urlstringURL 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.

Modificar alias de un cliente

PATCH https://sandbox-api.talo.com.ar/customers/{customer_id}/alias

Body

CampoTipoRequeridoDescripción
aliasstringSíNuevo sufijo de alias deseado
create_new_cvubooleanSíSi es true, Talo asigna un CVU nuevo y libera el anterior. Si es false, Talo intenta mantener el CVU actual y cambia el alias; si el proveedor no permite el cambio, asigna un CVU nuevo automáticamente.

Si create_new_cvu es false, Talo intenta cambiar el alias en la CVU actual. Cuando la CVU es demasiado reciente para el proveedor, Talo resuelve la operación asignando una CVU nueva y liberando la anterior.

Ejemplo

curl -X PATCH https://sandbox-api.talo.com.ar/customers/123456789/alias \
  -H "Authorization: Bearer $TALO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "alias": "nuevoalias",
    "create_new_cvu": false
  }'

Respuesta

{
	data: {
		customer_id: "123456789",
		alias: "nuevoalias",
		bank_info: {
			cvu: "0000630500008064475741",
			alias: "bami.nuevoalias",
		},
		last_modified_timestamp: "2026-04-27T15:30:00.000Z",
	},
}

Si create_new_cvu es true, bank_info.cvu cambia en la respuesta. Si es false, normalmente se mantiene el CVU actual; si el proveedor rechaza el cambio por la antigüedad de la CVU, también puede cambiar en la respuesta.

Listar clientes

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

Query parameters

CampoTipoRequeridoDescripción
user_idstringSí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

CampoTipoDescripción
customer_idstringID del cliente
transaction_idstringID 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

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

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

Last updated on
Balances APIPayments API