Shop-Escrow: Sichere Auszahlungen fĂĽr Shop-Besitzer
Wenn ein Spieler ein Produkt aus einem benutzereigenen Shop kauft, wird die Zahlung nicht mehr sofort an den Shop-Besitzer gesendet. Stattdessen werden die Coins vom Server in Escrow gehalten, bis der Käufer den Erhalt der Ware bestätigt. Erst dann erhält der Shop-Besitzer seine Auszahlung — 98% on-chain, mit einer 2% Server-Provision.
Warum Escrow?
Ohne Escrow könnte ein Shop-Besitzer die Zahlung erhalten und die Ware nie liefern. Der Käufer hätte keine Möglichkeit, sich zu wehren. Escrow schützt beide Seiten:
- Käufer können eine Bestellung anfechten, wenn die Ware nicht geliefert wird oder nicht wie beschrieben ist. Die Auszahlung wird eingefroren, bis ein Administrator den Fall prüft.
- Shop-Besitzer erhalten ihre Auszahlung garantiert, sobald der Käufer bestätigt — oder automatisch nach 7 Tagen, wenn der Käufer nicht reagiert.
So funktioniert es
1 Käufer zahlt
Der Käufer sendet die volle Zahlung an die Operator-Wallet des Servers. Die Coins werden in Escrow gehalten. Der Bestellstatus wird auf escrow gesetzt.
2 Käufer bestätigt Erhalt
Der Käufer ruft POST /shop/confirm-receipt auf, um zu bestätigen, dass er die Ware erhalten hat. Der Server sendet sofort 98% der Zahlung on-chain an die Wallet des Shop-Besitzers. Der Server behält eine 2% Provision ein.
3 Automatische Freigabe nach 7 Tagen
Wenn der Käufer innerhalb von 7 Tagen weder bestätigt noch anfechtet, wird die Auszahlung automatisch an den Shop-Besitzer freigegeben. Ein Background-Worker prüft stündlich auf abgelaufene Escrows.
4 Streitbeilegung
Wenn der Käufer unzufrieden ist, kann er POST /shop/dispute aufrufen, um die Auszahlung einzufrieren. Ein Administrator prüft den Fall dann über POST /shop/admin/resolve-payout und entweder:
- Gibt die Auszahlung an den Shop-Besitzer frei, oder
- Erstattet — die Auszahlung wird storniert und die Coins verbleiben beim Server (der Käufer kann manuell entschädigt werden).
Referenz der Auszahlungsstatus
| Status | Bedeutung |
|---|---|
none | Offizieller Shop oder keine Bestellung |
escrow | Coins vom Server gehalten, wartet auf Käuferbestätigung |
disputed | Käufer hat angefochten, Admin-Prüfung ausstehend |
paid | 98% on-chain an den Besitzer gesendet |
refunded | Admin hat Auszahlung storniert, Coins verbleiben beim Server |
failed | On-chain-Ăśbertragung fehlgeschlagen |
API-Endpunkte
| Endpunkt | Wer | Zweck |
|---|---|---|
POST /shop/confirm-receipt | Käufer | Erhalt bestätigen → Escrow freigeben |
POST /shop/dispute | Käufer | Bestellung anfechten → Escrow einfrieren |
POST /shop/admin/resolve-payout | Admin | Streitfall beilegen (freigeben oder erstatten) |
GET /shop/my-payouts | Shop-Besitzer | Escrow- + Auszahlungssummen und Verlauf einsehen |
Wallet-Auswahl
Die Auszahlung wird an die Wallet des Shop-Besitzers auf derselben Chain wie die Zahlung gesendet:
| Zahlungswährung | Verwendete Owner-Wallet |
|---|---|
| CC (Cash Coins) | CC wallet (Fallback: KC wallet) |
| KC (Keshe Coins) | KC wallet |
Erlösaufteilung
| Empfänger | Anteil |
|---|---|
| Shop-Besitzer | 98% |
| Server-Provision | 2% |
Die 2% Provision deckt Infrastrukturkosten: Blockchain-Gas (wo zutreffend), Server-Hosting und den Escrow-Service selbst.
Offizielle Shops
Offizielle Erleuchtung-Shops (servereigene, owner_id IS NULL) sind vom Escrow-System ausgeschlossen. Zahlungen fĂĽr offizielle Shop-Produkte gehen direkt an den Server, ohne Aufteilung der Auszahlung.
Was kommt als Nächstes?
Das Escrow-System ist jetzt live. Shop-Besitzer können ihre ausstehenden Escrow-Guthaben und ausgezahlten Erträge über den Endpunkt GET /shop/my-payouts verfolgen. Ein Frontend-Dashboard zur Verwaltung von Auszahlungen, zur Bestätigung von Wareneingängen und zum Einreichen von Streitfällen wird in einem kommenden Release folgen.