Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellenAnmelden
ÜbersichtAktualisieren Sie Ihre Integration
Online-Zahlungen
ÜbersichtIhren Use case findenVerwenden Sie Managed Payments
Präsenzzahlungen
Zahlungsmethoden
Zahlungsszenarien
Mehr als Zahlungen

Eine eingebettete Onramp-Integration einrichtenÖffentliche Vorschau

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

Bei diesem Leitfaden handelt es sich um eine erweiterte Version des QuickStarts für eingebetteten Onramp. Erfahren Sie, wie Sie weitere Funktionalitäten hinzufügen, wie z. B.:

  • Installieren des SDK mit einem Script-Tag oder Paket-Manager
  • Passen Sie das Erscheinungsbild des Onramps an
  • Onramp-Nutzeroberfläche für mobile Webansichten konfigurieren
  • Kundensupport und Betrugsfälle bearbeiten
  • Geschätzte Kryptowährungs-Umrechnungskurse abrufen

Bevor Sie loslegen

  1. Der eingebettete Onramp ist nur in der EU und den USA (außer Hawaii) verfügbar.
  2. Die Onramp-API befindet sich in der öffentlichen Vorschau. Sie müssen das Onramp-Anmeldeformular einreichen, bevor Sie mit der Entwicklung in einer Testumgebung beginnen.
  3. Nachdem Sie Zugriff auf die Onramp-API erhalten haben, können Sie über das Dashboard Ihre geheimen und veröffentlichbaren API-Schlüssel abrufen.

SDK und Client-Bibliothek installieren
clientseitig
serverseitig

Clientseitig

Fügen Sie die folgenden Scripts mithilfe von Script-Tags innerhalb des <head>-Elements Ihres HTML ein. Diese Scripts müssen stets direkt von den Stripe-Domains (https://js.stripe.com und https://crypto-js.stripe.com) geladen werden, um die Kompatibilität und die PCI-Compliance sicherzustellen.

Fügen Sie die Scripts nicht in ein Paket ein und hosten Sie keine eigene Kopie, da Ihre Integration sonst ohne Vorwarnung fehlerhaft werden könnte.

onramp.html
<head>
  <title>Onramp</title>
  <script src="https://js.stripe.com/clover/stripe.js"></script>
  <script src="https://crypto-js.stripe.com/crypto-onramp-outer.js"></script>
</head>

JS SDK

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

Alternative SDK-Installation

Alternativ können Sie das clientseitige Stripe-Krypto-ES-Modul-SDK mit einem Skript-Tag oder Paket-Manager installieren. Das SDK umschließt die globale StripeOnramp-Funktion, die vom Stripe-Kryptoskript als ES Modul bereitgestellt wird.

  1. Laden Sie das Skript manuell. Fügen Sie die folgenden Skripte mithilfe von Skript-Tags in das <head>-Element Ihres HTML ein. Diese Skripte müssen stets direkt aus Stripes Domänen, https://js.stripe.com und https://crypto-js.stripe.com, aus Gründen der Kompatibilität und zur PCI-Compliance 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 Warnung unterbrochen werden.

    <head>
  <title>Onramp</title>
  <script src="https://js.stripe.com/clover/stripe.js"></script>
  <script src="https://crypto-js.stripe.com/crypto-onramp-outer.js"></script>
</head>

  2. Legen Sie den veröffentlichbaren API-Schlüssel fest, damit Stripe das von Ihrem Backend erstellte OnrampSession-Objekt abrufen kann. Beispiel:

    const stripeOnramp = StripeOnramp(
    'pk_test_TYooMQauvdEDq54NiTphI7jx'
    );

  3. Um das Modul über den Paketmanager zu installieren, installieren Sie zunächst das Stripe.js-ES-Modul und das Stripe Krypto-ES-Modul aus dem öffentlichen npm-Verzeichnis. Das Paket enthält Typescript-Typdefinitionen.

    Command Line
    npm install @stripe/stripe-js @stripe/crypto

  4. Importieren Sie das Modul und legen Sie den veröffentlichbaren API-Schlüssel fest, damit Stripe das von Ihrem Backend erstellte OnrampSession-Objekt abrufen kann. Die Funktion gibt ein Promise-Objekt zurück, das nach dem Laden der Skripts mit einem neu erstellten StripeOnramp-Objekt aufgelöst wird.

    import {loadStripeOnramp} from '@stripe/crypto';

const stripeOnramp = await loadStripeOnramp(
    'pk_test_TYooMQauvdEDq54NiTphI7jx'
    );

Serverseitig

Unsere offiziellen Bibliotheken enthalten derzeit keine integrierte Unterstützung für die API-Endpoints, da sich die Onramp-API in der öffentlichen Vorschau befindet. Daher verwenden unsere Beispiele curl für Backend-Interaktionen.

Eine Krypto-Onramp-Sitzung erstellen
serverseitig

Stellen Sie auf dem Server einen neuen API-Endpoint bereit (zum Beispiel myserver.com/mint-onramp-session), der den Stripe POST /v1/crypto/onramp_sessions-Endpoint aufruft. Dadurch wird eine Onramp-Sitzung mit Stripe erstellt, die Sie für neue oder wiederkehrende Kundinnen und Kunden verwenden können. Sie müssen pro Kundin bzw. Kunde eine eigene Session erstellen.

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

Command Line
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -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
    }
  }
}

Fehler

Dieser Endpoint gibt Fehlercodes zurück, wenn Stripe keine Onramp-Sitzungen erstellen kann. Weitere Informationen zu möglichen Ursachen finden Sie unter Kundensupportfähigkeit und Betrugsprävention. Wir empfehlen, die Onramp-Komponente nur dann anzuzeigen, wenn bei der Session-Erstellung ein HTTP-Status 200 zurückgegeben wird und eine alternative Nutzeroberfläche bereitzustellen, die mit Fehlern bei der Session-Erstellung umgehen kann.

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

Zustände

