Stablecoin-Zahlungen annehmen
Beginnen Sie mit der Annahme von Stablecoins, indem Sie die Zahlungsmethode „Krypto“ aktivieren.
Sie können Stablecoin-Zahlungen über Payment Links, Checkout, Elements oder die Payment Intents API akzeptieren. Beim Bezahlen mit Stablecoins wie USDC werden Kundinnen und Kunden zu crypto.stripe.com weitergeleitet, um ihre Krypto-Wallet zu verbinden und die Transaktion abzuschließen. Die Gelder werden in USD auf Ihrem Stripe-Guthaben gutgeschrieben.
Bevor Sie loslegen
Regionale AspekteVereinigte Staaten
Kundinnen und Kunden können Stablecoins weltweit als Zahlungsmittel verwenden, doch derzeit können nur US-Unternehmen Stablecoin-Zahlungen akzeptieren.
Um Stablecoin-Zahlungen zu akzeptieren, aktivieren Sie die Zahlungsmethode Krypto:
- Stellen Sie sicher, dass Ihr Stripe-Konto aktiv ist.
- Gehen Sie zu Einstellungen > Zahlungen > Zahlungsmethoden und fordern Sie die Crypto-Zahlungsmethode an.
- Stripe prüft Ihre Anfrage und kann Sie bei Bedarf für weitere Informationen kontaktieren. In diesem Fall wird die Zahlung als ausstehend angezeigt, während wir Ihre Anfrage prüfen.
- Sobald Sie die Genehmigung erhalten haben, wird Krypto im Dashboard aktiv.
Verwendung mit dynamischen Zahlungsmethoden Recommended
Wenn Sie die standardmäßigen dynamischen Zahlungsmethoden von Stripe mit Payment Links, Hosted Checkout, Embedded Checkout Forms oder Elements verwenden, sind keine weiteren Aktualisierungen erforderlich. Stripe zeigt berechtigten Kundinnen und Kunden automatisch Stablecoin-Zahlungsoptionen an.
Verwendung mit einer benutzerdefinierten Integration
Falls erforderlich, können Sie die Krypto-Zahlungsmethode manuell in Ihre Zahlungsintegration aufnehmen.
Integrieren Sie „Mit Krypto bezahlen“ direkt über die Payment Intents API.
Stripe einrichtenServerseitig
Erstellen Sie zunächst ein Stripe-Konto oder melden Sie sich an.
Verwenden Sie unsere offiziellen Bibliotheken, um von Ihrer Anwendung aus auf die Stripe API zuzugreifen:
PaymentIntent erstellen und das Client-Geheimnis abrufenServerseitig
Das PaymentIntent-Objekt stellt Ihre Absicht dar, eine Zahlung von der Kundin/dem Kunden einzuziehen und verfolgt den Zahlungsablauf. Erstellen Sie einen PaymentIntent auf Ihrem Server und geben Sie den einzuziehenden Betrag und eine unterstützte Währung an. Wenn Sie über eine PaymentIntents-Integration verfügen, fügen Sie Krypto zur Liste der payment_method_types hinzu.
Client-Geheimnis abrufen
Im PaymentIntent ist ein Client-Geheimnis enthalten, das auf dem Client verwendet wird, um Zahlungen sicher abzuschließen. Es gibt verschiedene Verfahren zum Übergeben des Client-Geheimnisses an den Client.
Auf die Stablecoin-Zahlungsseite weiterleiten
Verwenden Sie Stripe.js, um die Zahlung an Stripe zu übermitteln, wenn ein Kunde/eine Kundin Krypto als Zahlungsmethode auswählt. Stripe.js ist die grundlegende JavaScript-Bibliothek für die Erstellung von Zahlungsabläufen. Sie verarbeitet automatisch komplexe Szenarien wie die nachfolgend beschriebene Weiterleitung und ermöglicht die Erweiterung Ihrer Integration durch zusätzliche Zahlungsmethoden. Fügen Sie das Stripe.js-Skript auf Ihrer Bezahlseite ein, indem Sie es im <head> Ihrer HTML-Datei einfügen.
<head> <title>Checkout</title> <script src="https://js.stripe.com/clover/stripe.js"></script> </head>
Erstellen Sie auf Ihrer Bezahlseite mit dem folgenden JavaScript eine Instanz von Stripe.js:
// Set your publishable key. Remember to change this to your live publishable key in production! // See your keys here: https://dashboard.stripe.com/apikeys const stripe = Stripe();'pk_test_TYooMQauvdEDq54NiTphI7jx'
Verwenden Sie das Client-Geheimnis des PaymentIntent und rufen Sie stripe. auf, um die „Mit Krypto bezahlen“-Weiterleitung zu handhaben. Fügen Sie eine return_ hinzu, um festzulegen, wohin Stripe die Kundinnen/Kunden nach Durchführung der Zahlung weiterleitet.
const form = document.getElementById('payment-form'); form.addEventListener('submit', async function(event) { event.preventDefault(); // Set the clientSecret of the PaymentIntent const { error } = await stripe.confirmPayment({ clientSecret: clientSecret, confirmParams: { payment_method_data: { type: 'crypto', }, // Return URL where the customer should be redirected after the authorization return_url: `${window.location.href}`, }, }); if (error) { // Inform the customer that there was an error. const errorElement = document.getElementById('error-message'); errorElement.textContent = result.error.message; } });
Die return_ verweist auf eine Seite auf Ihrer Website, auf der das Ergebnis der Zahlung angezeigt wird. Sie können festlegen, was angezeigt werden soll, indem Sie den Status des PaymentIntent überprüfen. Um den Status zu verifizieren, enthält die Stripe-Weiterleitung zur return_ die folgenden URL-Abfrageparameter. Sie können auch Ihre eigenen Abfrageparameter an die return_ anhängen. Sie bleiben während des gesamten Weiterleitungsvorgangs bestehen.
payment_ | Die eindeutige ID für den PaymentIntent. |
payment_ | Das Client-Geheimnis des PaymentIntent-Objekts. |
OptionalEreignisse nach der Zahlung verarbeiten
Stripe sendet ein payment_intent.succeeded-Ereignis, wenn die Zahlung abgeschlossen ist. Verwenden Sie das Dashboard, einen nutzerdefinierten Webhook oder eine Partnerlösung, um diese Ereignisse zu empfangen und Aktionen, wie das Versenden einer Bestellbestätigung per E-Mail, das Erfassen des Verkaufs in einer Datenbank oder das Initiieren eines Versandworkflows, auszuführen.
Überwachen Sie diese Ereignisse, statt auf einen Callback vom Client zu warten. Auf dem Client könnte der Kunde/die Kundin das Browserfenster schließen oder die App beenden, bevor der Callback erfolgt ist und böswillige Clients die Antwort manipulieren könnten. Wenn Sie Ihre Integration so einrichten, dass sie asynchrone Ereignisse überwacht, können Sie auch zukünftig zusätzliche Zahlungsmethoden akzeptieren. Informationen über die Unterschiede zwischen allen unterstützten Zahlungsmethoden finden Sie in unserem Leitfaden zu Zahlungsmethoden.
Ereignisse empfangen und Geschäftsaktionen ausführen
Es gibt mehrere Möglichkeiten, Geschäftsaktionen zu empfangen und auszuführen:
- Manuell: Im Stripe-Dashboard können Sie alle Stripe-Zahlungen anzeigen, Zahlungsbelege per E-Mail versenden, Auszahlungen abwickeln oder fehlgeschlagene Zahlungen erneut durchführen.
- Nutzerdefinierter Code: Erstellen Sie einen Webhook-Handler, um Ereignisse zu überwachen und individuelle asynchrone Zahlungsabläufe zu erstellen. Mit der Stripe CLI können Sie Ihre Webhook-Integration lokal testen und Fehler beheben.
- Vorgefertigte Apps: Verarbeiten Sie häufige Geschäftsereignisse, wie Automatisierung oder Marketing und Vertrieb durch Integration einer Partneranwendung.
Unterstützte Währungen
Sie können Krypto-Zahlungen in den Währungen erstellen, die Ihrem Land zugeordnet sind. Die lokale Standardwährung für Kryptowährungen ist USD, wobei die Kundinnen/Kunden ihren Kaufbetrag auch in dieser Währung sehen.
Ihre Integration testen
Testen Sie die Integration Ihrer Kryptozahlung, indem Sie die Weiterleitungsseite der Zahlung mit Ihren Test-API-Schlüsseln öffnen. Sie können einen erfolgreichen Zahlungsablauf kostenlos mit Testnet-Assets testen.
- Erstellen Sie in einer Sandbox eine neue Transaktion mit der von Ihnen gewählten Integrationsmethode und öffnen Sie die entsprechende Weiterleitungs-URL.
- Verbinden Sie Ihre bevorzugte Wallet und Ihr bevorzugtes Zahlungsnetzwerk.
- Schließen Sie die Zahlung ab und bestätigen Sie, dass Sie an die erwartete URL weitergeleitet werden.
Zahlungen mit Testnet-Assets testen
Die meisten Kryptowährungen bieten Testnet-Assets oder -Token ohne Geldwert an, die Sie zum Testen von Blockchain-Transaktionen verwenden können. Stripe empfiehlt die MetaMask-Wallet, das Polygon Amoy Testnet und den Circle-Faucet zum Testen, aber Sie können Ihre eigenen bevorzugten Dienste verwenden.
Wallet installieren
- Laden Sie die MetaMask-Erweiterung für Ihren Webbrowser herunter.
- Erstellen Sie eine neue Wallet oder importieren Sie eine bestehende.
Testnet aktivieren
- Wählen Sie in Ihrer MetaMask-Wallet im Hauptmenü Netzwerke aus.
- Klicken Sie auf Benutzerdefiniertes Netzwerk hinzufügen.
- Geben Sie die folgenden Details ein:
- Netzwerkname:
Polygon Amoy - Standard-RPC-URL:
https://rpc-amoy.polygon. technology/ - Ketten-ID:
80002 - Währungssymbol:
POL - Explorer-URL blockieren:
https://amoy.polygonscan. com/
- Netzwerkname:
- Klicken Sie auf Speichern.
Token importieren
- Wählen Sie in Ihrer MetaMask-Wallet unter Token die Option Polygon Amoy aus dem Netzwerk-Dropdown-Menü aus.
- Klicken Sie auf das Überlaufmenü () und wählen Sie Token importieren aus.
- Klicken Sie auf Netzwerk auswählen > Polygon Amoy.
- Fügen Sie unter Token Vertragsadresse die Testnet-Vertragsadresse für Polygon Amoy ein:Das Feld Tokensymbol wird automatisch mit
0x41E94Eb019C0762f9Bfcf9Fb1E58725BfB0e7582USDCund das Feld Dezimalstellen mit6aktualisiert. - Klicken Sie auf Weiter.
- Verifizieren Sie, dass Sie den
USDC-Token importieren, und klicken Sie dann auf Importieren.
Ihre MetaMask-Wallet zeigt jetzt Polygon Amoy und USDC in der Tokenliste an.
Testnet-Assets abrufen
- Öffnen Sie faucet.circle.com
- Klicken Sie auf USDC.
- Wählen Sie unter Netzwerk Polygon POS Amoy aus.
- Fügen Sie unter Senden an Ihre Wallet Adresse ein.
- Klicken Sie auf 10 USDC senden.
Zusätzlich zu USDC für Zahlungen benötigen Sie POL, um Transaktionskosten zu bezahlen:
- Öffnen Sie faucet.polygon.technology.
- Wählen Sie unter Kette und Token auswählen Polygon Amoy und POL aus.
- Klicken Sie unter Ihre Identität verifizieren auf die Drittanbieterplattform, bei der Sie sich authentifizieren möchten, und schließen Sie den Anmeldeprozess ab.
- Fügen Sie unter Wallet-Adresse eingeben Ihre Wallet-Adresse ein.
- Klicken Sie auf Anspruch.
Die Durchführung von Testnet-Transaktionen kann einige Minuten dauern. Überprüfen Sie Ihre Wallet, um zu bestätigen, dass die Überweisungen von USDC und POL durchgeführt wurden.
Weitere Testnet-Faucets
Weitere Optionen zum Testen von Token finden Sie in diesen Faucet-Diensten: