Ir al contenido

Retiros automáticos

Los retiros automáticos sacan dinero de tu billetera de Invoise sin una confirmación para cada retiro. Para cada red defines un umbral; cuando la billetera tiene esa cantidad allí, todo el saldo de esa red va a una dirección externa tuya. Tu propio servidor de firma firma las transacciones e Invoise añade la segunda firma.

Se configuran en el panel: Billetera → Seguridad → Automatización de retiros → Configurar. Cada regla en Reglas por red indica:

  • Desde la red: la red cuyo saldo se retira. Una regla por red.
  • A la red: adónde va el dinero. Puede ser la misma red; entonces no se usa ningún puente.
  • Token: uno de los tokens que Invoise admite en la red de destino.
  • Umbral en dólares: desde el retiro mínimo, con dos decimales como máximo.

Los pagos en Tron y Solana llegan a la billetera en Arbitrum (consulta Solana y Tron), así que cuentan en la regla de Arbitrum. No hay una regla aparte para Tron o Solana.

Cuando la billetera tiene al menos el umbral en una red de origen, Invoise retira todo el saldo de esa red, en las stablecoins que sean, menos la comisión, a la Dirección del destinatario. El saldo propio de la red de destino se queda donde está. Una stablecoin que ningún puente puede llevar al token de pago, como USDT0 en Arbitrum para USDC en Base, se cambia primero por el USDC de esa red en Uniswap, y luego el CCTP de Circle mueve el USDC. Una stablecoin de la familia del token de pago viaja por Across, y una regla cuyo destino es su propio origen hace el cambio en esa red, como un retiro manual. La comisión es la misma que la de un retiro manual.

Invoise revisa las reglas cada minuto y envía un retiro automático a la vez: el de la primera regla cuya red alcanzó su umbral.

Ajuste Significado
No más a menudo que Sin límite, o una vez por hora, cada 3, 6 o 12 horas, una vez al día o una vez a la semana.
Desactivar tras fallos seguidos De 1 a 10, 3 por defecto. Tras un fallo, el siguiente intento espera 5 minutos, luego 30 minutos y luego 2 horas. Recibes un aviso del primer fallo de una serie y cuando los retiros automáticos se desactivan.
Comisión no mayor que 0,5 %, 1 %, 2 %, 3 %, 5 % o 10 % del importe que llega al destinatario, 1 % por defecto.

El tope de comisión cubre el gas de red de todos los pasos. Cuando el gas cuesta más, el retiro de esa red espera: el panel muestra Esperando una comisión menor con la comisión y el importe, y el retiro sale cuando el saldo ha crecido o el gas se ha abaratado. Una espera no es un fallo. Las comisiones de puente y de intercambio crecen con el importe y las limita la ruta: se rechaza un intercambio que perdería más del 3 %.

El límite diario y la pausa de la billetera también se aplican a los retiros automáticos. Desactivarlos y endurecer las reglas surte efecto de inmediato. Con el periodo de espera activado, activarlos, otro servidor de firma o destinatario, una regla nueva o redirigida, un umbral o intervalo menor, más fallos tolerados y un tope de comisión mayor solo surten efecto tras el periodo de espera; el panel muestra cuándo, y hasta entonces puedes cancelar el cambio. Cada cambio envía un aviso de seguridad y, si la cuenta tiene 2FA, pide un segundo factor.

La billetera es un Safe con un umbral de 2 de 3, así que cada retiro necesita dos firmas. El cofirmante de Invoise aporta una. En un retiro manual, la otra viene de tu clave del comercio, que nunca sale de tu navegador, así que no puede firmar mientras no estás.

Invoise nunca tiene dos claves de tu billetera. En los retiros automáticos, la segunda firma viene de tu propio servidor de firma, que guarda una de las claves de la billetera que controlas: la clave del delegado o tu clave del comercio. Invoise acepta cualquiera de las dos sin preguntar cuál es; la elección decide qué puede hacer una clave del servidor filtrada:

  • Clave del delegado. El cofirmante de Invoise acepta la firma del delegado por sí sola solo mientras los retiros automáticos están activados y solo para pagos a la dirección del destinatario que definiste; todo lo demás sigue necesitando tu clave del comercio. Por eso una clave del servidor filtrada no puede enviar dinero a otro sitio a través de Invoise.
  • Clave del comercio. No hay nada más que configurar, pero el cofirmante acepta la clave del comercio para todo lo que puedes hacer tú. Con una clave del servidor filtrada se puede retirar a cualquier dirección, cambiar las protecciones y reemplazar claves a través de Invoise; solo siguen vigentes el límite diario, la pausa y el periodo de espera. La clave queda entonces en el servidor además de en tu navegador.