Jede Onramp-Sitzung durchläuft die folgenden Zustände:

  • initialized: Die App hat die Onramp-Sitzung serverseitig neu erstellt, aber die Kundin/der Kunde hat sie noch nicht verwendet. Sitzungen befinden sich in diesem Zustand, bis die Kundin/der Kunde den Onboarding-Prozess abgeschlossen hat und zur Zahlung bereit ist.
  • abgelehnt: Stripe hat die Kundin/den Kunden aus irgendeinem Grund abgelehnt (KYC-Fehler, Probleme bei der Sanktionsprüfung, Betrugsprüfungen).
  • requires_payment: Die Kundin/Der Kunde hat das Onboarding oder die Anmeldung abgeschlossen und wechselt zur Zahlungsseite. Wenn der Zahlungsversuch fehlschlägt, verbleibt dieser Status.
  • fulfillment_processing: Der Kunde/die Kundin hat die Zahlung erfolgreich abgeschlossen. Wir haben die von ihnen gekaufte Kryptowährung noch nicht geliefert.
  • fulfillment_complete: Der Kunde/die Kundin konnte erfolgreich für Kryptowährungen bezahlen und wir haben die Lieferung bestätigt.

OptionalDas Erscheinungsbild des Onramp anpassen

Sie können das Erscheinungsbild des Onramp anpassen.

Branding aktualisieren

Verwenden Sie die Branding-Einstellungen, um Ihr Logo und Ihre Markenfarben hochzuladen, die automatisch für Onramp-Sitzungen gelten, die mit Ihrem Plattform-API-Schlüssel erstellt wurden.

Dunkelmodus aktivieren

Um den Dark Mode zu aktivieren, fügen Sie beim Erstellen der Sitzung eine Darstellungsstruktur in den Aufruf ein:

const onrampSession = stripeOnramp.createSession({
  clientSecret: clientSecret,
  appearance: {
    theme: 'dark'
  },
});

Wenn Sie das Erscheinungsbild nicht angeben, wird für Onramp standardmäßig ein helles Design verwendet. Sie können das Design auch ändern, nachdem Onramp gerendert wurde, indem Sie Folgendes aufrufen:

onrampSession.setAppearance({
  theme: newTheme
});

OptionalParameter vorab ausfüllen

Sie können einige Parameter der Onramp-Sitzung vorab ausfüllen.

Transaktionsparameter vorab ausfüllen

Beispielsweise kann eine Dapp oder Wallet bereits die wallet_addresses einer Kundin/eines Kunden speichern. Dies lässt sich während der Sitzungserstellung erreichen:

Command Line
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "wallet_addresses[ethereum]"="0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2" \
  -d "source_currency"="usd" \
  -d "destination_currency"="eth" \
  -d "destination_network"="ethereum" \
  -d "destination_amount"="0.1234"

Sie erhalten eine Antwort wie:

{
  "id": "cos_0MYvnp589O8KAxCGwmWATYfA",
  "object": "crypto.onramp_session",
  "client_secret": "cos_0MYvnp589O8KAxCGwmWATYfA_secret_LhqXJi2lvbMCYhVHfrHGfUfX6009qtZPtV7",
  "created": 1675794121,
  "livemode": false,
  "status": "initialized",
  "transaction_details": {
    "destination_currency": "eth",
    "destination_amount": "0.123400000000000000",
    "destination_network": "ethereum",
    "fees": null,
    "lock_wallet_address": false,
    "source_currency": "usd",
    "source_amount": null,
    "destination_currencies": [
      "btc",
      "eth",
      "sol",
      "usdc",
      "xlm"
    ],
    "destination_networks": [
      "bitcoin",
      "ethereum",
      "solana",
      "stellar"
    ],
    "transaction_id": null,
    "wallet_address": null,
    "wallet_addresses": {
      "bitcoin": null,
      "ethereum": "0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2",
      "polygon": null,
      "solana": null,
      "stellar": null,
      "destination_tags": null
    }
  }
}

Die folgenden Parameter können vorab ausgefüllt werden:

  • wallet_addresses: Die vorgeschlagene Wallet-Adresse, an die Kryptowährungen gesendet werden sollen (die Standardauswahl auf dem Bildschirm zum Anhängen der Wallet)
  • lock_wallet_address: Ob die vorgeschlagene Wallet-Adresse gesperrt werden soll oder nicht
  • source_currency: Die Fiat-Währung für die Transaktion (derzeit nur usd und eur)
  • source_amount: Der Betrag der Fiat-Währung, der für den Kauf von Kryptowährungen verwendet werden soll (dieser und der Zielbetrag schließen sich gegenseitig aus)
  • destination_network: Das Standard-Kryptonetzwerk für diese Onramp (z. B. ethereum)
  • destination_currency: Die Standard-Kryptowährung für diese Onramp-Sitzung (z. B. eth).
  • destination_amount: Der Betrag der Kryptowährung, die gekauft wird (dieser und der Quellbetrag schließen sich gegenseitig aus)
  • destination_currencies: Ein Array von Kryptowährungen, auf die Sie die Auswahl beschränken möchten (z. B. [eth, usdc])
  • destination_networks: Ein Array von Krypto-Netzwerken, auf die Sie die Auswahl beschränken möchten (z. B. [ethereum, polygon])

Weitere Informationen zu den spezifischen Anforderungen und deren Auswirkungen auf Kundinnen/Kunden in der Onramp-Nutzeroberfläche finden Sie unter Onramp-API-Referenz.

Kundeninformationen vorab ausfüllen

Um einen möglichst reibungslosen Ablauf für die Kundinnen und Kunden zu ermöglichen und die Konversion zu steigern, sollten Sie einige der erforderlichen KYC-Informationen möglicherweise vorab ausfüllen, wenn Sie diese bereits in Ihrer Anwendung erfasst haben.

Während des gesamten Ablaufs müssen Kundinnen und Kunden folgende Angaben machen:

  • E-Mail
  • Vorname
  • Nachname
  • Geburtsdatum
  • SSN
  • Privatadresse (Land, Adresszeile 1, Adresszeile 2, Ort, Bundesland, Postleitzahl)

