Stripe がオンラインで提供するスタンドアロン型オンランプを使用する公開プレビュー

リダイレクト URL を生成し、スタンドアロン型オンランプのセッションを発行します。

Stripe がオンラインで提供するスタンドアロン型オンランプは、https://crypto.link.com でホストされている仮想通貨オンランプの構築済みフロントエンド実装です。プラットフォームが仮想通貨オンランプを実装するには、アプリケーションに埋め込まれたオンランプをホストするのではなく、ユーザーをスタンドアロン型オンランプにリダイレクトします。オンランプを埋め込むには、申し込みを送信する必要があります。

	リダイレクト URL を生成する	リダイレクト URL でセッションを発行する
概要	Stripe アカウントなしで、フロントエンドでリダイレクト URL を生成します。	Stripe アカウントを使用して、バックエンドでリダイレクト URL を指定したセッションを作成します。
カスタマイズ	想定されるソースまたは送金額、入金先通貨とネットワークをカスタマイズします。	入金先のウォレットアドレスを含む、完全なカスタマイズを許可します。パラメーターの全リストについては、取引パラメーターに事前入力するをご覧ください。
最適なユーザー	ブランディングをせずに、部分的なカスタマイズでシンプルなフロントエンドのみの導入を希望するプラットフォーム。	ブランディングによるオンランプの完全なカスタマイズを希望するプラットフォーム。

リダイレクト 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、eur)。
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 に、ユーザーをリダイレクトします。

次の curl コマンドを実行し、redirect_url を指定して仮想通貨オンランプセッションを生成します。

Command Line
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \
  -usk_test_BQokikJOvBiI2HlWgH4olfQ2
:

次のようなレスポンスを受信します。

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