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 operarPENDING
si la cuenta está pendiente de activaciónREJECTED
si la cuenta fue rechazada por el KYCSUSPENDED
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 unaddress
y unfrequency
. - El
alias_prefix
debe ser único por usuario. - El
transfer_tolerance
ycancellation_period
aplican solo alpaymentsAPI
. - En el caso de usar
customersAPI
elalias_prefix
puede ser más largo. Tener en cuenta que la combinación dealias_prefix
y elalias
que se asigna a cadacustomer
debe ser única y no puede exceder los 20 caracteres.