Die Onramp-API ermöglicht es, alle diese Felder mit Ausnahme der Sozialversicherungsnummer (SSN) vorab auszufüllen. Um diese Informationen vorab bereitzustellen, können Sie den Parameter customer_information in der API zur OnrampSession-Erstellung verwenden.

Beispielanfrage:

Command Line
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "customer_information[email]"="john@doe.com" \
  -d "customer_information[first_name]"="John" \
  -d "customer_information[last_name]"="Doe" \
  -d "customer_information[dob][year]"=1990 \
  -d "customer_information[dob][month]"=7 \
  -d "customer_information[dob][day]"=4 \
  -d "customer_information[address][country]"="US" \
  -d "customer_information[address][line1]"="354 Oyster Point Blvd" \
  -d "customer_information[address][line2]"="Apt 1A" \
  -d "customer_information[address][city]"="South San Francisco" \
  -d "customer_information[address][state]"="CA" \
  -d "customer_information[address][postal_code]"="94080"

Beispielantwort:

{
  "id": "cos_1MbuUeAEFtmWU4EVBFZS0gce",
  "object": "crypto.onramp_session",
  "client_secret": "cos_1MbuUeAEFtmWU4EVBFZS0gce_secret_zPsPPytwNU6mMKh1Bmz7ymXGi00ILwwyGeG",
  "created": 1676504072,
  "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",
      "xlm"
    ],
    "destination_networks": [
      "bitcoin",
      "ethereum",
      "solana",
      "polygon",
      "stellar"
    ],
    "transaction_id": null,
    "wallet_address": null,
    "wallet_addresses": null
  }
}

Die folgenden Parameter können vorab ausgefüllt werden:

  • customer_information.email – Freitextfeld für die E-Mail-Adresse der Kundin/des Kunden
  • customer_information.first_name – Freitextfeld für den Vornamen der Kundin/des Kunden
  • customer_information.last_name – Freitextfeld für den Nachnamen der Kundin/des Kunden
  • customer_information.dob.year – Ganzzahl für das Geburtsjahr der Kundin/des Kunden
  • customer_information.dob.month – Ganzzahl für den Geburtsmonat der Kundin/des Kunden
  • customer_information.dob.day – Ganzzahl für den Geburtstag der Kundin/des Kunden
  • customer_information.address.country – Zeichenkette mit dem zweistelligen Ländercode des Wohnsitzlandes der Kundin/des Kunden
  • customer_information.address.line1 – Freitextfeld für die erste Adresszeile der Kundin/des Kunden
  • customer_information.address.line2 – Freitextfeld für die zweite Adresszeile der Kundin/des Kunden
  • customer_information.address.city – Freitextfeld für die Stadt der Kundin/des Kunden
  • customer_information.address.state – Zeichenfolge des aus zwei Buchstaben bestehenden Codes für US-Bundesstaaten (der vollständige Name des Bundesstaates funktioniert auch), z. B. „CA“ oder „Kalifornien“
  • customer_information.address.postal_code – Freitextfeld für die Postleitzahl der Kundin/des Kunden

Alle Felder sind optional und Sie können eine beliebige Teilmenge davon zur Vorausfüllung angeben. Wenn Sie jedoch das Geburtsdatum angeben, müssen Sie auch alle drei Werte für die folgenden Felder angeben: Jahr, Monat und Tag.

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/clover/stripe.js"></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

Sandbox-Werte

Warning

Beträge für Sandbox-Transaktionen werden durch unsere vorab festgelegten Limits außer Kraft gesetzt.

Verwenden Sie die folgenden Werte, um eine Onramp-Transaktion in der Sandbox 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.

OptionalDen Onramp für die mobile Nutzung konfigurieren

Integrieren Sie Stripes Crypto-Onramp-Nutzeroberfläche in mobile Web-Views und Browser, indem Sie eine Session erstellen, die Onramp-UI hosten, den Kauf abschließen und Kundinnen und Kunden zur mobilen App zurückleiten.

Minting einer Sitzung

