Automatische Auszahlungen
Automatische Auszahlungen bewegen Geld aus Ihrer Invoise-Wallet, ohne dass Sie jede Auszahlung bestätigen. Für jedes Netzwerk legen Sie einen Schwellenwert fest; sobald die Wallet dort so viel hält, geht das gesamte Guthaben dieses Netzwerks an eine externe Adresse von Ihnen. Ihr eigener Signaturserver signiert die Transaktionen, Invoise fügt die zweite Signatur hinzu.
So funktioniert es
Abschnitt betitelt „So funktioniert es“Sie richten sie im Dashboard ein: Wallet → Sicherheit → Auszahlungsautomatisierung → Einrichten. Jede Regel unter Regeln pro Netzwerk legt fest:
- Aus Netzwerk: das Netzwerk, dessen Guthaben ausgezahlt wird. Eine Regel pro Netzwerk.
- In Netzwerk: wohin das Geld geht. Es kann dasselbe Netzwerk sein; dann wird keine Bridge verwendet.
- Token: einer der Token, die Invoise im Zielnetzwerk unterstützt.
- Schwellenwert in Dollar: ab der Mindestauszahlung, mit höchstens zwei Nachkommastellen.
Zahlungen in Tron und Solana kommen auf Arbitrum in der Wallet an (siehe Solana und Tron), daher zählen sie zur Arbitrum-Regel. Eine eigene Regel für Tron oder Solana gibt es nicht.
Hält die Wallet in einem Quellnetzwerk mindestens den Schwellenwert, zahlt Invoise das gesamte Guthaben dieses Netzwerks, gleich in welchen Stablecoins, abzüglich der Gebühr an die Empfängeradresse aus. Das eigene Guthaben des Zielnetzwerks bleibt, wo es ist. Ein Stablecoin, den keine Bridge in den Auszahlungs-Token bringen kann, etwa USDT0 auf Arbitrum für USDC auf Base, wird zuerst auf Uniswap in USDC dieses Netzwerks getauscht, und Circles CCTP bewegt dann die USDC. Ein Stablecoin aus der Familie des Auszahlungs-Tokens läuft über Across, und eine Regel, deren Ziel ihre Quelle ist, tauscht in diesem Netzwerk, wie eine manuelle Auszahlung. Die Gebühr ist dieselbe wie bei einer manuellen Auszahlung.
Invoise prüft die Regeln jede Minute und sendet jeweils eine automatische Auszahlung: für die erste Regel, deren Netzwerk den Schwellenwert erreicht hat.
| Einstellung | Bedeutung |
|---|---|
| Nicht öfter als | Ohne Limit oder einmal pro Stunde, alle 3, 6 oder 12 Stunden, einmal pro Tag oder einmal pro Woche. |
| Nach Fehlschlägen in Folge deaktivieren | 1 bis 10, standardmäßig 3. Nach einem Fehlschlag wartet der nächste Versuch 5 Minuten, dann 30 Minuten, dann 2 Stunden. Sie werden über den ersten Fehlschlag einer Serie benachrichtigt und wenn automatische Auszahlungen deaktiviert werden. |
| Gebühr höchstens | 0,5 %, 1 %, 2 %, 3 %, 5 % oder 10 % des Betrags, der beim Empfänger ankommt, standardmäßig 1 %. |
Die Gebührenobergrenze umfasst das Netzwerk-Gas aller Schritte. Kostet das Gas mehr, wartet die Auszahlung aus diesem Netzwerk: Das Dashboard zeigt Wartet auf niedrigere Gebühr mit Gebühr und Betrag, und die Auszahlung läuft, sobald das Guthaben gewachsen oder das Gas günstiger geworden ist. Warten ist kein Fehlschlag. Bridge- und Swap-Gebühren wachsen mit dem Betrag und werden von der Route begrenzt: Ein Swap, der mehr als 3 % verlieren würde, wird abgelehnt.
Das Tageslimit und die Pause der Wallet gelten auch für automatische Auszahlungen. Deaktivieren und Verschärfen der Regeln wirken sofort. Bei aktivem Cooldown wirken Aktivieren, ein anderer Signaturserver oder Empfänger, eine neue oder umgeleitete Regel, ein niedrigerer Schwellenwert oder ein kürzeres Intervall, mehr tolerierte Fehlschläge und eine höhere Gebührenobergrenze erst nach dem Cooldown; das Dashboard zeigt, wann, und bis dahin lässt sich die Änderung abbrechen. Jede Änderung sendet einen Sicherheitshinweis und verlangt, wenn das Konto 2FA hat, einen zweiten Faktor.
Warum ein eigener Signaturserver
Abschnitt betitelt „Warum ein eigener Signaturserver“Die Wallet ist ein Safe mit einer 2-von-3-Schwelle, daher braucht jede Auszahlung zwei Signaturen. Der Invoise-Co-Signer liefert eine davon. Bei einer manuellen Auszahlung kommt die andere von Ihrem Händlerschlüssel, der Ihren Browser nie verlässt; er kann also nicht signieren, während Sie abwesend sind.
Invoise hält nie zwei Schlüssel Ihrer Wallet. Bei automatischen Auszahlungen kommt die zweite Signatur von Ihrem eigenen Signaturserver, der einen der Wallet-Schlüssel hält, die Sie kontrollieren: den Schlüssel des Delegierten oder Ihren Händlerschlüssel. Invoise akzeptiert beide, ohne nachzufragen, welcher es ist; die Wahl entscheidet, was ein geleakter Serverschlüssel tun kann:
- Delegiertenschlüssel. Der Invoise-Co-Signer akzeptiert die Signatur des Delegierten allein nur, solange automatische Auszahlungen aktiv sind, und nur für Auszahlungen an die von Ihnen festgelegte Empfängeradresse; alles andere braucht weiterhin Ihren Händlerschlüssel. Ein geleakter Serverschlüssel kann daher über Invoise kein Geld an andere Adressen senden.
- Händlerschlüssel. Sonst ist nichts einzurichten, aber der Co-Signer akzeptiert den Händlerschlüssel für alles, was Sie selbst tun können. Mit einem geleakten Serverschlüssel lässt sich über Invoise an jede Adresse auszahlen, der Schutz ändern und Schlüssel ersetzen; es gelten nur noch Tageslimit, Pause und Cooldown. Der Schlüssel liegt dann auf dem Server und in Ihrem Browser.
Ein Server mit dem Delegiertenschlüssel hat zudem alle Befugnisse eines Delegierten: Allein kann er über das Delay-Modul eine Auszahlung in die Warteschlange stellen, die nach drei Tagen ausgeführt wird, wenn Sie sie nicht abbrechen (siehe Wenn Invoise nicht verfügbar ist). Schützen Sie den Serverschlüssel so gut wie den Wallet-Schlüssel.
Einrichten
Abschnitt betitelt „Einrichten“- Betreiben Sie unter einer öffentlichen HTTPS-URL einen Signaturserver, der dem Protokoll folgt. Lokale und private Adressen werden abgelehnt.
- Öffnen Sie Wallet → Sicherheit → Auszahlungsautomatisierung → Einrichten und drücken Sie unter Signaturserver auf Geheimnis ausstellen. Das Geheimnis wird einmal angezeigt: Speichern Sie es auf Ihrem Server. Neues ausstellen ersetzt es, und mit dem alten signierte Anfragen lassen sich sofort nicht mehr verifizieren.
- Geben Sie die URL des Signaturservers, die Empfängeradresse, die Regeln und die Limits ein, aktivieren Sie den Schalter Automatische Auszahlungen aktiv und drücken Sie Speichern. Invoise bittet den Server, sich auszuweisen, und zeigt seinen Schlüssel als Serverschlüssel.
- Ist der Schlüssel des Servers Ihr Händlerschlüssel, wird der Status sofort Aktiv und die Einrichtung ist fertig. Andernfalls zeigt der Abschnitt Der Signaturserver ist nicht der Delegierte. Drücken Sie Zum Delegierten machen. Solange die Wallet in keinem Netzwerk bereitgestellt ist, wird der Server sofort Delegierter; andernfalls bestätigen Sie die Transaktion mit Ihrem Händlerschlüssel in jedem bereitgestellten Netzwerk. Ein bisheriger Delegierter wird ersetzt. Ein Wechsel des Delegierten ist eine Sicherheitsänderung und pausiert bei aktivem Cooldown die Auszahlungen.
- Sobald der Server Delegierter ist, erlaubt Invoise seinem Co-Signer, die Signatur des Servers für Ihre Empfängeradresse zu akzeptieren, und der Status wird Aktiv.
| Status | Bedeutung |
|---|---|
| Deaktiviert | Automatische Auszahlungen sind aus. |
| Wartet auf Delegierten | Der Schlüssel des Servers ist weder Ihr Händlerschlüssel noch der Delegierte der Wallet: Drücken Sie Zum Delegierten machen. |
| Neuer Versuch nach Fehler | Der letzte Versuch ist fehlgeschlagen; das Dashboard zeigt den Fehler und die Fehlschläge in Folge. |
| Aktiv | Auszahlungen laufen nach den Regeln. |
Ein neuer Signaturserver, der bei aktivem Cooldown gespeichert wird, wartet wie jede Lockerung auf den Cooldown. Machen Sie ihn zum Delegierten, bevor die Änderung wirkt, verweisen die aktuellen Einstellungen auf einen Server, der nicht mehr Delegierter ist, und bis die Änderung greift, wird nichts ausgezahlt.
Signaturserver-Protokoll
Abschnitt betitelt „Signaturserver-Protokoll“Anfragen
Abschnitt betitelt „Anfragen“Invoise sendet jede Anfrage als POST an die URL Ihres Signaturservers, mit einem JSON-Body, Content-Type: application/json, User-Agent: Invoise-Automation/1 und dem Header Invoise-Signature: t=<unix time>,v1=<hex>. Die Signatur ist HMAC-SHA256 über t + "." + raw_body. Der HMAC-Schlüssel ist die gesamte Geheimnis-Zeichenkette, wie sie im Dashboard angezeigt wird, einschließlich des Präfixes ias_ (ias_ und 64 Hex-Zeichen).
Das ist das Schema der Webhooks, und die dortige Funktion verify funktioniert mit diesem Geheimnis unverändert. Der Server MUSS eine Anfrage ablehnen, deren Signatur sich nicht verifizieren lässt oder deren t mehr als 5 Minuten von seiner eigenen Uhr abweicht. Die Signatur deckt nur Zeit und Body ab, daher MUSS der Server eine wiederholte operation_id mit den bereits gegebenen Signaturen oder mit einer Ablehnung beantworten und darf unter derselben operation_id nie andere Daten signieren.
Der Server antwortet mit 200 und einem JSON-Body; jeder andere Status ist eine Ablehnung. Die gesamte Antwort muss innerhalb von 30 Sekunden eintreffen und darf höchstens 1 MiB groß sein. Weiterleitungen werden nicht verfolgt.
identify
Abschnitt betitelt „identify“Wird gesendet, wenn Sie eine neue Signaturserver-URL speichern. Die aus der Antwort wiederhergestellte Adresse wird zum Serverschlüssel. Er gilt, sobald er Ihr Händlerschlüssel oder der Delegierte der Wallet ist; jeden anderen Schlüssel machen Sie dann zum Delegierten.
{ "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"}Antworten Sie mit einer EIP-191-Signatur (personal_sign) von message, genau wie empfangen, erstellt mit dem Schlüssel des Servers (dem Delegiertenschlüssel oder Ihrem Händlerschlüssel), und der Adresse dieses Schlüssels:
{ "address": "0x5b38da6a701c568545dcfcb03fcb875f56beddc4", "signature": "0x…" }Die Adresse muss diejenige sein, auf die die Signatur zurückführt, und darf nicht der Invoise-Co-Signer sein.
Wird einmal pro automatischer Auszahlung gesendet. Diese hier bewegt USDT0 und USDC von Arbitrum zu USDC auf 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 } ]}| Feld | Bedeutung |
|---|---|
operation_id |
Eine automatische Auszahlung. |
source_chain_id, chain_id, token, amount, payee |
Das Quellnetzwerk der Regel und was im Zielnetzwerk beim Empfänger ankommt. |
total_fee_usd |
Die Netzwerkgebühr aller Schritte in USD. |
legs |
Die zu signierenden Safe-Transaktionen. Ein CCTP-Empfang oder ein Across-Fill braucht keine Signatur, daher können Positionen Nummern überspringen. |
safe |
Die Safe-Adresse der Wallet im Netzwerk des Schritts. |
intent |
withdraw, swap, burn oder bridge. |
safe_tx |
Die Safe-Transaktion: to, value, data, operation, nonce. |
fee, fee_recipient |
Die Netzwerkgebühr des Schritts und wohin sie gezahlt wird. |
swap, bridge |
Der Swap oder die Across-Einzahlung des Schritts, sonst null. |
deploys |
Der Safe hat in diesem Netzwerk noch keinen Code: Er wird in derselben Transaktion bereitgestellt, und die Nonce ist 0. |
Beträge, Nonces und value sind Dezimal-Strings in Token-Einheiten; decimals und operation sind Zahlen.
Antworten Sie mit einer Signatur pro Schritt:
{ "signatures": [ { "position": 0, "signature": "0x…" }, { "position": 1, "signature": "0x…" }, { "position": 3, "signature": "0x…" } ] }Jede Signatur ist die 65-Byte-ECDSA-Signatur des Serverschlüssels (r‖s‖v, v als 27/28 oder 0/1) über den SafeTx-Hash des Schritts. Eine Signatur, die weder auf den Delegierten der Wallet noch auf Ihren Händlerschlüssel zurückführt, lässt die Auszahlung mit automation_signature_invalid fehlschlagen.
Was der Server prüfen muss
Abschnitt betitelt „Was der Server prüfen muss“Der Serverschlüssel ist eine der zwei Signaturen, die der Safe braucht; Ihr Server ist also die Prüfung, die verhindert, dass Invoise je allein handelt. Bevor er einen Schritt signiert, MUSS er:
-
Den Hash selbst berechnen. Er berechnet den EIP-712-Hash von Safe 1.4.1 und signiert nur diesen, nie das Feld
hashwie geliefert. Domain:EIP712Domain(uint256 chainId,address verifyingContract)mitchain_idundsafedes Schritts. Nachricht:SafeTx(address to,uint256 value,bytes data,uint8 operation,uint256 safeTxGas,uint256 baseGas,uint256 gasPrice,address gasToken,address refundReceiver,uint256 nonce)mitto,value,data,operationundnonceaussafe_tx,safeTxGas,baseGasundgasPricegleich 0 sowiegasTokenundrefundReceivergleich der Nulladresse.safemuss die Wallet sein, die er in diesem Netzwerk bedient. -
Den Batch prüfen.
operation1 (DELEGATECALL) ist nur anMultiSendCallOnly0x9641d764fc13c8b624c04430c7356c1c7c8102e2mit dem AufrufmultiSend(bytes)erlaubt, und jedes Element des Batches muss ein einfacher Aufruf (operation 0) mit Wert 0 sein. Ein einzelner Aufruf kommt mitoperation0. Jeder andere DELEGATECALL und jede Safe-Verwaltung wird abgelehnt:swapOwner,addOwnerWithThreshold,removeOwner,changeThreshold,enableModule,disableModule,setGuard,setFallbackHandler,execTransactionFromModuleoder jeder Aufruf an den Safe selbst. -
Jeden Aufruf prüfen. Genau ein
transfer(fee_recipient, fee.amount)vonfee.token. Einapprovenur über den exakten Betrag, den der nächste Aufruf ausgibt: answap.spenderfürswap.token_inundswap.amount_in, an den CCTP-TokenMessengerV20x28b5a0e9c621a5badaa536219b3a228c8168cf5dfür den verbrannten Betrag oder anbridge.spoke_poolfürbridge.token_inundbridge.amount_in. Dann je nachintent:withdraw: eintransferdes Auszahlungs-Tokens an die Empfängeradresse, die der Server gespeichert hat;swap: ein Aufruf answap.router, dessen Ergebnis im Safe bleibt;burn:depositForBurnauf TokenMessengerV2 mitmintRecipientgleich dem Safe, auf 32 Bytes aufgefüllt;bridge:depositV3aufbridge.spoke_poolmit dem Safe als Einzahler und als Empfänger.
Alles andere wird abgelehnt.
-
Eigene Limits anwenden. Er vergleicht
amountundtotal_fee_usdmit eigenen Limits, etwa pro Auszahlung, pro Tag und Gebührenanteil, und den Empfänger mit seiner eigenen Konfiguration, nie mitpayeeaus der Anfrage.
Der Invoise-Co-Signer wendet dieselben Regeln an, bevor er signiert; eine korrekte Anfrage besteht sie also immer. Der Server wiederholt sie, weil er Invoise nicht vertrauen darf.
Einstellungen lesen
Abschnitt betitelt „Einstellungen lesen“Ihr Server kann bei Invoise lesen, womit er Anfragen abgleicht, und signiert dabei mit demselben Secret. Senden Sie GET an https://platform.invoise.me/api/v1/automation/<Ressource>?wallet=<Safe-Adresse> mit dem Header Invoise-Signature: t=<Unix-Zeit>,v1=<hex>, wobei v1 HMAC-SHA256 über t + "." + Pfad und Query ist, zum Beispiel 1791200000./api/v1/automation/settings?wallet=0x41d9…. Das ist die Signaturfunktion der Webhooks mit dem Anfragepfad statt des Bodys. t darf höchstens 5 Minuten von der Uhr von Invoise abweichen. Eine falsche Signatur, ein veraltetes t, eine unbekannte Wallet und eine Wallet ohne Secret erhalten gleichermaßen 401.
| Pfad | Antwort |
|---|---|
/automation/settings |
Empfänger, Regeln, Limits, Status und ausstehende Änderung; owners (merchant, delegate, cosigner), server_key_role (merchant, delegate oder leer) und die Schutzmechanismen der Wallet protections (Tageslimit, Cooldown, Pause). |
/automation/networks |
Pro Netzwerk: safe, deployed, tokens, fee_recipient, multisend und, wo das Netzwerk sie unterstützt, cctp (token_messenger, domain, usdc), swap (router, spender) und across (spoke_pool), sonst null. |
/automation/operations |
Automatische Auszahlungen, neueste zuerst, mit Schritten, Status und Transaktions-Hashes; limit von 1 bis 100, standardmäßig 50. |
/automation/operations/{id} |
Eine automatische Auszahlung, zum Beispiel die operation_id einer sign-Anfrage. |
Nutzen Sie die Antworten, um die eigene Konfiguration des Servers zu füllen und abzugleichen, aber nicht als Prüfung selbst. Sie kommen von demselben Invoise, gegen das Ihr Server absichert; Empfänger, Limits und erlaubte Verträge, gegen die der Server signiert, müssen daher seine eigenen sein.
Diese Codes erscheinen im Dashboard, im Fehlerhinweis und beim Speichern der Einstellungen.
| Code | Bedeutung |
|---|---|
automation_server_unreachable |
Der Server hat nicht innerhalb von 30 Sekunden geantwortet, oder seine URL ist keine öffentliche HTTPS-Adresse mehr. |
automation_server_refused |
Der Server hat mit einem anderen Status als 200 geantwortet; meist hat er noch ein altes Geheimnis. |
automation_server_invalid |
Die Antwort war kein gültiges JSON der erwarteten Form, die identify-Signatur führt nicht auf die angegebene Adresse zurück, oder der Schlüssel ist der Co-Signer. |
automation_signature_invalid |
Eine Signatur führt weder auf den Delegierten der Wallet noch auf Ihren Händlerschlüssel zurück: Der Schlüssel des Servers hat sich geändert. Speichern Sie die URL erneut, damit sich der Server ausweist, und machen Sie ihn dann zum Delegierten, falls es nicht Ihr Händlerschlüssel ist. |
route_unavailable, swap_quote_failed |
Keine Bridge- oder Swap-Route kann dieses Guthaben derzeit bewegen. Erhöhen Sie den Schwellenwert oder verwenden Sie eine Regel innerhalb eines Netzwerks. |