Un servidor con la clave del delegado tiene además todos los poderes de un delegado: por sí sola puede poner en cola un retiro mediante el módulo de retraso, que se ejecuta a los tres días salvo que lo canceles (consulta Si Invoise no está disponible). Protege la clave del servidor tanto como la clave de la billetera.

  1. Ejecuta en una URL HTTPS pública un servidor de firma que siga el protocolo. Se rechazan las direcciones locales y privadas.
  2. Abre Billetera → Seguridad → Automatización de retiros → Configurar y pulsa Emitir secreto en Servidor de firma. El secreto se muestra una sola vez: guárdalo en tu servidor. Emitir uno nuevo lo reemplaza, y las solicitudes firmadas con el anterior dejan de verificarse al instante.
  3. Introduce la URL del servidor de firma, la Dirección del destinatario, las reglas y los límites, activa el interruptor Retiros automáticos activados y pulsa Guardar. Invoise pide al servidor que se identifique y muestra su clave como Clave del servidor.
  4. Si la clave del servidor es tu clave del comercio, el estado pasa a Activo al instante y la configuración termina. Si no, la sección indica El servidor de firma no es el delegado. Pulsa Hacer delegado. Mientras la billetera no esté desplegada en ninguna red, el servidor pasa a ser el delegado al instante; si no, confirma la transacción con tu clave del comercio en cada red desplegada. El delegado actual se reemplaza. Cambiar el delegado es un cambio de seguridad, así que con el periodo de espera activado pausa los retiros.
  5. Cuando el servidor es el delegado, Invoise permite a su cofirmante aceptar la firma del servidor para tu dirección de destinatario, y el estado pasa a Activo.
Estado Significado
Desactivado Los retiros automáticos están desactivados.
Esperando delegado La clave del servidor no es tu clave del comercio ni el delegado de la billetera: pulsa Hacer delegado.
Reintentando tras un error El último intento falló; el panel muestra el error y los fallos seguidos.
Activo Los retiros se ejecutan según las reglas.

Un servidor de firma nuevo guardado con el periodo de espera activado espera a que termine, como cualquier relajación. Si lo haces delegado antes de que el cambio surta efecto, la configuración actual apunta a un servidor que ya no es el delegado, y no se retira nada hasta que se aplique el cambio.

Invoise envía cada solicitud como POST a la URL de tu servidor de firma con un cuerpo JSON, Content-Type: application/json, User-Agent: Invoise-Automation/1 y el encabezado Invoise-Signature: t=<unix time>,v1=<hex>. La firma es HMAC-SHA256 de t + "." + raw_body. La clave HMAC es toda la cadena del secreto tal como la muestra el panel, con el prefijo ias_ incluido (ias_ y 64 caracteres hexadecimales).

Es el esquema de los webhooks, y la función verify de allí funciona sin cambios con este secreto. El servidor DEBE rechazar una solicitud cuya firma no se verifique o cuyo t se aleje más de 5 minutos de su propio reloj. La firma cubre solo la hora y el cuerpo, así que el servidor DEBE responder a un operation_id repetido con las firmas que ya dio, o con un rechazo, y nunca firmar datos distintos con el mismo operation_id.

El servidor responde 200 con un cuerpo JSON; cualquier otro estado es un rechazo. La respuesta completa debe llegar en 30 segundos y ocupar como máximo 1 MiB. No se siguen las redirecciones.

Se envía cuando guardas una URL nueva de servidor de firma. La dirección que se recupera de la respuesta pasa a ser la clave del servidor. Vale si es tu clave del comercio o el delegado de la billetera; cualquier otra clave la haces luego delegado.

{
"type": "identify",
"wallet": "0x41d97e9d7b8d051f1ac4adaf92ca1e7b8c788375",
"message": "Invoise automatic withdrawals\nWallet: 0x41d97e9d7b8d051f1ac4adaf92ca1e7b8c788375\nServer: https://signer.example.com/invoise\nNonce: 5f0c4a7e9b2d81f3a6c0e47d1b9a2f68\nIssued At: 2026-10-04T12:00:00Z"
}

Responde con una firma EIP-191 (personal_sign) de message, exactamente como se recibió, hecha con la clave del servidor (la del delegado o tu clave del comercio), y la dirección de esa clave:

{ "address": "0x5b38da6a701c568545dcfcb03fcb875f56beddc4", "signature": "0x…" }

La dirección debe ser aquella a la que se recupera la firma, y no puede ser el cofirmante de Invoise.

Se envía una vez por cada retiro automático. Este mueve USDT0 y USDC de Arbitrum a USDC en Base:

