PUT /stp/v1/account

Callback enviado por STP cuando el estado de una cuenta registrada cambia. Este endpoint nunca es llamado por el backend de Finalitix.

URL: PUT /stp/v1/account
Caller: STP Bank (directo)

Request body

{
  "cuenta": "64618001000001237",
  "empresa": "FINALITIX",
  "estado": "A",
  "observaciones": "",
  "firma": "<RSA-SHA256 en Base64>"
}

Campo	Tipo	Descripción
cuenta	string(18)	Número CLABE de la cuenta
empresa	string	Alias de la empresa en STP (FINALITIX)
estado	string	A = activa, cualquier otro = rechazada
observaciones	string	Observaciones de STP (puede estar vacío)
firma	string	Firma RSA-SHA256 en Base64. Se elimina del body antes de verificar

Verificación de firma

En producción (ENV=prod), la firma se verifica con CryptoHandlerNotificacionEstadoCuenta usando la clave pública de STP. Una firma inválida devuelve 500.

Procesamiento por estado

Estado A (cuenta activa)

1. Actualiza active = true en la tabla account
2. Publica mensaje en SQS para crear partner en Odoo (create_finalitix_partner, modelo res.partner)
3. Invoca Lambda con plantilla de notificación de activación exitosa al usuario

Cualquier otro estado (cuenta rechazada)

1. Crea alerta VRSTP en la tabla alert con URL /users/review
2. Invoca Lambda: correo al cliente con plantilla ON_BOARDING_RESULT_REJECT
3. Invoca Lambda: correo al área PLD con plantilla ON_BOARDING_RESULT_REJECT_PLD
4. Notifica al portal admin vía WebSocket (Lambda PubSub)

Respuesta

// 200 — Notificación procesada
{ "message": "recibido" }

// 500 — Firma inválida (solo en prod)
{ "message": "error validando firma" }

// 401 — Sin credenciales
{ "message": "faltan credenciales" }