Best Practices für die Backend-IntegrationBeta
Integrieren Sie die Onramp sicher für verschiedene web3 Use cases.
Um Onramp als Teil Ihrer Produkt-Nutzeroberfläche erscheinen zu lassen, sollten Sie Onramp als native Komponente Ihrer Anwendung gestalten. Ziehen Sie zusätzlich zum Frontend-Design in Erwägung, Onramp-Parameter bei der Erstellung einer Onramp-Sitzung im Backend vorauszufüllen.
Wallet
Wallet-Nnutzer/innen haben zwei Haupteinstiegspunkte auf der Rampe: Wallet-Finanzierung und Transaktionsaufstockungen.
Wallet-Finanzierung
Sie können Nutzer/innen proaktiv auffordern, ihre Wallet aufzustocken, 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_: Die bereits genutzte Wallet-Adresse verwenden.addresses destination_: Auf das Standardnetzwerk oder das ausgewählte Netzwerk setzen, um Verwirrung zu vermeiden.networks destination_: 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 der/die Nutzer/in wahrscheinlich sowohl USDC als auch das Gas-Token benötigt.currencies destination_: Lassen Sie dieses Feld leer, um den ersten Wert des unterstützten Netzwerks zu übernehmen.network destination_: Lassen Sie dieses Feld leer, um den ersten Wert der unterstützten Kryptowährungen zu übernehmen.currency
Das folgende Codebeispiel zeigt die Erstellung einer Onramp-Sitzung mit mehreren dieser Parameter:
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \ -u: \ -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"sk_test_4eC39HqLyjWDarjtT1zdp7dc
Transaktionsaufstockungen
Wenn eine Dapp oder der/die Nutzer/in eine Transaktion vorschlägt, stellen Sie möglicherweise fest, dass die Transaktion aufgrund unzureichender Deckung fehlschlägt. In diesem Fall können Sie das Delta berechnen, das für den Abschluss der Transaktion erforderlich ist. 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_: Die genutzte Wallet-Adresse verwenden.addresses destination_: Auf das ausgewählte Netzwerk festlegen.networks destination_: Beschränken Sie sich nach Möglichkeit auf die fehlenden Währungen.currencies destination_: Auf das ausgewählte Netzwerk festlegen (ein erforderlicher Wert, wenn Sie den Betrag festlegen möchten).network destination_: Auf die Zielwährung festlegen (ein erforderlicher Wert, wenn Sie den Betrag festlegen möchten.currency destination_: Auf die Saldodifferenzen festlegen und ggf. einen Puffer für Gasgebühren lassen.amount
Das folgende Codebeispiel zeigt die Erstellung einer Onramp-Sitzung mit mehreren dieser Parameter:
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \ -u: \ -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"sk_test_4eC39HqLyjWDarjtT1zdp7dc
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 der/die Nutzer/in ein bestimmtes NFT von einem Marktplatz kaufen möchte.
In diesen Fällen sollten Sie Folgendes angeben:
wallet_: Adresse der verbundenen Wallet verwenden.addresses destination_: Verbundenes Netzwerk verwenden.networks destination_: Verwenden Sie die dargestellte Währung (den Preis in der Währung, in der die Waren angeboten werden).currencies destination_: Auf das oben ausgewählte Netzwerk festlegen (erforderlich, wenn Sie den Betrag festlegen möchten).network destination_: Auf die obige Zielwährung festlegen (erforderlich, wenn Sie den Betrag festlegen möchten)currency destination_: Entweder auf die Saldo-Differenz oder auf die Deckung des gesamten Kaufbetrags festlegen. Einige Nutzer/innen setzen beides ein, indem sie On-Chain-Analysen mit nahezu gleichmäßiger Aufteilung verwenden. Eine Nutzerin/ein Nutzer kann den vollen Betrag wählen, um die Steuerkostenbasis zu vereinfachen oder um zu vermeiden, aufgelaufene Vermögenswerte auszugeben. Lassen Sie in beiden Fällen Raum für Gas.amount
Das folgende Codebeispiel zeigt die Erstellung einer Onramp-Sitzung mit mehreren dieser Parameter:
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \ -u: \ -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"sk_test_4eC39HqLyjWDarjtT1zdp7dc
DEX
Ein DEX bietet eine hervorragende Möglichkeit, Nutzer/innen den Kauf von Kryptowährungen mit Fiatgeld zu ermöglichen. Während ein DEX Nutzer/innen auffordern kann, Kryptowährungen aufzustocken, wenn sie beliebige Kryptowährungspaare über eine bestehende Schnittstelle austauschen, ist es besser, einen dedizierten Nutzerablauf zu haben, der sich nur auf Fiat zu Kryptowährungen konzentriert.
Da Sie mit der Onramp Ihre Marke und Ihre Nutzeroberfläche selbst steuern können, können Sie ein Onramp-Widget erstellen, das die Funktion von Stripe nutzt, Fiat in ausgewählte Kryptowährungen umzuwandeln. Der DEX kann dann den endgültigen Umtausch in beliebige Währungen vornehmen. Ein DEX kann auch ein Onramp-Widget für ein bestimmtes Token erstellen. Zum Beispiel kann eine DAO einen bestimmten Liquiditätspool unterstützen und einen DEX verwenden, um ihre Token zu verteilen und neue Nutzer/innen mit Fiat zu integrieren.
In diesen Fällen sollten Sie Folgendes angeben:
wallet_: Die bereits genutzte Wallet-Adresse verwenden.addresses destination_: Auf das ausgewählte Netzwerk festlegen.networks destination_: Auf die ausgewählte Kryptowährung beschränken.currencies destination_: Auf das ausgewählte Netzwerk festlegen (erforderlich, wenn Sie den Betrag festlegen möchten).network destination_: Legen Sie die Zielwährung fest (erforderlich, wenn Sie den Betrag festlegen möchten).currency destination_: Wird nur festgelegt, wenn Sie die Absicht des/der Nutzer/in im Voraus erfassen können. Lassen Sie das Feld leer, damit Stripe intelligente Standardwerte vorschlägt.amount
Das folgende Codebeispiel zeigt die Erstellung einer Onramp-Sitzung mit mehreren dieser Parameter:
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \ -u: \ -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"sk_test_4eC39HqLyjWDarjtT1zdp7dc