{
"type": "sign",
"operation_id": "9b0f5c2e-4a1d-4f6b-8c3e-2d7a9e1f0b64",
"wallet": "0x41d97e9d7b8d051f1ac4adaf92ca1e7b8c788375",
"source_chain_id": 42161,
"chain_id": 8453,
"token": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
"symbol": "USDC",
"decimals": 6,
"amount": "249310000",
"payee": "0x2f1e7c3b9a4d5e6f708192a3b4c5d6e7f8091a2b",
"total_fee_usd": "0.11",
"legs": [
{
"position": 0,
"chain_id": 42161,
"safe": "0x41d97e9d7b8d051f1ac4adaf92ca1e7b8c788375",
"fee_recipient": "0x…",
"intent": "swap",
"safe_tx": { "to": "0x9641d764fc13c8b624c04430c7356c1c7c8102e2", "value": "0", "data": "0x8d80ff0a…", "operation": 1, "nonce": "4" },
"hash": "0x…",
"token": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
"symbol": "USDC",
"decimals": 6,
"amount": "0",
"fee": { "token": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "37000" },
"swap": { "router": "0x…", "spender": "0x…", "token_in": "0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9", "amount_in": "120000000", "token_out": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "min_out": "119380000" },
"bridge": null,
"deploys": false
},
{
"position": 1,
"chain_id": 42161,
"safe": "0x41d97e9d7b8d051f1ac4adaf92ca1e7b8c788375",
"fee_recipient": "0x…",
"intent": "burn",
"safe_tx": { "to": "0x9641d764fc13c8b624c04430c7356c1c7c8102e2", "value": "0", "data": "0x8d80ff0a…", "operation": 1, "nonce": "5" },
"hash": "0x…",
"token": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
"symbol": "USDC",
"decimals": 6,
"amount": "249400000",
"fee": { "token": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "30000" },
"swap": null,
"bridge": null,
"deploys": false
},
{
"position": 3,
"chain_id": 8453,
"safe": "0x41d97e9d7b8d051f1ac4adaf92ca1e7b8c788375",
"fee_recipient": "0x…",
"intent": "withdraw",
"safe_tx": { "to": "0x9641d764fc13c8b624c04430c7356c1c7c8102e2", "value": "0", "data": "0x8d80ff0a…", "operation": 1, "nonce": "0" },
"hash": "0x…",
"token": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
"symbol": "USDC",
"decimals": 6,
"amount": "249310000",
"fee": { "token": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "20000" },
"swap": null,
"bridge": null,
"deploys": true
}
]
}
Campo Significado
operation_id Un retiro automático.
source_chain_id, chain_id, token, amount, payee La red de origen de la regla y lo que llega al destinatario en la red de destino.
total_fee_usd La comisión de red de todos los pasos, en USD.
legs Las transacciones Safe que hay que firmar. Una recepción de CCTP o un fill de Across no necesita firma, así que las posiciones pueden saltarse números.
safe La dirección Safe de la billetera en la red del paso.
intent withdraw, swap, burn o bridge.
safe_tx La transacción Safe: to, value, data, operation, nonce.
fee, fee_recipient La comisión de red del paso y adónde se paga.
swap, bridge El intercambio o el depósito de Across que hace el paso; si no, null.
deploys El Safe aún no tiene código en esa red: se despliega en la misma transacción y el nonce es 0.

Los importes, los nonces y value son cadenas decimales en unidades del token; decimals y operation son números.

Responde con una firma por paso:

{ "signatures": [ { "position": 0, "signature": "0x…" }, { "position": 1, "signature": "0x…" }, { "position": 3, "signature": "0x…" } ] }

Cada firma es la firma ECDSA de 65 bytes de la clave del servidor (r‖s‖v, v como 27/28 o 0/1) del hash SafeTx del paso. Una firma que no se recupera ni al delegado de la billetera ni a tu clave del comercio hace fallar el retiro con automation_signature_invalid.

