Von Stripe gehosteten Onramp verwendenÖffentliche Vorschau

Generieren Sie eine Weiterleitungs-URL und führen Sie das Minting einer Sitzung für die eigenständige Onramp durch.

The Stripe-hosted, standalone onramp is a prebuilt frontend integration of the crypto onramp hosted at https://crypto.link.com. Platforms can integrate the crypto onramp by redirecting their users to the standalone onramp, rather than hosting an embedded version of the onramp within their application.

Bevor Sie beginnen

Um auf die Onramp-Funktion von Stripe zuzugreifen, einschließlich Testumgebungen, müssen Sie die folgenden Schritte ausführen, um Ihr Anmeldeformular einzureichen:

Erstellen Sie ein Stripe-Konto oder melden Sie sich bei Ihrem Stripe-Konto an.
Falls noch nicht geschehen, aktivieren Sie Ihr Stripe-Konto.
Übermitteln Sie Ihr Onramp-Anmeldeformular. Wir prüfen die meisten Onramp-Anmeldeformulare innerhalb von 48 Stunden und benachrichtigen Sie, wenn Sie genehmigt wurden oder wenn wir weitere Informationen benötigen. Sie können Ihren Status jederzeit im Dashboard überprüfen.
Nachdem wir Ihren Antrag genehmigt haben, wählen Sie eine Integration und beginnen Sie mit der Entwicklung über eine Sandbox.

Von Stripe gehosteter Onramp

Die Weiterleitungs-URL des eigenständigen Onramps unterstützt die Anpassung der Parameter und ermöglicht es Ihnen, Felder wie die Ziel- und Ausgangswährungen sowie den Ausgangs- oder Zielbetrag vorab auszufüllen.

Teilen Sie den Link, indem Sie ihn direkt an Nutzer/innen senden oder ihn mit einer Schaltfläche anzeigen, wie in der folgenden Demo.

Nutzer/innen direkt an diese URL weiterleiten

https://crypto.link.comCopy to clipboard

Livemode

Beispielschaltfläche mit Weiterleitungs-URL

Buy Crypto

Eine Weiterleitungs-URL mit Code generieren

const standaloneOnramp = window.StripeOnramp.Standalone();
const redirectUrl = standaloneOnramp.getUrl();

return (
  <a href={redirectUrl}>
    Buy Crypto
  </a>
);

Von Stripe gehosteten Onramp anpassen

Sie können auch eine Weiterleitungs-URL mit Code generieren, indem Sie die Funktion Eigenständig verwenden und die gewünschten Felder auswählen. Sie können entweder eine Weiterleitungs-URL generieren oder eine Sitzung mit einer Weiterleitungs-URL erstellen:

Anpassungsoption	Übersicht	Am besten geeignet für
Weiterleitungs-URL generieren	Generieren Sie eine Weiterleitungs-URL im Frontend ohne Stripe-Konto. Passen Sie den vorgeschlagenen Ausgangs- oder Zielbetrag, die Währungen und das Netzwerk an.	Wenn Sie eine schlanke Frontend-Integration mit übersichtlicher Anpassung und ohne Branding wünschen.
Minting einer Sitzung mit einer Weiterleitungs-URL	Minting einer Sitzung mit einer Weiterleitungs-URL im Backend mit einem Stripe-Konto. Ermöglicht eine vollständige Anpassung, einschließlich der Ziel-Wallet-Adresse. Eine vollständige Liste der Parameter finden Sie unter Transaktionsparameter vorab ausfüllen.	Wenn Sie einen vollständig personalisierten Onramp mit Branding wünschen.

Weiterleitungs-URL generieren

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 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.

<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>

Generieren Sie eine Weiterleitungs-URL mit der Standalone-Funktion und übergeben Sie die gewünschten Parameter:

const standaloneOnramp = window.StripeOnramp.Standalone({
  source_currency: 'usd',
  amount: {source_amount: '42'},
  destination_networks: ['ethereum', 'bitcoin'],
  destination_currencies: ['eth', 'btc'],
  destination_currency: 'btc',
  destination_network: 'bitcoin'
});
const redirectUrl = standaloneOnramp.getUrl();

Sie können diese Parameter vorab ausfüllen:

source_currency: Die Fiat-Währung für die Transaktion (usd und eur).
amount: Der feste Betrag in einer Fiat-Währung oder Kryptowährung für diesen Kauf. Geben Sie einen Fiat-Betrag an, indem Sie source_amount ({source_amount: 42}) übergeben. Geben Sie einen Kryptowährungsbetrag an, indem Sie destination_amount ({destination_amount: 42}) übergeben. Sie können nur einen Betrag festlegen.
destination_currencies: Ein Array von Kryptowährungen, die Sie auf (['eth', 'usdc']) beschränken möchten.
destination_networks: Ein Array von Krypto-Netzwerken, die Sie auf (['Ethereum', 'Polygon']) beschränken möchten.
destination_network: Das Standard-Kryptonetzwerk für diese Onramp (ethereum).
destination_currency: Die Standard-Kryptowährung für diese Onramp-Sitzung (eth).

Leiten Sie Ihre Nutzer/innen an die URL für eine vorgefertigte Frontend-Integration der Krypto-Onramp auf der eigenständigen Onramp weiter.

Minting einer Sitzung mit einer Weiterleitungs-URL

Ähnlich wie bei anderen Integrationen müssen Sie einen Server-Endpoint implementieren, um bei jedem Benutzerbesuch eine neue Onramp-Sitzung zu erstellen. Die Anfrage zur Erstellung der Onramp-Sitzung gibt eine redirect_url zurück. Leiten Sie Ihre Nutzerinnen und Nutzer zu dieser URL weiter, um einen vollständig angepassten und gebrandeten Crypto-Onramp auf dem eigenständigen Onramp bereitzustellen.

Erstellen Sie eine Crypto-Onramp-Sitzung mit einer redirect_url, indem Sie den folgenden curl-Befehl ausführen:

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

Sie erhalten eine Antwort ähnlich der folgenden:

{
  "id": "cos_0MpKNb589O8KAxCGjmaOVF8T",
  "object": "crypto.onramp_session",
  "client_secret": "cos_0MpKNb589O8KAxCGjmaOVF8T_secret_fqV1TAdhSCFeO9FW5HnygRXca00AwEHIOu8",
  "created": 1679701843,
  "livemode": false,
  "redirect_url": "https://crypto.link.com?session_hash=CCwaGwoZYWNjdF8yOERUNTg5TzhLQXhDR2JMbXh5WijU7vigBjIGmyBbkqO4Oi10eFHEaFln9gFSsTGQBoQf5qRZK-A0NhiEIeH3QaCMrz-d4oYotirrAd_Bkz4",
  "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
  }
}