オンラインのスタンドアロン型オンランプを使用するベータ
オンラインのスタンドアロン型オンランプは、https://crypto.link.com でホストされている仮想通貨オンランプの構築済みフロントエンド実装です。プラットフォームが仮想通貨オンランプを実装するには、アプリケーションに埋め込まれたオンランプをホストするのではなく、ユーザーをオンラインのスタンドアロン型オンランプにリダイレクトします。
リダイレクト URL を作成する | リダイレクト URL でセッションを発行する | |
---|---|---|
概要 | Stripe アカウントなしで、フロントエンドでリダイレクト URL を生成します。 | Stripe アカウントを使用して、バックエンドでリダイレクト URL を指定したセッションを作成します。 |
カスタマイズ | 想定されるソースまたは送金額、入金先通貨とネットワークをカスタマイズします。 | 入金先のウォレットアドレスを含む、完全なカスタマイズを許可します。パラメーターの全リストについては、API を使用するをご覧ください。 |
最適なビジネス | ブランディングをせずに、部分的なカスタマイズでシンプルなフロントエンドのみの導入を希望するプラットフォーム。 | ブランディングによるオンランプの完全なカスタマイズを希望するプラットフォーム。 |
プラットフォームは、オンランプを導入することにより、仮想オンランプをアプリケーション内に埋め込むことができます。
リダイレクト URL を作成する
以下のスクリプトを、script タグを使用して HTML の <head>
要素内に含めます。互換性と PCI 準拠のため、このスクリプトは常に Stripe のドメイン (https://js.stripe.com、https://crypto-js.stripe.com) から直接読み込んでください。このスクリプトをバンドルに含めたり、そのコピーを自分でホストしたりしないでください。その場合、警告なしに実装が壊れる可能性があります。
<head> <title>Onramp</title> <script src="https://js.stripe.com/v3/"></script> <script src="https://crypto-js.stripe.com/crypto-onramp-outer.js"></script> </head>
Standalone
関数を使用して、リダイレクト URL を作成し、希望のパラメーターを渡します。
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();
次のパラメーターに事前入力できます。
source_currency
: 取引の法定通貨 (当面はusd
のみ)。amount
: 法定通貨または仮想通貨によるこの購入の固定金額。法定通貨の金額を指定するには、source_amount
(例:{source_amount: 42}
) を渡します。仮想通貨の金額を指定するには、destination_amount
(例:{destination_amount: 42}
) を渡します。指定できる金額は 1 つのみです。destination_currencies
: 限定先にする仮想通貨の配列 (例:[eth, usdc]
)。destination_networks
: 限定先にする仮想通貨ネットワークの配列 (例:[ethereum, polygon]
)。destination_network
: このオンランプのデフォルト仮想通貨ネットワーク (例:ethereum
)。destination_currency
: このオンランプセッションのデフォルト仮想通貨 (例:eth
)。
フロントエンドで仮想通貨オンランプが事前構築されたオンラインのスタンドアロン型オンランプの URL に、ユーザーをリダイレクトします。
リダイレクト URL でセッションを発行する
他の実装と同様に、ユーザーがアクセスするたびに新規オンランプセッションを作成するサーバーエンドポイントを実装する必要があります。オンランプセッションの作成リクエストが redirect_url
を返します。オンラインのスタンドアロン型オンランプで全面的にブランド化したカスタムの仮想通貨オンランプの URL に、ユーザーをリダイレクトします。
redirect_url
を使用して、仮想通貨オンランプセッションを生成するために、端末で次の curl コマンドを実行します。
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \ -u
:sk_test_4eC39HqLyjWDarjtT1zdp7dc
サンプルレスポンス:
{ "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 } }