Kurz gefasst
Krypto-Massenauszahlungen brauchen eine Warteschlange mit begrenzter Parallelität und Backoff bei Fehlern. Über POST /v1/withdrawals erstellen Sie jeweils eine Auszahlung an einen Empfänger. Speichern Sie external_order_id und Nutzdaten vor dem ersten Aufruf und verwenden Sie beides bei Wiederholungen unverändert. Das gemeinsame Kontolimit von standardmäßig 30 Anfragen pro Sekunde ist keine Zusage zur Zahl abgeschlossener Transfers. Manuelle Dashboard-Sammelläufe unterstützen bis zu 50 Empfänger derselben Währung im selben Netzwerk, ausschließlich in Production. Paymos erhebt 0 % Auszahlungsprovision und subventioniert die ausgewiesene Netzwerkgebühr.
Massenhafte Auszahlungen in Kryptowährungen sind für moderne Plattformen unverzichtbar: Affiliate-Netzwerke, Gaming-Anbieter, Krypto-Börsen und globale Arbeitgeber zahlen täglich Tausende Empfänger aus.
Im Gegensatz zu traditionellen Sammelüberweisungen verlangt die Blockchain kryptografischen Konsens, fortlaufende Nonces und unumkehrbare Transaktionen. Ein einziger Fehler kann die gesamte Pipeline blockieren.
Das Nonce-Problem bei sequentiellen Auszahlungen
Auf EVM-Chains müssen Transaktionen eines Kontos nach Nonce-Zähler (0, 1, 2...) ausgeführt werden. Bleibt eine Transaktion ausstehend, können spätere Transaktionen dieses Kontos warten. Die Häufigkeit von API-Anfragen entspricht deshalb nicht der Zahl abgeschlossener Transfers.
Transactional Outbox Pattern
Das Outbox-Muster verbindet Ihre Buchung mit dem lokalen Auszahlungsauftrag. Speichern Sie beides in einer Datenbanktransaktion, einschließlich external_order_id und Nutzdaten. Vergeben Sie pro Auszahlung genau eine external_order_id und speichern Sie sie vor dem ersten Aufruf. Ein Worker sendet den Auftrag und verwendet bei Wiederholungen dieselbe gespeicherte ID mit unveränderten Nutzdaten. Weitere Details finden Sie in unserem Leitfaden zur Idempotenz von Zahlungs-Webhooks.
Multi-Vault-Architektur
Ihre Integration verfolgt die Warteschlange und den Status jeder Auszahlung. Begrenzen Sie parallele Aufrufe und planen Sie Wiederholungen mit Backoff; beachten Sie bei HTTP 429 den Header Retry-After. Empfängeradressen müssen normalerweise auf der Freigabeliste stehen. Details zum Schutz privater Schlüssel bietet unser Artikel über Hot-Wallet-Sicherheit.
Netzwerkgebühren: Auszahlungssubventionen und TRON-Energie
Paymos erhebt 0 % Auszahlungsprovision. Sie zahlen nur die ausgewiesene Netzwerkgebühr der Route, und jede Auszahlungsroute ist subventioniert: Sie zahlen weniger, als die Chain berechnet. Schlägt eine Auszahlung fehl oder wird sie storniert, gehen der gesamte reservierte Betrag und die Gebühr an das verfügbare Guthaben zurück.
Auf TRON beeinflussen Energie und andere Netzwerkressourcen die Transferkosten. Rechnen Sie mit der ausgewiesenen Gebühr der gewählten Auszahlungsroute statt mit festen Dollarkosten pro Transfer. Die Gebühren finden Sie auf der Paymos-Preisseite, Hintergründe in unserem Leitfaden über TRON-Energie-Miete.
Integration über die REST API für Entwickler
Ihr Backend sendet über die Host-to-Host REST API pro Empfänger einen authentifizierten POST /v1/withdrawals. Verwenden Sie dafür einen Payout-Schlüssel (rk_) mit HMAC-SHA256-Authentifizierung; Zieladressen müssen normalerweise auf Ihrer Auszahlungs-Whitelist stehen. Die Header-Werte im Beispiel sind Platzhalter.
POST /v1/withdrawals HTTP/1.1
Host: api.paymos.io
Authorization: HMAC-SHA256 rk_live_<key_id>:<base64_signature>
X-Request-Timestamp: <current_unix_seconds>
Content-Type: application/json
{
"currency": "USDT",
"network": "TRC20",
"amount": "25.00",
"destination_address": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
"external_order_id": "payout_usr_101"
}
Eine neue Auszahlung liefert HTTP 201 Created mit dem Status created; eine Wiederholung mit derselben external_order_id liefert HTTP 200 OK und die bestehende Auszahlung. Beträge und Gebühren im Beispiel sind illustrativ und kein Tarif:
{
"withdrawal_id": "wdr_7K2M9P4Q8R1X5Z3A0bC2dE",
"external_order_id": "payout_usr_101",
"status": "created",
"is_final": false,
"is_test": false,
"amount": "25.00",
"fee": "0.50",
"currency": "USDT",
"network": "TRC20",
"destination_address": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
"created_at": 1739277600
}
Das Standardkontingent von 30 Anfragen pro Sekunde gilt gemeinsam für alle API-Aufrufe des Kontos. Begrenzen Sie die Parallelität Ihrer Worker, warten Sie bei Wiederholungen mit Backoff und beachten Sie bei HTTP 429 den Header Retry-After; das Kontingent garantiert keine Rate abgeschlossener Transfers. Im Merchant-Dashboard sind zusätzlich manuelle Sammelläufe mit bis zu 50 Empfängern derselben Währung im selben Netzwerk möglich, ausschließlich in Production.
Nach dem Abschluss sendet Paymos withdrawal.completed im versionierten Webhook-Umschlag:
{
"event_id": "evt_CbYeOgBp9Kt2U3j74fxxLl",
"event_type": "withdrawal.completed",
"version": 1,
"occurred_at": 1739281200,
"data": {
"withdrawal_id": "wdr_7K2M9P4Q8R1X5Z3A0bC2dE",
"external_order_id": "payout_usr_101",
"status": "completed",
"is_final": true,
"is_test": false,
"amount": "25.00",
"fee": "0.50",
"currency": "USDT",
"network": "TRC20",
"destination_address": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
"tx_hash": "7f8a9b0c1d2e3f4a5b6c7d8e9f00112233445566778899aabbccddeeff001122",
"explorer_url": "https://tronscan.org/#/transaction/7f8a9b0c1d2e3f4a5b6c7d8e9f00112233445566778899aabbccddeeff001122",
"created_at": 1739277600,
"completed_at": 1739281200
}
}
Eine fehlgeschlagene Auszahlung löst withdrawal.failed aus, eine Stornierung withdrawal.cancelled; in beiden Fällen gehen der gesamte reservierte Betrag und die Gebühr an das verfügbare Guthaben zurück. Prüfen Sie Webhook-Signaturen anhand des unveränderten Bodys, entfernen Sie doppelte Zustellungen anhand der event_id und verbuchen Sie Änderungen über data.withdrawal_id, ohne eine bestimmte Zustellreihenfolge vorauszusetzen. Bei withdrawal.completion_rewound kehrt eine abgeschlossene Auszahlung zu signed zurück; verfolgen Sie ihren Status weiter.
Informieren Sie sich auch über Auszahlungsgeschwindigkeiten und SaaS-Lösungen.
| Architekturmuster | Versandmodell | Nonce-Verwaltung | Relativer Gas-Aufwand | Optimal für |
|---|---|---|---|---|
| 1. Sequentielle RPC-Schleife | Abhängig von Netzwerk und Implementierung | Muss die Implementierung behandeln | Abhängig von Netzwerk und Ressourcen | Testprojekte, interne Tools |
| 2. Dashboard-Sammellauf | Bis zu 50 Empfänger derselben Währung im selben Netzwerk; nur Production | Keine eigene Nonce-Verwaltung | Ausgewiesene Netzwerkgebühr | Regelmäßige Gehaltsläufe, Partnernetzwerke |
| 3. Automatisierte API-Outbox (POST /v1/withdrawals) | Standardmäßig 30 Anfragen/Sekunde, gemeinsames Kontolimit | Keine eigene Nonce-Verwaltung | Subventionierte Netzwerkgebühr; 0 % Paymos-Provision | Börsen, iGaming, hochfrequente Plattformen |
Häufige Fragen
Warum blockieren sequentielle Krypto-Auszahlungen bei hoher Last?
Auf EVM-Blockchains werden Transaktionen desselben Absenders in Nonce-Reihenfolge ausgeführt. Bleibt eine davon ausstehend, können spätere Transaktionen dieses Absenders ebenfalls warten.
Wie werden doppelte Auszahlungen bei Netzwerkabbrüchen verhindert?
Speichern Sie den Auszahlungsauftrag mit seiner external_order_id vor dem ersten Aufruf. Verwenden Sie bei Wiederholungen derselben Auszahlung diese ID und dieselben Nutzdaten unverändert. Der erste erfolgreiche Aufruf liefert HTTP 201 mit dem Status created; eine Wiederholung liefert die bestehende Auszahlung mit HTTP 200 zurück.
Wie senken Automatisierung und Batching die Transaktionsgebühren?
Paymos erhebt 0 % Auszahlungsprovision und subventioniert die ausgewiesene Netzwerkgebühr. Daraus folgt keine garantierte Gebührenersparnis durch Batching. Im Dashboard sind manuelle Sammelläufe mit bis zu 50 Empfängern derselben Währung im selben Netzwerk möglich, ausschließlich in Production.
Was passiert bei sanktionierten Empfängeradressen?
Bevor eine Auszahlung geroutet wird, prüft Paymos die Empfängeradresse anhand von TRM Labs, Binance AML, AMLBot, PureFi und der Datenbank des Screening-Anbieters. Besteht die Adresse die Prüfung nicht, wird die Auszahlung nicht gesendet und erhält den Status failed. Der gesamte reservierte Betrag samt Netzwerkgebühr wird dem verfügbaren Guthaben wieder gutgeschrieben.
Wann Krypto-Massenauszahlungs-APIs NICHT passt
- Wenn Sie einzelne Auszahlungen ohne eigene API-Integration im Dashboard erledigen können.
- Wenn Sie seltene NFTs oder illiquide Altcoins mit manuellem Treuhand-Bedarf versenden.
- Wenn Ihr Backend keine transaktionale Outbox mit garantierter Idempotenz betreiben kann.
- Wenn Ihre Compliance-Richtlinie für jede ausgehende Transaktion unabhängig vom Betrag die Freigabe durch zwei Personen verlangt: Paymos hat keine mehrstufige Freigabekette, bauen Sie diese also in Ihrem eigenen Backoffice, bevor Sie die API aufrufen.
Quellen
Zuletzt geprüft 7. Nov. 2026


