Onramp-Integration einrichtenBeta
So integrieren Sie mit der Onramp SDK:
- Installieren Sie das SDK und die Client-Bibliothek.
- Generieren Sie eine Krypto-Onramp-Sitzung in Ihrem Backend.
- Rendern Sie die Onramp-Nutzeroberfläche auf Ihrer Website.
- Nutzung Ihrer Integration im Stripe-Dashboard anzeigen.
Installieren Sie das SDK und die Client-Bibliothekclientseitigserverseitig
Clientseitig
Fügen Sie die folgenden Skripts mithilfe von Skript-Tags in das <head>
-Element Ihres HTML-Codes ein. Aus Kompatibilitätsgründen und aus Gründen der PCI-Konformität müssen diese Skripte immer direkt aus den Stripe-Domains https://js.stripe.com und https://crypto-js.stripe.com geladen werden. Fügen Sie die Skripte nicht in ein Paket ein und hosten Sie selbst keine Kopie. Wenn Sie dies tun, kann Ihre Integration ohne Vorwarnung unterbrochen werden.
<head> <title>Onramp</title> <script src="https://js.stripe.com/v3/"></script> <script src="https://crypto-js.stripe.com/crypto-onramp-outer.js"></script> </head>
Verwenden Sie das Onramp JS SDK als Modul
Verwenden Sie das npm-Paket, um das Onramp JS SDK als ES-Modul zu laden. Das Paket enthält Definitionen des Typescript-Typs.
npm install --save @stripe/stripe-js @stripe/crypto
Serverseitig
Unsere offiziellen Bibliotheken enthalten keine integrierte Unterstützung für die API-Endpoints, da sich die Onramp API in der beschränkten Betaphase befindet. Daher verwenden unsere Beispiele curl für Backend-Interaktionen.
Eine Krypto-Onramp-Sitzung erstellenserverseitig
Erstellen Sie eine Crypto-Onramp-Sitzung, indem Sie den folgenden curl-Befehl in Ihrem Datenterminal ausführen:
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \ -u
: \ # this secret key is from step 1sk_test_4eC39HqLyjWDarjtT1zdp7dc
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \ -u
: \ -d "wallet_addresses[ethereum]"="0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2" # add as many parameters as you'd likesk_test_4eC39HqLyjWDarjtT1zdp7dc
Beispielantwort:
{ "id": "cos_0MYfrA589O8KAxCGEDdIVYy3", "object": "crypto.onramp_session", "client_secret": "cos_0MYfrA589O8KAxCGEDdIVYy3_secret_rnpnWaxQbYQOvp6nVMvEeczx300NRU4hErZ", "created": 1675732824, "livemode": false, "status": "initialized", "transaction_details": { "destination_currency": null, "destination_amount": null, "destination_network": null, "fees": null, "lock_wallet_address": false, "source_currency": null, "source_amount": null, "destination_currencies": [ "btc", "eth", "sol", "usdc" ], "destination_networks": [ "bitcoin", "ethereum", "solana" ], "transaction_id": null, "wallet_address": null, "wallet_addresses": { "bitcoin": null, "ethereum": "0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2", "polygon": null, "solana": null } } }
Eine vollständige Liste der Parameter, die Sie bei der Sitzungserstellung übergeben können, finden Sie in unserer API-Dokumentation.
Rendern der Onramp Nutzeroberflächeclientseitig
Nach der Ausführung des Skripts rendert Onramp Folgendes:
Werte im Test-Modus
Achtung
Die Transaktionsbeträge im Test-Modus werden durch unsere vorab festgelegten Limits außer Kraft gesetzt.
Verwenden Sie die folgenden Werte, um eine Onramp-Transaktion im Test-Modus abzuschließen:
- Verwenden Sie im OTP-Bildschirm
000000
als Verifizierungscode. - Verwenden Sie auf dem Bildschirm mit den persönliche Daten
000000000
für die SSN undaddress_full_match
für die Adresszeile 1. - Verwenden Sie auf dem Bildschirm mit den Zahlungsdetails die Test-Kreditkartennummer
4242424242424242
.
Nutzung Ihrer Integration im Stripe-Dashboard anzeigen
Nachdem Sie Crypto-Onramp gestartet haben, können Sie sich im Stripe-Dashboard benutzerdefinierte Nutzungsberichte ansehen.
Sie können auch zur Onboarding-Seite zurückkehren, um die Domains zu aktualisieren, auf denen Sie den Onramp hosten möchten. Dort können Sie auch den Status der Onboarding-Aufgaben prüfen.