Ähnlich wie bei anderen Integrationen müssen Sie einen Server-Endpoint implementieren, um für jeden Besuch einer Kundin/eines Kunden eine neue Onramp-Sitzung zuerstellen](#create-onramp-session). Der Endpoint gibt ein client_secret zurück, das die Onramp-Nutzeroberfläche laden oder einen Fehler anzeigen kann, wenn der Onramp nicht verfügbar ist.

Onramp-Nutzeroberfläche hosten

Erstellen Sie eine Frontend-Route (zum Beispiel www.my-web3-wallet.com/onramp/<client_secret>), um die Onramp-Nutzeroberfläche zu hosten. Ihr /onramp/<client_secret> verweist auf onramp.html.

onramp.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 type="text/javascript" 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>

Dabei verwendet onramp.js das client_secret aus der URL und stellt die Onramp-Nutzeroberfläche bereit:

onramp.js
const stripeOnramp = StripeOnramp(
pk_test_TYooMQauvdEDq54NiTphI7jx
);
initialize();
// initialize onramp element with client secret
function initialize() {
  const url = window.location.href.replace(/\/$/, '');
  const clientSecret = url.substring(url.lastIndexOf('/') + 1);
  const onrampSession = stripeOnramp.createSession({
    clientSecret,
    // other client side options that customize the look and feel
  });
  onrampSession
    .addEventListener('onramp_session_updated', handleSessionUpdate)
    .mount("#onramp-element");
}
function handleSessionUpdate(event) {
  const session = event.payload.session;
  if (session.status === 'fulfillment_complete' || session.status === 'rejected') {
    // redirect back to mobile app through universal link
    window.location.assign('/onramp_success/' + session.id);
  }
}

Konfigurieren Sie universelle Links, um /onramp_success zurück zu Ihrer Mobile App per Deep-Link zu verlinken. Erwägen Sie, eine Ausweich- oder onramp_success-Seite bereitzustellen, um Nutzer/innen aufzufordern, manuell zurück zu Ihrer App zu wechseln.

Kauf abschließen

Wie bei einer Standardintegration steuert der Frontend-Client die gesamte Onramp-Nutzeroberfläche. Die Nutzeroberfläche passt sich der Bildschirmgröße an. Wenn sich der Sitzungsstatus ändert und wir mehr transaction_details erfassen, wird das CryptoOnrampSession-Objekt entsprechend aktualisiert. Wir generieren Webhooks und Frontend-Ereignisse für jeden Statusübergang. Durch die Verwendung von Frontend-Ereignis-Listenern können Sie Kundinnen/Kunden nach Abschluss der OnrampSession wieder zu Ihrem Anwendungsablauf zurück leiten.

Zur Mobil-App weiterleiten

Über einen Deep-Link oder eine manuelle Umstellung können Kundinnen/Kunden ihren Ablauf in Ihrer mobilen Anwendung wiederaufnehmen. Ihre Mobilanwendung kann Ihr Backend verwenden, um weiterhin den Status von CryptoOnrampSession abzufragen.

Wenn eine Kundin/ein Kunde beispielsweise während der Ersteinrichtung ihr/sein Guthaben auflädt, können Sie sie/ihn wieder zu Ihrer Anwendung weiterleiten, sobald die Sitzung in den Status fulfillment_processing übergeht. Sie können Kundinnen und Kunden erlauben, den Rest Ihrer Anwendung zu erkunden, während Sie den Status der OnrampSession im Hintergrund abfragen.

OptionalKonversionsangebote konfigurieren

Die Onramp Quotes-API ermöglicht es Ihnen, geschätzte Angebote für Onramp-Konversionen in verschiedene Kryptowährungen auf unterschiedlichen Netzwerken abzurufen. Sie können dabei einen festen Quell- oder Zielbetrag angeben und die Angebote auf eine Teilmenge von Zielwährungen oder Netzwerken beschränken. Diese API erlaubt es Ihnen, Angebote in der Nutzeroberfläche Ihres Produkts anzuzeigen, bevor Sie die Kundin/den Kunden zum Onramp-Widget weiterleiten. Wenn das Angebot abläuft, bevor die Kundin/der Kunde das Onramp-Widget besucht, kann im Onramp-Widget ein leicht abweichendes Angebot angezeigt werden.

Konversionsangebot anfordern

Verwenden Sie den Endpoint GET /v1/crypto/onramp/quotes, um ein Konversionsangebot zu erhalten. Die folgende Tabelle enthält alle verfügbaren Parameter für diesen Endpoint:

ParameterTypStandardDetails
source_currencyZeichenfolge (optional)usdDer Währungscode ISO-4217. Wir unterstützen derzeit nur usd und eur.
source_amountZeichenfolge (optional)100,00Eine Zeichenfolgendarstellung des Fiat-Betrags, den Sie für den Onramp benötigen. Wenn source_amount eingestellt ist, muss destination_amount null sein (diese schließen sich gegenseitig aus, da Sie lediglich einen festen Betrag für ein Ende des Handels festlegen können).
destination_amountZeichenfolge (optional)nullEine Zeichenfolgendarstellung des Betrags der zu erwerbenden destination_currency. Falls der destination_amount festgelegt ist, muss der source_amount null sein. Wenn Sie dieses Feld angeben, müssen Sie außerdem jeweils einen Wert für destination_currencies und destination_networks festlegen. Dadurch wissen wir, für welche Kryptowährung ein Angebot gemacht werden soll.)
destination_currenciesArray<String> (optional)null
  • ['usdc', 'ethereum']
Die Liste der Kryptowährungen, für die Sie Angebote generieren möchten. Wenn der Wert auf null gelassen wird, rufen wir Angebote für alle destination_currencies auf, die destination_networks unterstützt.
  • Währungen: btc, eth, sol, matic, usdc, xlm
destination_networksArray<String> (optional)null
  • ['polygon', 'bitcoin', 'solana', 'ethereum']
Die Liste der Kryptowährungsnetzwerke, für die Sie quotes erstellen möchten. Wenn sie auf null gelassen wird, rufen wir Angebote für destination_currencies in allen Netzwerken ab.
  • Netzwerke: Bitcoin, Ethereum, Solana, Polygon , Stellar

Beispiel für Angebotsanfragen

Führen Sie den folgenden Befehl aus, um alle Währungsnetzwerk-Zielpaare mit einem Standard-Ausgangsbetrag von 100 USD abzurufen:

Command Line
curl -G https://api.stripe.com/v1/crypto/onramp/quotes \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:

Sie erhalten eine Antwort ähnlich der folgenden:

{
  "id": "cd35838481497f403988360cc0ff5ce5c5ce7451ce8938f86d379dff7157d33d",
  "rate_fetched_at": 1674265380.6883376,
  "destination_network_quotes": {
    "ethereum": [
      {
        "id": "7eb9ccb7c1bffadf3773ca1f56ba3a352fe4a226328e72142925a80e7242b70c",
        "destination_currency": "eth",
        "destination_amount": "0.060232255577506866",
        "destination_network": "ethereum",
        "fees": {
          "network_fee_monetary": "1.41",
          "transaction_fee_monetary": "3.03"
        },
        "source_total_amount": "104.44"
      },
      {
        "id": "398de047128b6dff1abbc41519811db68dd8bcb69939b87c4a4621b1740a1c5b",
        "destination_currency": "usdc",
        "destination_amount": "100.00",
        "destination_network": "ethereum",
        "fees": {
          "network_fee_monetary": "5.63",
          "transaction_fee_monetary": "3.07"
        },
        "source_total_amount": "108.70"
      }
    ],
    ...
  },
  "livemode": true,
  "source_currency": "usd",
  "source_amount": "100.00"
}

Führen Sie den folgenden Befehl aus, um alle Währungsnetzwerk-Zielpaare mit einem Ausgangsbetrag von 200 USD abzurufen:

