バックエンド導入レシピベータ
ユーザー体験を最適化するために、オンランプはアプリケーションのネイティブコンポーネントとしてフレーム化してください。フロントエンドのデザインに加え、バックエンドでオンランプセッションを作成する際は、多くの場合オンランプのパラメーターを事前入力することが必要になります。以下に、一般的なユースケースと推奨の実装を紹介します。
ウォレット
ウォレットユーザーにはオンランプの主要エントリーポイントが 2 つあります。1 つはウォレットの資金追加で、もう 1 つは取引でのトップアップです。
ウォレットでの資金追加
ユーザーが新しいウォレットを作成した後、あるいは資金が極めて少ないときに、ウォレットに資金を追加するように積極的に促すことができます。
このような場合には、以下を指定できます。
wallet_addresses
: すでに使用しているウォレットアドレスを使用しますdestination_networks
: デフォルトまたは選択したネットワークに設定し、ユーザーの混乱を軽減しますdestination_currencies
: これを空白のままにしても構いません。ただし、必要に応じて、ネイティブガストークンや望ましい仮想通貨に限定することもできます (たとえば、USDC で Defi サービスを提供している場合は、ユーザーが USDC とガストークンの両方を必要とする可能性が高いケースを考慮してください)destination_network
: これを空白のままにすると、サポートされているネットワークの最初の値を継承しますdestination_currency
: これを空白にすると、サポート対象の仮想通貨の最初の値を継承します
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
取引のトップアップ
Dapp またはユーザーが取引を提案したときに、資金不足が原因で取引が失敗することがあります。この場合、取引の完了に必要な差額を計算できます。ただし、ERC トークンまたは SPL トークンでリクエストされた金額や仮想通貨は、多くの場合検出が困難です。
このような場合には、以下を指定できます。
wallet_addresses
: 使用しているウォレットアドレスを使用しますdestination_networks
: 選択したネットワークに設定しますdestination_currencies
: 可能な場合は不足している通貨に限定しますdestination_network
: 選択したネットワークに設定します (金額を設定する場合は必須値)destination_currency
: ターゲット通貨に設定します (金額を設定する場合は必須値)destination_amount
: 残高の差異に設定し、できればガス (手数料) 用に十分な余地を残しておきます
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 または NFT の決済
一部のアプリケーションでは、送金額がわかっている場合に決済でオンランプを使用できます。たとえば、Dapp を使用して、固定価格でメンバーシップを販売できます。あるいは、ユーザーがマーケットプレイスから特定の NFT を購入しようとする場合もあります。
このような場合には、以下を指定できます。
wallet_addresses
: 接続されているウォレットアドレスを使用しますdestination_networks
: 接続されているネットワークを使用しますdestination_currencies
: 取引通貨 (商品の見積もりに使用される通貨での価格) を使用しますdestination_network
: 上記の選択したネットワークに設定します (金額を設定する場合は必須値)destination_currency
: 上記のターゲット通貨に設定します (金額を設定する場合は必須値)destination_amount
: 残高の差異に設定するか、購入金額全体を対象とします。均等なスプリットのみを対象として、両方のオンチェーン分析を採用するユーザーもいます。また、全額を選択して、税金の原価基準をシンプルにしたり、蓄積している資産を使わないようにすることもできます。いずれの場合でも、ガス (手数料) 用の余地を残しておく必要があります。
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
DEX は、ユーザーが法定通貨で仮想通貨を購入できる独自の機会を提供します。DEX では既存のインターフェイスを使用して任意の仮想通貨ペアを交換する際に仮想通貨をトップアップするようにユーザーを徐々に促すことができます。ただし、法定通貨から仮想通貨への方向にのみを目的とする専用のユーザーフローを用意することをお勧めします。
オンランプではブランドとユーザー体験を所有できるため、DEX でオンランプウィジェットを構築し、法定通貨を厳選した仮想通貨に調製する Stripe の能力を活用できます。DEX では、仮想通貨を任意の通貨に交換する最終工程を完了できます。また、DEX では特定のトークンのオンランプウィジェットを構築することもできます。たとえば、DAO では特定の流動性プールを承認し、DEX を使用してトークンを分散し、法定通貨で新規ユーザーをアカウント登録することができます。
このような場合には、以下を指定できます
wallet_addresses
: すでに使用しているウォレットアドレスを使用しますdestination_networks
: 選択したネットワークに設定しますdestination_currencies
: 選択した仮想通貨に限定しますdestination_network
: 選択したネットワークに設定します (金額を設定する場合は必須値)destination_currency
: ターゲット通貨に設定します (金額を設定する場合は必須値)destination_amount
: 前もってユーザーのインテントを収集できる場合にのみ設定します。空白のままにすれば、Stripe が適切なデフォルト値を提案します
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