Eine einbettbare Onramp-Integration einrichtenBeta

Verwenden Sie diesen Leitfaden, um die einbettbare Onramp vollständig anzupassen.

So führen Sie eine Integration mit dem Onramp SDK durch:

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.

SDK und Client-Bibliothek installieren
clientseitig
serverseitig

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 Skripts immer direkt aus den Stripe-Domains (https://js.stripe.com und https://crypto-js.stripe.com) geladen werden. Fügen Sie die Skripts nicht in ein Paket ein und hosten Sie selbst keine Kopie. Wenn Sie dies tun, kann Ihre Integration ohne Vorwarnung unterbrochen werden.

onramp.html
<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 eingeschränkten Betaphase befindet. Daher wird in unseren Beispielen curl für Backend-Interaktionen verwendet.

Eine Krypto-Onramp-Sitzung erstellen
serverseitig

Erstellen Sie eine Crypto-Onramp-Sitzung, indem Sie den folgenden curl-Befehl in Ihrem Datenterminal ausführen:

Command Line
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \
  -usk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "wallet_addresses[ethereum]"="0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2"
  # add as many parameters as you'd like

Sie erhalten eine Antwort ähnlich der folgenden:

{
  "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
    }
  }
}

In der Onramp-API-Dokumentation finden Sie die vollständige Parameterliste, die Sie beim Erstellen einer Sitzung übergeben können.

Rendern der Onramp Nutzeroberfläche
clientseitig

Importieren Sie sowohl das StripeJS- als auch das OnrampJS-Paket:

index.html
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <title>Crypto Onramp</title>
    <meta name="description" content="A demo of the hosted onramp" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <script src="https://js.stripe.com/v3/"></script>
    <script src="https://crypto-js.stripe.com/crypto-onramp-outer.js"></script>
    <script src="onramp.js" defer></script>
  </head>
  <body>
    <div id="onramp-element" />
  </body>
</html>

Verwenden Sie das client_secret aus Ihrem serverseitigen Aufruf im vorherigen Schritt, um die Onramp-Sitzung zu initiieren und bereitzustellen:

onramp.js
const stripeOnramp = StripeOnramp("pk_test_TYooMQauvdEDq54NiTphI7jx"
);
initialize();
// Initialize the onramp element with a client secret
function initialize() {
  // IMPORTANT: replace the following with your logic of how to mint/retrieve the client secret
  const clientSecret = "cos_1Lb6vsAY1pjOSNXVWF3nUtkV_secret_8fuPvTzBaxj3XRh14C6tqvdl600rpW7hG4G";
  const onrampSession = stripeOnramp.createSession({clientSecret});
  onrampSession
    .mount("#onramp-element");
}

Nach der Ausführung des Skripts rendert Onramp das folgende Dialogfeld:

Einbettung der Fiat-zu-Krypto-Onramp von Stripe in eine Drittanbieteranwendung

Fiat-zu-Krypto-Onramp von Stripe, eingebettet in eine Drittanbieteranwendung

Werte im Test-Modus

Achtung

Die Transaktionsbeträge im Test-Modus werden durch unsere vorab festgelegten Grenzwerte außer Kraft gesetzt.

Verwenden Sie die folgenden Werte, um eine Onramp-Transaktion im Test-Modus abzuschließen:

Verwenden Sie auf dem OTP-Bildschirm 000000 für den Verifizierungscode.
Verwenden Sie auf dem Bildschirm mit den persönliche Daten 000000000 für die SSN und address_full_match für die Adresszeile 1.
Verwenden Sie auf dem Bildschirm mit den Zahlungsdetails die Test-Kreditkartennummer 4242424242424242.

Integrationsnutzung anzeigen

Nachdem Sie Onramp gestartet haben, können Sie angepassten Nutzungsberichte im Stripe-Dashboard einsehen. Sie können auch zur Onboarding-Seite zurückkehren, um die Domains zu aktualisieren, auf denen Sie die Onramp hosten möchten. Dort können Sie auch den Status der Onboarding-Aufgaben prüfen.