La clave del servidor es una de las dos firmas que necesita el Safe, así que tu servidor es la comprobación que impide que Invoise actúe nunca solo. Antes de firmar un paso, DEBE:

  1. Calcular el hash por sí mismo. Calcula el hash EIP-712 de Safe 1.4.1 y firma solo ese, nunca el campo hash tal como llega. Dominio: EIP712Domain(uint256 chainId,address verifyingContract) con chain_id y safe del paso. Mensaje: SafeTx(address to,uint256 value,bytes data,uint8 operation,uint256 safeTxGas,uint256 baseGas,uint256 gasPrice,address gasToken,address refundReceiver,uint256 nonce) con to, value, data, operation y nonce de safe_tx, safeTxGas, baseGas y gasPrice a 0, y gasToken y refundReceiver con la dirección cero. safe debe ser la billetera a la que sirve en esa red.

  2. Comprobar el lote. operation 1 (DELEGATECALL) solo se permite hacia MultiSendCallOnly 0x9641d764fc13c8b624c04430c7356c1c7c8102e2 con la llamada multiSend(bytes), y cada elemento del lote debe ser una llamada simple (operation 0) con valor 0. Una llamada única llega con operation 0. Rechaza cualquier otro DELEGATECALL y cualquier administración del Safe: swapOwner, addOwnerWithThreshold, removeOwner, changeThreshold, enableModule, disableModule, setGuard, setFallbackHandler, execTransactionFromModule, o cualquier llamada al propio Safe.

  3. Comprobar cada llamada. Exactamente un transfer(fee_recipient, fee.amount) de fee.token. Un approve solo por el importe exacto que gasta la llamada siguiente: a swap.spender para swap.token_in y swap.amount_in, al TokenMessengerV2 de CCTP 0x28b5a0e9c621a5badaa536219b3a228c8168cf5d para el importe quemado, o a bridge.spoke_pool para bridge.token_in y bridge.amount_in. Después, según intent:

    • withdraw: un transfer del token de pago a la dirección del destinatario que el servidor tiene registrada;
    • swap: una llamada a swap.router cuyo resultado se queda en el Safe;
    • burn: depositForBurn en TokenMessengerV2 con mintRecipient igual al Safe, rellenado a 32 bytes;
    • bridge: depositV3 en bridge.spoke_pool con el Safe como depositante y como destinatario.

    Rechaza cualquier otra cosa.

  4. Aplicar sus propios límites. Compara amount y total_fee_usd con sus propios límites, como por retiro, por día y proporción de comisión, y el destinatario con su propia configuración, nunca con el payee de la solicitud.

El cofirmante de Invoise aplica las mismas reglas antes de firmar, así que una solicitud correcta siempre las supera. El servidor las repite porque no debe confiar en Invoise.

Tu servidor puede leer de Invoise aquello con lo que compara las solicitudes, firmando con el mismo secreto. Envía GET a https://platform.invoise.me/api/v1/automation/<recurso>?wallet=<dirección del Safe> con la cabecera Invoise-Signature: t=<hora unix>,v1=<hex>, donde v1 es HMAC-SHA256 de t + "." + ruta y query, por ejemplo 1791200000./api/v1/automation/settings?wallet=0x41d9…. Es la función de firma de los webhooks con la ruta de la solicitud en lugar del cuerpo. t puede diferir del reloj de Invoise como mucho 5 minutos. Una firma incorrecta, un t caducado, una billetera desconocida y una billetera sin secreto reciben igualmente 401.

Ruta Respuesta
/automation/settings El destinatario, las reglas, los límites, el estado y el cambio pendiente; owners (merchant, delegate, cosigner), server_key_role (merchant, delegate o vacío) y las protecciones de la billetera protections (límite diario, periodo de espera, pausa).
/automation/networks Por red: safe, deployed, tokens, fee_recipient, multisend y, donde la red los admite, cctp (token_messenger, domain, usdc), swap (router, spender) y across (spoke_pool); si no, null.
/automation/operations Retiros automáticos, los más recientes primero, con sus pasos, estados y hashes de transacción; limit de 1 a 100, 50 por defecto.
/automation/operations/{id} Un retiro automático, por ejemplo el operation_id de una solicitud sign.

Usa las respuestas para rellenar y comparar la configuración propia del servidor, no como la comprobación en sí. Vienen del mismo Invoise frente al que protege tu servidor, así que el destinatario, los límites y los contratos permitidos con los que firma el servidor deben ser suyos.

Estos códigos aparecen en el panel, en el aviso de fallo y al guardar la configuración.

Código Significado
automation_server_unreachable El servidor no respondió en 30 segundos, o su URL ya no es una dirección HTTPS pública.
automation_server_refused El servidor respondió con un estado distinto de 200; lo más habitual es que aún tenga un secreto antiguo.
automation_server_invalid La respuesta no era un JSON válido con la forma esperada, la firma de identify no se recupera a la dirección dada, o la clave es el cofirmante.
automation_signature_invalid Una firma no se recupera ni al delegado de la billetera ni a tu clave del comercio: la clave del servidor cambió. Guarda la URL de nuevo para que el servidor se identifique y luego hazlo delegado si no es tu clave del comercio.
route_unavailable, swap_quote_failed Ninguna ruta de puente o de intercambio puede mover este saldo ahora. Sube el umbral o usa una regla dentro de una misma red.