Para Partners
Activación y configuración de cuentas

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",
	"referred_user_id": "userPrueba1234"
}

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.

El campo referred_user_id es el id del usuario en tu plataforma. Con este id podrás identificar al usuario en tu plataforma.

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

CampoTipoRequeridoDescripciónValores permitidosLimitaciones
alias_prefixstringNoPrefijo para generar alias de CVUCualquier string válidoMáximo 8 caracteres, solo letras minúsculas, números y guiones bajos
cancellation_periodintegerNoPeríodo de cancelación de pagos en horas1-200Valor entre 1 y 200 horas
transfer_toleranceintegerNoTolerancia para transferencias en pesos0-10000Valor entre 0 y 10000 pesos
payout_schedule.addressstringNoCVU/CBU/alias para retirosLa titularidad de la cuenta debe ser la misma que la del usuario.
payout_schedule.frequencystringNoFrecuencia de retiros automáticosbi_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.