Zum Inhalt springen

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.

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.

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.

  1. Betreiben Sie unter einer öffentlichen HTTPS-URL einen Signaturserver, der dem Protokoll folgt. Lokale und private Adressen werden abgelehnt.
  2. Ö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.
  3. 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.
  4. 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.
  5. 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.

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.

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.

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:

  1. Den Hash selbst berechnen. Er berechnet den EIP-712-Hash von Safe 1.4.1 und signiert nur diesen, nie das Feld hash wie geliefert. Domain: EIP712Domain(uint256 chainId,address verifyingContract) mit chain_id und safe des Schritts. Nachricht: SafeTx(address to,uint256 value,bytes data,uint8 operation,uint256 safeTxGas,uint256 baseGas,uint256 gasPrice,address gasToken,address refundReceiver,uint256 nonce) mit to, value, data, operation und nonce aus safe_tx, safeTxGas, baseGas und gasPrice gleich 0 sowie gasToken und refundReceiver gleich der Nulladresse. safe muss die Wallet sein, die er in diesem Netzwerk bedient.

  2. Den Batch prüfen. operation 1 (DELEGATECALL) ist nur an MultiSendCallOnly 0x9641d764fc13c8b624c04430c7356c1c7c8102e2 mit dem Aufruf multiSend(bytes) erlaubt, und jedes Element des Batches muss ein einfacher Aufruf (operation 0) mit Wert 0 sein. Ein einzelner Aufruf kommt mit operation 0. Jeder andere DELEGATECALL und jede Safe-Verwaltung wird abgelehnt: swapOwner, addOwnerWithThreshold, removeOwner, changeThreshold, enableModule, disableModule, setGuard, setFallbackHandler, execTransactionFromModule oder jeder Aufruf an den Safe selbst.

  3. Jeden Aufruf prüfen. Genau ein transfer(fee_recipient, fee.amount) von fee.token. Ein approve nur über den exakten Betrag, den der nächste Aufruf ausgibt: an swap.spender für swap.token_in und swap.amount_in, an den CCTP-TokenMessengerV2 0x28b5a0e9c621a5badaa536219b3a228c8168cf5d für den verbrannten Betrag oder an bridge.spoke_pool für bridge.token_in und bridge.amount_in. Dann je nach intent:

    • withdraw: ein transfer des Auszahlungs-Tokens an die Empfängeradresse, die der Server gespeichert hat;
    • swap: ein Aufruf an swap.router, dessen Ergebnis im Safe bleibt;
    • burn: depositForBurn auf TokenMessengerV2 mit mintRecipient gleich dem Safe, auf 32 Bytes aufgefüllt;
    • bridge: depositV3 auf bridge.spoke_pool mit dem Safe als Einzahler und als Empfänger.

    Alles andere wird abgelehnt.

  4. Eigene Limits anwenden. Er vergleicht amount und total_fee_usd mit eigenen Limits, etwa pro Auszahlung, pro Tag und Gebührenanteil, und den Empfänger mit seiner eigenen Konfiguration, nie mit payee aus 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.

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.