Command Line
curl -G https://api.stripe.com/v1/crypto/onramp/quotes \
    -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
    -d "source_amount"="200"

Sie erhalten eine Antwort ähnlich der folgenden:

{
  "id": "2e5818944df6a2325c7e9c1e72d27174b9bedfc8e64ace47c081370a5b982a7b",
  "rate_fetched_at": 1674265506.3408287,
  "destination_network_quotes": {
    "ethereum": [
      {
        "id": "d160a80828eabb6b6d4aeafac585eee62d95425c7fb7577866ab04b9a786df00",
        "destination_currency": "eth",
        "destination_amount": "0.253568242640499553",
        "destination_network": "ethereum",
        "fees": {
          "network_fee_monetary": "1.45",
          "transaction_fee_monetary": "12.71"
        },
        "source_total_amount": "214.20"
      },
      {
        "id": "53f864cb28a42f11e1d9d5aff7e43ac96b056406f74cbf618399c6fa40f3d275",
        "destination_currency": "usdc",
        "destination_amount": "200.00",
        "destination_network": "ethereum",
        "fees": {
          "network_fee_monetary": "5.80",
          "transaction_fee_monetary": "12.76"
        },
        "source_total_amount": "218.56"
      }
    ],
    ...
  },
  "livemode": true,
  "source_currency": "usd",
  "source_amount": "200.00"
}

Führen Sie den folgenden Befehl aus, um Angebote für ETH und SOL in den Ethereum- und Solana-Netzwerken abzurufen (das Ergebnis ist ETH auf Ethereum und SOL auf Solana). Wenn Sie destination_currencies und destination_networks angeben, wird für jedes gültige Währungsnetzwerk-Paar ein Angebot ermittelt. Der Standardwert für destination_currencies ist alle Währungen und der Standardwert für destination_networks ist alle Netzwerke.

Command Line
curl -G https://api.stripe.com/v1/crypto/onramp/quotes \
      -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
      -d "source_amount"="200" \
      -d "destination_currencies[]"="eth" \
      -d "destination_currencies[]"="sol" \
      -d "destination_networks[]"="ethereum" \
      -d "destination_networks[]"="solana"

Sie erhalten eine Antwort ähnlich der folgenden:

{
  "id": "c9ab6fd14f87290ef94b583f0dd346de8e197321e029776c12b7790cd83fb78c",
  "rate_fetched_at": 1674265576.8238478,
  "destination_network_quotes": {
    "bitcoin": [],
    "ethereum": [
      {
        "id": "97bbd7b9f8bc1a029264cdc28b47b636e989f8bcab96a80a3bded2094131e311",
        "destination_currency": "eth",
        "destination_amount": "0.253433817682353791",
        "destination_network": "ethereum",
        "fees": {
          "network_fee_monetary": "1.46",
          "transaction_fee_monetary": "12.71"
        },
        "source_total_amount": "214.17"
      }
    ],
    "polygon": [],
    "solana": [
      {
        "id": "79f00923b96543aa69d140172c7cefd0e73a2ed089d8935e63dcf21028698e23",
        "destination_currency": "sol",
        "destination_amount": "16.767237943",
        "destination_network": "solana",
        "fees": {
          "network_fee_monetary": "0.01",
          "transaction_fee_monetary": "12.70"
        },
        "source_total_amount": "212.71"
      }
    ]
  },
  "livemode": true,
  "source_currency": "usd",
  "source_amount": "200.00"
}

Führen Sie den folgenden Befehl aus, um Angebote für USDC auf Ethereum und Solana abzurufen:

Command Line
curl -G https://api.stripe.com/v1/crypto/onramp/quotes \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "source_amount"="200" \
  -d "destination_currencies[]"="usdc" \
  -d "destination_networks[]"="ethereum" \
  -d "destination_networks[]"="solana"

Sie erhalten eine Antwort ähnlich der folgenden:

{
  "id": "8727e8de9a22915aea079973028054e31d362a328758a5953cee6ba1b6f22569",
  "rate_fetched_at": 1674268717.432479,
  "destination_network_quotes": {
    "bitcoin": [],
    "ethereum": [
      {
        "id": "603f29933c921d59b169572cf2d61da7d88f2a6973da0d6fcb686b3dec3de223",
        "destination_currency": "usdc",
        "destination_amount": "200.00",
        "destination_network": "ethereum",
        "fees": {
          "network_fee_monetary": "5.88",
          "transaction_fee_monetary": "12.76"
        },
        "source_total_amount": "218.64"
      }
    ],
    "polygon": [],
    "solana": [
      {
        "id": "38b8388072e6272e7a0c0d5ee1161d3d747362a574f54fe76f1554ff60e3a007",
        "destination_currency": "usdc",
        "destination_amount": "200.00",
        "destination_network": "solana",
        "fees": {
          "network_fee_monetary": "0.01",
          "transaction_fee_monetary": "12.70"
        },
        "source_total_amount": "212.71"
      }
    ]
  },
  "livemode": true,
  "source_currency": "usd",
  "source_amount": "200.00"
}

Führen Sie den folgenden Befehl aus, um ein Angebot für ein einzelnes Währungsnetzwerk-Zielpaar (ETH auf Ethereum) mit dem angegebenen destination_amount abzurufen:

Command Line
curl -G https://api.stripe.com/v1/crypto/onramp/quotes \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "destination_amount"="0.42" \
  -d "destination_currencies[]"="eth" \
  -d "destination_networks[]"="ethereum"

Sie erhalten eine Antwort ähnlich der folgenden:

{
  "id": "74f73859a8836293ce4f1e6757dc258c9f1016deea7b075faba8b5755d163168",
  "rate_fetched_at": 1674268804.6989243,
  "destination_network_quotes": {
    "bitcoin": null,
    "ethereum": [
      {
        "id": "f1adad5680b081031b03b89c174d25ce6b609416fc82f976423e95a089a10334",
        "destination_currency": "eth",
        "destination_amount": "0.420000000000000000",
        "destination_network": "ethereum",
        "fees": {
          "network_fee_monetary": "1.45",
          "transaction_fee_monetary": "21.06"
        },
        "source_total_amount": "719.53"
      }
    ],
    "polygon": null,
    "solana": null
  },
  "livemode": true,
  "source_currency": "usd",
  "source_amount": "697.02"
}

