Activación y configuración de cuentas

Una vez que ya has dado de alta a tu cliente en Talo y tenés un token de acceso. Talo enviará una notificación a tu url de webhook para avisarte cuando la cuenta haya sido activada.

La activación de la cuenta puede demorar hasta 36hs.

Payload de la notificación

{
	"message": "account_activated",
	"user_id": "507d3c2ret-36g9-6f22-99ab-427d0sdfsdfff21"
}

El campo user_id es el id del usuario en Talo. Con este id podrás consultar el estado de la cuenta de tu usuario como se indica en la sección siguiente.

Consulta de estado de la cuenta

Para validar que la cuenta del usuario haya sido activada, deberás realizar una consulta a la API de Talo.

GET https://api.talo.com.ar/users/{user_id}/account

Response

{
	"status": "ok",
	"error": false,
	"data": {
		"account_status": "ACTIVE",
		"alias_prefix": "myapp",
		"cancellation_period": 30,
		"transfer_tolerance": 10,
		"payout_schedule": {
			"address": "my.withdraw.alias",
			"frequency": "daily"
		},
		"user_id": "507d3c2ret-36g6-6b22-99ab-427d0sdfsdfff21",
		"partner_config": {
			"commission": 2,
			"partner_id": "75b4bf61-afac-453f-939e-181a2c1de579",
			"partner_name": "La mejor app",
			"partner_slug": "la_mejor_app"
		}
	}
}

El campo account_status puede ser

ACTIVE si la cuenta está activa y lista para operar
PENDING si la cuenta está pendiente de activación
REJECTED si la cuenta fue rechazada por el KYC
SUSPENDED si la cuenta está suspendida

Configuración de la cuenta

Para modificar la configuración de la cuenta, no es necesario que la cuenta esté activa.

Request

PATCH https://api.talo.com.ar/users/{user_id}

{
	"alias_prefix": "myapp",
	"cancellation_period": 30,
	"transfer_tolerance": 10,
	"payout_schedule": {
		"address": "my.withdraw.alias",
		"frequency": "daily"
	}
}

Parámetros de configuración

Campo	Tipo	Requerido	Descripción	Valores permitidos	Limitaciones
`alias_prefix`	string	No	Prefijo para generar alias de CVU	Cualquier string válido	Máximo 8 caracteres, solo letras minúsculas, números y guiones bajos
`cancellation_period`	integer	No	Período de cancelación de pagos en horas	1-200	Valor entre 1 y 200 horas
`transfer_tolerance`	integer	No	Tolerancia para transferencias en pesos	0-10000	Valor entre 0 y 10000 pesos
`payout_schedule.address`	string	No	CVU/CBU/alias para retiros	La titularidad de la cuenta debe ser la misma que la del usuario.
`payout_schedule.frequency`	string	No	Frecuencia de retiros automáticos	`bi_daily`, `daily`, `weekly`, `monthly`,	Solo los valores especificados

Notas:

Todos los campos son opcionales. Solo se actualizarán los campos que se envíen en la request. El payout_schedule si se envía, debe tener un address y un frequency.
El alias_prefix debe ser único por usuario.
El transfer_tolerance y cancellation_period aplican solo al paymentsAPI.
En el caso de usar customersAPI el alias_prefix puede ser más largo. Tener en cuenta que la combinación de alias_prefix y el alias que se asigna a cada customer debe ser única y no puede exceder los 20 caracteres.

Autenticación Introducción