← Alle Tutorials

TUTORIAL 13 / 13

Ergänze deinen Krypto-Checkout um Kartenzahlungen.

Verbinde dein eigenes Anbieterkonto, teste es und aktiviere Karten für die gewünschten Stores.

Dein Ziel

Kartenzahlung neben Wallet-Zahlungen, mit USDC-Eingang auf Base in deiner Rechnungs-Wallet.

1. Prüfe dein Coinflow-Konto

Nutze Wholly Crypto 9.0.0 oder neuer. Lass dein Unternehmen bei Coinflow freigeben und USDC-Auszahlungen auf Base an eigene Empfangsadressen je Rechnung aktivieren. Für den Live-Betrieb müssen Kunden die Anbietergebühren tragen; es darf keine Rücklagen oder Abzüge bei der Auszahlung geben.

Verfügbarkeit, Identitätsprüfung, Limits und Anbietergebühren hängen von deinem Coinflow-Konto und dem Standort des Kunden ab. Prüfe vor dem Bezahlen den Endpreis bei Coinflow.

Coinflow Dokumentation · Aktueller On-Ramp-Anbieter

2. Verbinde und teste in der Sandbox

Öffne Settings → Fiat payments. Speichere deine Coinflow Merchant ID, den API Key und den Webhook Validation Key. Hinterlege die angezeigte Callback-URL bei Coinflow und prüfe die Verbindung. Zugangsdaten bleiben auf dem Server; teile niemals Wallet-Schlüssel.

Der Sandbox-Checkout für Administratoren ist ein separater 10-USD-Test mit einer Sandbox-Empfangsadresse. Er bezahlt keine echte Rechnung. Ein erfolgreicher Verbindungstest bestätigt allein noch keine Freigabe für dein Unternehmen oder deine Zahlungen.

3. Aktiviere Base-USDC in deinem Store

Sichere deine Projekt-Wallet und prüfe den Base-Scanner. Akzeptiere unter Store → Payment methods natives USDC auf Base und aktiviere Kartenzahlungen. Nutze USDC, nicht USDbC oder USDC auf Ethereum. Ohne Base-USDC bietet eine Rechnung keine Kartenzahlung an.

4. Teste eine kleine echte Zahlung

Aktiviere nach der Coinflow-Freigabe den Live-Betrieb und erstelle eine normale Rechnung manuell oder per API. Wähle im Checkout Kartenzahlung. Die Rechnung behält Währung, Kursangebot und Aufschlag; Coinflow zeigt dem Kunden vor der Zahlung die endgültigen Gebühren und Umrechnung.

5. Prüfe den Eingang vor der Auslieferung

Eine Rechnung wird erst abgeschlossen, wenn USDC eingegangen ist und deine Blockchain-Bestätigungen erreicht sind. Eine Kartenfreigabe oder die Rückkehr zum Checkout ist kein Zahlungsnachweis.

Prüfe die Kartenzahlungsdetails der Rechnung und die USDC-Transaktion auf Base. Nutze deinen normalen Ablauf mit signierter IPN oder Webhooks. Reagiere auf invoice.settled und prüfe requires_review; liefere nie nur aufgrund der Browser-Rückkehr aus. Verspätete oder widersprüchliche Zahlungen können eine Prüfung brauchen.

API, IPN & Webhooks

6. Übertrage Guthaben und kläre Ausnahmen

Halte ETH auf Base bereit, um empfangenes USDC an deine Cold Wallet zu senden, oder richte automatische Gas-Finanzierung und Sweeps ein. Kläre Kartenerstattungen und Rückbuchungen bei Coinflow. Erstatte nie Krypto an den Transaktionsabsender des Anbieters. Prüfe Streitfälle unter Needs attention.

Automatischer Sweep