OptionalWebhook-Ereignisse überwachen

Wir senden einen crypto.onramp_session_updated-Webhook, jedes Mal, wenn sich der Status einer Onramp-Session nach ihrer Erstellung ändert. Beim Erstellen einer neuen Session wird kein Ereignis gesendet. Webhooks können Sie im Dashboard konfigurieren.

Der Webhook verwendet die Ressource CryptoOnrampSession:

{
  "id": "evt_123",
  "object": "event",
  "data": {
    "object": {
      "id": "cos_0MYvv9589O8KAxCGPm84FhVR",
      "object": "crypto.onramp_session",
      "client_secret": "cos_0MYvv9589O8KAxCGPm84FhVR_secret_IGBYKVlTlnJL8UGxji48pKxBO00deNcBuVc",
      "created": 1675794575,
      "livemode": false,
      "status": "initialized",
      "transaction_details": {
        "destination_currency": "eth",
        "destination_amount": null,
        "destination_network": "ethereum",
        "fees": null,
        "lock_wallet_address": false,
        "source_currency": "usd",
        "source_amount": null,
        "destination_currencies": [
          "eth"
        ],
        "destination_networks": [
          "ethereum"
        ],
        "transaction_id": null,
        "wallet_address": null,
        "wallet_addresses": {
          "bitcoin": null,
          "ethereum": "0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2",
          "polygon": null,
          "solana": null,
          "stellar": null,
          "destination_tags": null
        }
      }
    }
  }
}

Frontend-Ereignisse

Sie können die folgenden Frontend-Ereignisse abonnieren:

// when the onramp UI is rendered
{
  type: 'onramp_ui_loaded',
  payload: {session: OnrampSession},
}
// when the onramp session object is updated
{
  type: 'onramp_session_updated',
  payload: {session: OnrampSession},
}

// for modal overlay render mode only
{
  type: 'onramp_ui_modal_opened',
  payload: {session: OnrampSession},
}
{
  type: 'onramp_ui_modal_closed',
  payload: {session: OnrampSession},
}

Wie oben gezeigt, können Sie Ereignisse mit den Standardfunktionen addEventListener und removeEventListener für OnrampSession abonnieren oder abbestellen. Sie können '*' verwenden, um alle Ereignisse zu erfassen.

OptionalKundensupport und Betrugsfälle bearbeiten

Stripe setzt Einschränkungen für den eingebetteten Onramp durch, um den Kundensupport sicherzustellen und im Fall von Betrugsangriffen zu schützen.

Kundensupportfähigkeit prüfen

Übergeben Sie customer_ip_address während der Sitzungserstellung, damit wir die oben genannten Einschränkungen vorbeugend prüfen können.

Der Endpoint gibt HTTP 400 mit code=crypto_onramp_unsupportable_customer zurück, wenn sich die Kundin/der Kunde in einer Region befindet, die wir nicht unterstützen können (basierend auf customer_ip_address). In diesem Fall sollten Sie die Onramp-Option für Kundinnen und Kunden aus dieser Region ausblenden. Andernfalls wird die Onramp-Nutzeroberfläche in einem deaktivierten Status angezeigt.

Hier ist eine Beispielanfrage, die dieses Verhalten veranschaulicht:

Command Line
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "customer_ip_address"="8.8.8.8" \

Beispielantwort (400):

{
  "error": {
    "type": "invalid_request_error",
    "code": "crypto_onramp_unsupportable_customer",
    "message": "Based on the information provided about the customer, we’re currently unable to support them."
  }
}

Betrugsangriffe abwehren

Stripe fungiert als eingetragener Händler und übernimmt die Haftung für Zahlungsanfechtungen und Betrugsfälle. Wenn wir eine Risikosituation feststellen (zum Beispiel bei aktiven Angriffen oder Exploits), können wir die Erstellung von Onramp-Sitzungen vorübergehend einschränken.

Wenn wir die API aufgrund eines unbeschränkten Betrugsangriffs schließen müssen, geben wir Folgendes zurück, wenn jemand versucht, eine neue Sitzung zu erstellen:

Command Line
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \

Sie erhalten eine Antwort ähnlich der folgenden:

{
  "error": {
    "type": "api_error",
    "code": "crypto_onramp_disabled",
    "message": "The v1/crypto/onramp_sessions endpoint has been disabled temporarily. Stripe will get in contact with you about details of the outage.",
    "updated": 1652025690
  }
}

Zusätzliche Validierung und Fehler

BedingungHTTP-StatusFehlercode
Aufgrund eines Vorfalls ist es uns nicht möglich, das Minting neuer Sitzungen durchzuführen400crypto_onramp_disabled
Basierend auf dem Parameter customer_ip_address können wir den/die angegebene/n Verbraucher/in nicht unterstützen.400crypto_onramp_unsupported_country oder crypto_onramp_unsupportable_customer
Es wird eine fehlerhafte customer_ip_address an den Endpoint /v1/crypto/onramp_session übergeben400customer_ip_address
source_amount und destination_amount schließen sich gegenseitig aus, die Plattform legt jedoch beide Werte fest.400crypto_onramp_invalid_source_destination_pair
Eine der Optionen destination_currency und destination_network ist festgelegt, die andere nicht400crypto_onramp_incomplete_destination_currency_and_network_pair
Die Kombination aus destination_currency und destination_network ist ungültig400crypto_onramp_invalid_destination_currency_and_network_pair
source_amount ist festgelegt, aber source_currency ist nicht festgelegt400crypto_onramp_missing_source_currency
source_amount ist keine positive Zahl400crypto_onramp_invalid_source_amount
destination_amount ist festgelegt, aber destination_currency ist nicht festgelegt400crypto_onramp_missing_destination_currency
destination_amount ist keine positive Zahl400crypto_onramp_invalid_destination_amount
Die Kombination aus destination_currencies und destination_networks hat keine unterstützten Währungen400crypto_onramp_invalid_destination_currencies_and_networks
destination_currency ist nicht in destination_currencies enthalten400crypto_onramp_conflicting_destination_currency
destination_network ist nicht in destination_networks enthalten400crypto_onramp_conflicting_destination_network
Mindestens eine Wallet-Adresse in wallet_addresses ist mit einem Netzwerk verknüpft, das nicht in destination_networks enthalten ist.400crypto_onramp_wallet_addresses_not_all_networks_supported
Unter wallet_addresses wurden keine Wallet-Adressen angegeben, aber lock_wallet_address wurde auf true gesetzt400crypto_onramp_no_wallet_address_to_lock
Das Unternehmen hat die Felder business_name oder business_url nicht festgelegt. Diese werden im Dashboard unter Public business name and Business website ausgefüllt400crypto_onramp_merchant_not_properly_setup

