Ein Checkout für drei Verkäufer mit 4% Provision und geprüften Auszahlungsregeln.
1. Bereite das Projekt vor
Öffne Project → Marketplace → Settings. Aktiviere Marketplace und wähle die beteiligten Stores. Lass Auszahlungen zunächst pausiert. Sichere die Projekt-Wallets und aktiviere Bitcoin oder unterstützte EVM-Methoden in den Stores.
Kunden zahlen zuerst in diese Projekt-Wallets. Du kontrollierst die Schlüssel und schuldest Verkäufern die erfassten Beträge. Halte freie native Coins für Gebühren bereit. Normale Sweeps können Marketplace-Empfangsadressen nicht ausgeben.
2. Lege drei Verkäufer an
Füge unter Vendors jeden Verkäufer mit einer Bitcoin-Mainnet-Adresse hinzu. Bestätige die Adresse unabhängig mit dem Verkäufer, bevor du sie freigibst. Für EVM-Token braucht jeder Verkäufer auch eine freigegebene Adresse im genauen Netzwerk.
Setze die Projektprovision auf 4%. Abweichende Store-, Verkäufer- und autorisierte Rechnungswerte werden festgehalten. Spätere Änderungen verändern keine bestehende Zuteilung.
3. Erstelle die gemeinsame Rechnung
Erstelle unter Marketplace → Invoices eine Rechnung über 300 USD mit drei Brutto-Verkäuferanteilen von je 100 USD. Die Summe muss genau stimmen. Schicke dem Kunden den Checkout-Link.
Für die API nutzt du einen separaten Marketplace-Key und Dezimal-Strings an /v1/marketplace/invoices. Speichere den Idempotency-Key vor der Anfrage und nutze ihn nach einem Timeout erneut. Anfragebeispiele →
4. Prüfe und zahle aus
Warte, bis verifizierte Zuteilungen verfügbar sind. Zum festgehaltenen Kurs bekommt jeder Verkäufer 96 USD Gegenwert im bezahlten Asset. Du behältst 12 USD Provisionsgegenwert. Die bestehende 1%-Verarbeitungsgebühr kostet, wenn so eingestellt, 3 USD vorausbezahltes Guthaben. Chain-Gebühren kommen dazu.
Bereite unter Payouts verfügbare Zuteilungen vor und begrenze native Gebühren und Gas. Bei Bitcoin gehören alle unbezahlten Anteile einer gewählten Rechnung in denselben Batch. Prüfe die genauen Empfänger und den Plan, gib einmal frei und verfolge den Status bis Paid, nicht nur Broadcast.
5. Aktiviere die Automatik bewusst
Lege unter Settings eine Regel je Asset an: Mindestbetrag, Limits je Auszahlung und Tag, native Gebühren- und Gasbudgets, Intervall und Bestätigungen. Prüfe Limits und Ziele, aktiviere die Regel und hebe dann die Auszahlungspause auf.
Automatische Regeln dürfen ohne weitere Klicks senden. Wenig Verarbeitungsguthaben oder die Transfersperre des Servers pausieren weiterhin Ausgaben. Überwachung und Journal laufen weiter.
6. Kläre Ausnahmen ohne doppelte Zahlungen
- Unterzahlung: Checkout-Toleranz erzeugt keine ungedeckten Verkäuferguthaben. Warte auf Nachzahlung, erstatte oder gib ausdrücklich eine kleinere, voll gedeckte Aufteilung frei.
- Token-Gas fehlt: Fülle freie native Coins im Projekt-Wallet auf und prüfe die bestehende Auszahlung. Lege keine zweite an, um sie zu umgehen.
- Webhook-Timeout: Wiederhole dasselbe signierte Ereignis. Prüfe Originalsignatur und Projekt, speichere event_id eindeutig und bestätige dann. Eine abgeschlossene Rechnung ist noch keine abgeschlossene Auszahlung.
- Erstattung nach Auszahlung: Fülle die primäre Wallet-Adresse separat auf, prüfe die Kundenadresse, bereite eine vollständige Erstattung im selben Asset vor und gib sie frei. Verkäufer werden nicht automatisch belastet.
- Wiederherstellung oder unklarer Broadcast: Lass Auszahlungen pausiert und gleiche gespeicherte Transaktions-Hashes ab, bevor du fortsetzt. Ein Timeout bedeutet nicht, dass nichts gesendet wurde.