Eigenständigen 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 API, einschließlich Testumgebungen, zuzugreifen, müssen Sie diese Schritte befolgen, um Ihre Anwendung einzureichen. Wir überprüfen die meisten Onramp-Anwendungen innerhalb von 48 Stunden.

Erstellen oder melden Sie sich bei Ihrem Stripe-Konto an und reichen Sie das Onramp-Anmeldeformular ein.
Füllen Sie Ihr Stripe-Anmeldeformular aus.
Beginnen Sie nach dem Absenden des Anmeldeformulars mit der Entwicklung unter Verwendung von Testumgebungen.

Wir benachrichtigen Sie, wenn Ihr Anmeldeformular genehmigt wurde oder wenn wir weitere Informationen benötigen. Sie können den Status Ihres Anmeldeformulars jederzeit auf der Onboarding-Seite überprüfen.

Eigenständiges Onramp ohne Code

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.comIn Zwischenablage kopieren

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

Eigenständigen 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/basil/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 für jeden Nutzerbesuch eine neue Onramp-Sitzung zu erstellen. Die Onramp-Sitzung gibt eine redirect_url zurück. Leiten Sie Ihre Nutzer/innen an die URL weiter, um eine vollständig angepasste Crypto-Onramp mit Branding für die eigenständige Onramp zu erhalten.

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