OptionalSitzungspersistenz verwenden

Sie können Sitzungs­persistenz verwenden, um Benachrichtigungen bereitzustellen und Kundinnen und Kunden nach Abschluss ihres Kaufs weiterhin in den Onramp-Prozess einzubinden.

Vorteile der Sitzungspersistenz

In einigen Fällen kann es sinnvoll sein, eine Onramp-Session über mehrere Kundenbesuche hinweg beizubehalten. Beispielsweise können Sie Kundinnen und Kunden auffordern, ihre Onramp-Session fortzusetzen, wenn sie unterbrochen oder abgebrochen wurde. Oder wenn ein Kunde bzw. eine Kundin die Seite nach Abschluss der Zahlung aktualisiert, können Sie weiterhin Benachrichtigungen senden, sobald ein früherer Onramp-Kauf ausgeführt wurde.

Aus diesem Grund ist das OnrampSession-Objekt zustandsbehaftet und wird als serverseitige Ressource gespeichert. Wenn die Onramp-Nutzeroberfläche mit einem zuvor verwendeten OnrampSession-Client-Geheimnis initialisiert wird, kehren Kundinnen und Kunden an die Stelle zurück, an der sie aufgehört haben.

Konfiguration der Sitzungspersistenz

Ein Client-Geheimnis ist eine eindeutige Kennung für die Onramp-Sitzung, die den Lebenszyklus einer Sitzung speichert, ohne sensible Zahlungsinformationen preiszugeben. Es legt jedoch private Informationen wie Wallet-Adressen offen. Protokollieren Sie es nicht, betten Sie es nicht in URLs ein und geben Sie es nicht an andere Personen als die Kundin/den Kunden weiter. Stellen Sie sicher, dass Sie TLS auf jeder Seite haben, die das Client-Geheimnis enthält.

Wenn Sie eine Web2-ähnliche Kontostruktur verwenden, können Sie OnrampSession mit Ihrem Kundenobjekt verknüpfen und es nach der Authentifizierung abrufen. Bei einer kontolosen Web3-Anwendung würde die Anforderung einer Nachrichten­signatur zur Authentifizierung zu zusätzlicher Belastung für Kundinnen und Kunden führen. Datenschutzfreundlicher lokaler Speicher bietet hingegen ein akzeptables Kundenerlebnis.

OptionalKonfigurieren Sie den Onramp nach Use Case

Sie können die Onramp-Session-Parameter je nach Use Case konfigurieren:

  • Wallets
  • Dapp- oder NFT-Bezahlvorgang
  • Integration einer dezentralen Börse (DEX)

Damit der Onramp als integraler Bestandteil Ihrer Produkt-UI wirkt, binden Sie ihn als native Komponente in Ihre Anwendung ein.

Wallet

Wallet-Nutzer/innen haben zwei Haupteinstiegspunkte für Onramp-Vorgänge: Wallet-Aufladungen und Transaktions-Aufstockungen.

Wallet-Finanzierung

Sie können Kundinnen und Kunden proaktiv dazu auffordern, ihre Wallet aufzuladen, nachdem sie eine neue Wallet erstellt haben oder wenn ihr Guthaben kritisch niedrig ist.

In diesen Fällen sollten Sie die folgenden Parameter angeben:

  • wallet_addresses: Die bereits genutzte Wallet-Adresse verwenden.
  • destination_networks: Auf das Standardnetzwerk oder das ausgewählte Netzwerk setzen, um Verwirrung bei Kundinnen und Kunden zu reduzieren.
  • destination_currencies: Sie können dieses Feld leer lassen, aber Sie können es auch auf das negative Gas-Token oder beliebige Kryptowährungen beschränken. Wenn Sie beispielsweise einen DeFi-Dienst in USDC anbieten, sollten Sie berücksichtigen, dass die/der Nutzer/in wahrscheinlich sowohl USDC als auch den Gas-Token benötigt.
  • destination_network: Lassen Sie dieses Feld leer, um den ersten Wert des unterstützten Netzwerks zu übernehmen.
  • destination_currency: Lassen Sie dieses Feld leer, um den ersten Wert der unterstützten Kryptowährungen zu übernehmen.

Das folgende Codebeispiel zeigt die Erstellung einer Onramp-Sitzung mit mehreren dieser Parameter:

Command Line
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "customer_ip_address"="8.8.8.8" \
  -d "wallet_addresses[ethereum]"="0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2" \
  -d "wallet_addresses[solana]"="bufoH37MTiMTNAfBS4VEZ94dCEwMsmeSijD2vZRShuV" \
  -d "destination_networks[]"="ethereum" \
  -d "destination_networks[]"="solana"

Transaktionsaufstockungen

Wenn eine Dapp oder eine Kundin/ein Kunde eine Transaktion vorschlägt, stellen Sie möglicherweise fest, dass die Transaktion aufgrund unzureichender Mittel fehlschlägt. In diesem Fall können Sie die Differenz berechnen, die erforderlich ist, damit die Transaktion abgeschlossen werden kann. Es ist jedoch oft schwierig, den angeforderten Betrag oder die Kryptowährung für ERC- oder SPL-Token zu erkennen.

