Rezepte für die Backend-IntegrationBeta
Um die Nutzererfahrung zu optimieren, gestalten Sie Onramp als native Komponente Ihrer Anwendung. Zusätzlich zum Frontend-Design möchten Sie häufig Onramp-Parameter vorab ausfüllen, wenn Sie eine Onramp-Sitzung im Backend erstellen. Im Folgenden finden Sie einige häufige Anwendungsfälle und empfohlene Implementierungen.
Wallet
Wallet-Nutzer/innen haben zwei wesentliche Onramp-Einstiegspunkte: das Wallet-Finanzieren und das Aufladen von Transaktionen.
Finanzierung über Wallet
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 können Sie Folgendes angeben:
wallet_addresses
: Verwenden Sie die bereits verwendete Wallet-Adresse.destination_networks
: Auf das Standardnetzwerk oder das ausgewählte Netzwerk setzen, um Verwirrung zu vermeiden.destination_currencies
: Sie können dieses Feld leer lassen, aber optional können Sie es auf den nativen Gas-Token oder beliebige Kryptowährungen beschränken (wenn Sie zum Beispiel einen Defi-Dienst in USDC anbieten, sollten Sie den Fall betrachten, dass der/die Nutzer/in wahrscheinlich sowohl USDC als auch das Gas benötigt).destination_network
: Lassen Sie dieses Feld leer, um den ersten Wert des unterstützten Netzwerks zu erben.destination_currency
: Lassen Sie dieses Feld leer, um den ersten Wert der unterstützten Kryptowährungen zu übernehmen.
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
Aufstockung der Transaktion
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 können Sie Folgendes angeben:
wallet_addresses
: Verwenden Sie die verwendete Wallet-Adressedestination_networks
: Auf das ausgewählte Netzwerk festlegendestination_currencies
: Beschränken Sie sich nach Möglichkeit auf die fehlenden Währungendestination_network
: Auf das ausgewählte Netzwerk festlegen (ein erforderlicher Wert, wenn Sie den Betrag festlegen möchten)destination_currency
: Auf die Zielwährung einstellen (ein erforderlicher Wert, wenn Sie den Betrag festlegen möchten)destination_amount
: Auf die Saldo-Differenzen festlegen und gegebenenfalls genügend Puffer für Gasgebühren lassen
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
In einigen Anwendungen können Sie 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 können Sie Folgendes angeben:
wallet_addresses
– Adresse der verbundenen Wallet verwendendestination_networks
: Verbundenes Netzwerk verwendendestination_currencies
– Verwenden Sie die dargestellte Währung (d. h. den Preis in der Währung, in der die Waren angeboten werden).destination_network
: Auf das oben ausgewählte Netzwerk einstellen (ein erforderlicher Wert, wenn Sie den Betrag festlegen möchten)destination_currency
– Auf die obige Zielwährung einstellen (ein erforderlicher Wert, wenn Sie den Betrag festlegen möchten)destination_amount
: 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 und aufgelaufene Vermögenswerte nicht auszugeben. In beiden Fällen sollte die Gasgebühr mit eingeplant werden.
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 einzigartige Möglichkeit, Nutzer/innen den Kauf von Kryptowährungen mit Fiatgeld zu ermöglichen. Während ein DEX Nutzer/innen inkrementell dazu auffordern kann, Kryptowährungen aufzustocken, wenn sie beliebige Kryptowährungspaare über eine bestehende Schnittstelle austauschen, ist es vorzuziehen, einen dedizierten Nutzerablauf zu haben, der sich nur auf Fiat zu Kryptowährungen konzentriert.
Da Sie mit onramp Ihre Marke und Ihr Nutzererlebnis selbst gestalten können, kann ein DEX ein onramp-Widget erstellen, das die Fähigkeit von Stripe nutzt, Fiat in ausgewählte Kryptowährungen umzuwandeln, und DEX kann den letzten Schritt des Umtauschs in beliebige Währungen abschließen. 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 möchten Sie möglicherweise Folgendes angeben
wallet_addresses
– Verwenden Sie die bereits verwendete Wallet-Adressedestination_networks
: Auf das ausgewählte Netzwerk festlegendestination_currencies
: Auf die ausgewählte Kryptowährung beschränkendestination_network
– Auf das ausgewählte Netzwerk festlegen (ein erforderlicher Wert, wenn Sie den Betrag festlegen möchten)destination_currency
– Auf die Zielwährung einstellen (ein erforderlicher Wert, wenn Sie den Betrag festlegen möchten)destination_amount
– 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.
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