Cambios

Ahora tu empresa también puede pagar: un usuario cambia sus fichas (1 ficha = 1 USD) por USDT o USDC y los recibe en su billetera en unos segundos. El dinero sale de tu caja de retiros, que fondeas enviando USDT o USDC a tu dirección de fondeo. Ver Retiros.

• Rutas nuevas: Ver saldo de retiros, Cotizar retiro, Crear retiro, Listar retiros, Obtener retiro, Listar fondeos y Devolver saldo a la tesorería.
• Webhooks nuevos: payout.created, payout.completed, payout.failed y balance.funded.
• Idempotencia obligatoria en los retiros: external_id o la cabecera Idempotency-Key. Además, el contrato no acepta pagar dos veces el mismo retiro.
• Límites en el contrato: máximo por retiro y límite diario por token. Si tu empresa tiene billetera administradora propia, solo tú puedes cambiarlos.
• Los rechazos de retiros traen un campo code estable (insufficient_balance, above_daily_limit…) además de error.
• Ver cuenta devuelve el campo nuevo payouts con la comisión, quién paga el gas y el mínimo por retiro.

Se desplegó una versión nueva de la fábrica y el contrato de retiros, con salidas para el dinero enviado por error:

• Tokens enviados directamente a la dirección de la fábrica: la plataforma los puede devolver (la fábrica nunca guarda fondos propios).
• Tokens enviados directamente al contrato de retiros, sin pasar por una dirección de fondeo: la plataforma puede rescatar solo el sobrante; el saldo de las empresas no se toca.
• ETH enviado por error a una dirección de fondeo: va entero a la tesorería de la empresa.
• Probado con pruebas de invariantes (miles de operaciones al azar): la suma de las cajas siempre cuadra con lo que tiene el contrato y todo el dinero puede salir. Ninguna operación recorre listas que crezcan, así que el gas no aumenta con el número de usuarios o retiros.

Las personas entran al panel con su correo y su contraseña, tanto en las empresas como en la plataforma. La clave de API queda solo para que tu servidor llame a la API: ya no sirve para abrir el panel.

• Cada empresa gestiona a su equipo desde Equipo: añadir personas, restablecer contraseñas y desactivar accesos.
• Un usuario nuevo recibe una contraseña temporal y debe cambiarla al entrar.
• Tras 5 intentos fallidos, el acceso de ese correo se bloquea 15 minutos.
• La integración por API no cambia: sigue usando la cabecera x-api-key. Ver Autenticación.

Todo lo que muestra el panel web ahora también está en la API de la empresa. Son rutas nuevas; las que ya existían siguen respondiendo igual, con campos añadidos.

• Listado de clientes. Listar clientes con limit, offset, search y un resumen de depósitos por cliente.
• Resumen. Ver resumen: totales, depósitos por estado, por token y por día, y estado de los webhooks.
• Varias claves de API. Crear, listar y revocar claves, cada una con nombre y fecha de último uso. Permite rotar sin cortar el servicio. Ver Claves de API.
• Secreto de webhooks. Se puede consultar y rotar.
• Detalle de un evento. Obtener evento devuelve el evento con todos sus envíos: intentos, último código de respuesta y último error.
• Filtros en depósitos. Listar depósitos acepta status, token, customer_id, search y offset, y devuelve total.
• Cabecera `x-request-id`. Todas las respuestas la incluyen. Ver Ids de petición.

Para la plataforma: detalle de una empresa, clave adicional para una empresa, resumen global, depósitos de todas las empresas y estado del sistema. La plataforma también puede consultar las rutas /v1/... en nombre de una empresa con x-admin-token y x-merchant-id.

Antes la comisión de la plataforma no podía pasar del 5 % (500 puntos básicos) ni la de la empresa del 20 % (2000). Esos máximos se eliminaron, tanto en la API como en el contrato: ahora cada una acepta de 0 a 10000 (0 a 100 %).

• Con base gross, si las dos comisiones suman más de 10000, la API responde 400 con Las comisiones de la plataforma y de la empresa suman más del 100 % del depósito.
• Si las comisiones y el gas superan un depósito concreto, ese depósito queda como below_minimum y no se barre.
• En las cotizaciones, cuando las comisiones se llevan todo, to_cover_all devuelve un error en lugar de un monto.
• El tope de gas por barrido (0.50 USD por token) no cambia.

Una cotización pedida con customer_id ahora fija el gas máximo de ese cliente durante 15 minutos. La respuesta de Crear cotización incluye gas_guaranteed_until; si el depósito se detecta antes de esa hora, no se le descuenta más gas que el cotizado. Si el gas sube, la diferencia la asume la plataforma.

El campo es null cuando no se envía customer_id o cuando el gas lo paga la plataforma. Ver Gas y Cotizaciones.

Primera versión de la pasarela, en Arbitrum Sepolia (chain id 421614) con USDT y USDC de prueba.

• Clientes con dirección de depósito permanente, página de pago y QR: Crear cliente.
• Depósitos con detección, confirmación y liquidación automáticas, y el reparto de cada uno: Flujo de un depósito.
• Reparto en una sola transacción: comisión de la plataforma, comisión de la empresa sobre gross o net, gas según gas_mode y el resto a la tesorería.
• Cotizaciones con if_deposit_amount, to_cover_gas y to_cover_all.
• Webhooks firmados con HMAC-SHA256 y reintentos durante unos 3 días, con reenvío manual y aviso de prueba: Webhooks.
• Eventos en orden para conciliar: Listar eventos.
• Rutas de la plataforma para dar de alta empresas, cambiar sus condiciones y comparar el gas cobrado con el real.