In diesen Fällen sollten Sie Folgendes angeben:

  • wallet_addresses: Die genutzte Wallet-Adresse verwenden.
  • destination_networks: Auf das ausgewählte Netzwerk festlegen.
  • destination_currencies: Beschränken Sie sich nach Möglichkeit auf die fehlenden Währungen.
  • destination_network: Auf das ausgewählte Netzwerk festlegen (ein erforderlicher Wert, wenn Sie den Betrag festlegen möchten).
  • destination_currency: Auf die Zielwährung festlegen (ein erforderlicher Wert, wenn Sie den Betrag festlegen möchten.
  • destination_amount: Auf die Saldodifferenzen festlegen und ggf. einen Puffer für Gasgebühren lassen.

Das folgende Codebeispiel zeigt die Erstellung einer Onramp-Sitzung mit mehreren dieser Parameter:

Command Line
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "customer_ip_address"="8.8.8.8" \
  -d "wallet_addresses[ethereum]"="0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2" \
  -d "destination_networks[]"="ethereum" \
  -d "destination_currencies[]"="usdc" \
  -d "destination_network"="ethereum" \
  -d "destination_currency"="usdc" \
  -d "destination_amount"="10"

Dapp- oder NFT-Bezahlvorgang

Sie können die Onramp im Bezahlvorgang verwenden, wenn Sie den Zielbetrag kennen. Zum Beispiel kann eine Dapp verwendet werden, um Mitgliedschaften zu einem festen Preis zu verkaufen oder wenn die/der Nutzer/in einen bestimmten NFT von einem Marktplatz kaufen möchte.

In diesen Fällen sollten Sie Folgendes angeben:

  • wallet_addresses: Adresse der verbundenen Wallet verwenden.
  • destination_networks: Verbundenes Netzwerk verwenden.
  • destination_currencies: Verwenden Sie die dargestellte Währung (den Preis in der Währung, in der die Waren angeboten werden).
  • destination_network: Auf das oben ausgewählte Netzwerk festlegen (erforderlich, wenn Sie den Betrag festlegen möchten).
  • destination_currency: Auf die obige Zielwährung festlegen (erforderlich, wenn Sie den Betrag festlegen möchten)
  • destination_amount: Legen Sie diesen Wert entweder auf die Differenz des Guthabens oder auf den gesamten Kaufbetrag fest. Einige Kundinnen und Kunden kombinieren beides, indem sie On-Chain-Analysen mit nahezu gleichmäßiger Aufteilung nutzen. Eine Kundin/ein Kunde könnte den vollen Betrag wählen, um die steuerliche Bemessungsgrundlage zu vereinfachen oder um angesammelte Vermögenswerte nicht auszugeben. In beiden Fällen sollte ausreichend Spielraum für Gaskosten bleiben.

Das folgende Codebeispiel zeigt die Erstellung einer Onramp-Sitzung mit mehreren dieser Parameter:

Command Line
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "customer_ip_address"="8.8.8.8" \
  -d "wallet_addresses[ethereum]"="0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2" \
  -d "destination_networks[]"="ethereum" \
  -d "destination_currencies[]"="eth" \
  -d "destination_network"="ethereum" \
  -d "destination_currency"="eth" \
  -d "destination_amount"="0.2343"

DEX

Eine DEX bietet eine einzigartige Möglichkeit, Kundinnen und Kunden den Kauf von Kryptowährungen mit Fiat zu ermöglichen. Eine DEX kann Kundinnen/Kunden zwar dazu auffordern, beim Umtausch beliebiger Krypto-Paare über eine bestehende Schnittstelle Kryptowährungen aufzuladen, aber es ist besser, einen speziellen Ablauf für Kundinnen/Kunden zu haben, der sich ausschließlich auf den Umtausch von Fiat-Währungen in Kryptowährungen konzentriert.

Da das Onramp Ihnen die Kontrolle über Ihre Marke und Nutzeroberfläche ermöglicht, kann eine DEX ein Onramp-Widget erstellen, das Stripes Fähigkeit nutzt, Fiat-Währungen in ausgewählte Kryptowährungen umzuwandeln. Die DEX kann anschließend den abschließenden Umtausch in beliebige Währungen durchführen. Eine DEX kann außerdem ein Onramp-Widget für einen bestimmten Token erstellen. Beispielsweise könnte eine DAO einen bestimmten Liquiditätspool empfehlen und mithilfe einer DEX ihre Token vertreiben und neue Kundinnen und Kunden mit Fiat-Währungen zu gewinnen.

In diesen Fällen sollten Sie Folgendes angeben:

  • wallet_addresses: Die bereits genutzte Wallet-Adresse verwenden.
  • destination_networks: Auf das ausgewählte Netzwerk festlegen.
  • destination_currencies: Auf die ausgewählte Kryptowährung beschränken.
  • destination_network: Auf das ausgewählte Netzwerk festlegen (erforderlich, wenn Sie den Betrag festlegen möchten).
  • destination_currency: Legen Sie die Zielwährung fest (erforderlich, wenn Sie den Betrag festlegen möchten).
  • destination_amount: Wird nur festgelegt, wenn Sie die Absicht der Kundin/des Kunden im Voraus erfassen können – andernfalls leer lassen, damit Stripe intelligente Standardwerte vorschlägt.

Das folgende Codebeispiel zeigt die Erstellung einer Onramp-Sitzung mit mehreren dieser Parameter:

Command Line
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "customer_ip_address"="8.8.8.8" \
  -d "wallet_addresses[ethereum]"="0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2" \
  -d "destination_networks[]"="ethereum" \
  -d "destination_currencies[]"="eth" \
  -d "destination_network"="ethereum" \
  -d "destination_currency"="eth"
War diese Seite hilfreich?
JaNein