Copy page

Plataforma

Notificaciones de pago

Fluxis puede enviar una notificacion por email al comercio cuando se registra el resultado de un pago para una cuenta. Las notificaciones de venta estan habilitadas por defecto. Envia sales_notifications_enabled en false para detenerlas. Mientras estan habilitadas, Fluxis envia al email de notificacion de la cuenta, o al email del dueno de la organizacion cuando esa direccion esta vacia.

Descripcion general

Cuando un pago alcanza su estado final en la blockchain, Fluxis lo registra como transaccion en tu libro contable (Hop 3 del ciclo de vida de pago) y luego envia un email cuando las notificaciones de venta estan habilitadas. Como ese paso se ejecuta desde una cola, el email puede llegar unos segundos despues del webhook con el estado final. Los pagos completados y sobrepagados reciben un email de nueva venta; los pagos insuficientes reciben un email de accion necesaria. Cada email incluye, cuando estan disponibles:

• Monto recibido - el monto efectivamente recibido, con el simbolo del token (ej. USDC, USDT) y la red (ej. Polygon, Base)
• Monto solicitado y diferencia - el monto faltante en pagos insuficientes, el monto extra en pagos sobrepagados
• Nombres del punto de venta y de la cuenta
• Monto de la venta - el monto de referencia (fiat) de la solicitud de pago, cuando se creo con uno
• Referencia del pedido - el external_id definido en la solicitud de pago
• Direccion del pagador y hash de la transaccion
• ID de pago - el identificador de solicitud de pago de Fluxis para conciliacion
• Un boton que abre esa transaccion en el Dashboard de Fluxis (en pagos insuficientes, la transaccion retenida)

Las filas sin datos no se incluyen en el email.

Las notificaciones se envian para pagos completados, sobrepagados e insuficientes. Solo se envia un email por pago. Los pagos fallidos o pendientes no generan email.

Configurar por API

Usa tus credenciales de API de nivel organizacion para leer o escribir el email de notificacion y el interruptor de notificaciones de venta de una cuenta. Ambos campos son opcionales al actualizar: omite un campo para dejarlo sin cambios.

Obtener la configuracion actual

Code
GET /v1/account/notification-email/{accountId}

Respuesta:

Code
{
  "data": {
    "notification_email": "[email protected]",
    "sales_notifications_enabled": true
  }
}

Devuelve null en notification_email cuando no hay direccion configurada. sales_notifications_enabled es true cuando la cuenta no tiene un interruptor guardado.

Establecer o actualizar la configuracion

Code
PUT /v1/account/notification-email/{accountId}
Content-Type: application/json

{
  "notification_email": "[email protected]",
  "sales_notifications_enabled": true
}

Envia solo el campo que quieras cambiar. Omitir notification_email, incluso con un cuerpo vacio {}, deja la direccion guardada sin cambios. Omitir sales_notifications_enabled, o enviar null, deja el interruptor sin cambios.

Para detener los emails de venta del comercio sin cambiar la direccion:

Code
{
  "sales_notifications_enabled": false
}

Vuelve a ponerlo en true para reanudarlos. Mientras el interruptor esta activo, una direccion vacia sigue recibiendo el email del dueno de la organizacion.

Para borrar la direccion, envia null o una cadena vacia. Borrar la direccion no apaga las notificaciones de venta:

Code
{
  "notification_email": null
}

La direccion se valida como un email estandar RFC 5322. Una direccion invalida devuelve HTTP 400.

Este interruptor afecta solo a los emails de venta del comercio (completados, sobrepagados e insuficientes). No afecta los emails de invitacion de colaboradores ni los de autenticacion en dos pasos.

Configurar desde el Dashboard

Los usuarios del Dashboard con rol Owner o Admin pueden gestionar el email de notificacion y el interruptor de notificaciones de venta en la seccion Cuentas del Dashboard de Fluxis. Los endpoints del dashboard usan el mismo cuerpo JSON que la API publica.

Endpoints utilizados por la API del Dashboard:

Accion	Endpoint
Obtener	GET /dashboard/accounts/notification-email/{accountID}
Establecer	PUT /dashboard/accounts/notification-email/{accountID}

Un email por cuenta

• Solo se admite una unica direccion de email opcional por cuenta. No es una lista.
• La configuracion pertenece a la cuenta, no a un Punto de Venta especifico.
• Todos los pagos con estado final de esa cuenta, de cualquier Punto de Venta, generan una notificacion a la misma direccion mientras las notificaciones de venta estan habilitadas.

Pagos insuficientes

Cuando el monto recibido es menor al esperado, el estado del pago se establece como underpaid. El email se marca como Accion necesaria y muestra el monto solicitado, el monto recibido y el monto faltante. Los pagos insuficientes quedan retenidos y no se liquidan automaticamente: abre el pago desde el boton del email, revisa la transaccion en el Dashboard de Fluxis y decide si aceptarlo como pagado o reembolsarlo.

Solucion de problemas

Problema	Que verificar
No se recibe email	Verificar que sales_notifications_enabled sea true y que notification_email o el email del dueno de la organizacion esten definidos; revisar carpeta de spam
Error de direccion invalida	La direccion debe ser un email RFC 5322 valido
No llega email para pago fallido o pendiente	Esperado - solo completed, overpaid e underpaid generan emails

Relacionado

• Webhooks - notificaciones HTTP en tiempo real para cambios de estado de pago
• Eventos de webhook - lista completa de tipos de eventos de webhook