# Stripe 主催のオンランプをご利用ください。 リダイレクト URL を生成し、スタンドアロン型オンランプのセッションを発行します。 The Stripe-hosted, standalone onramp is a prebuilt frontend integration of the crypto onramp hosted at . Platforms can integrate the crypto onramp by redirecting their users to the standalone onramp, rather than hosting an embedded version of the onramp within their application. ## はじめに テスト環境を含む Stripe オンランプにアクセスするには、以下の手順に従って申請する必要があります。 1. [Stripe アカウントを作成するか、サインインします](https://dashboard.stripe.com/register)。 1. まずは [Stripe アカウントを有効にしてください](https://dashboard.stripe.com/account/onboarding)。 1. [オンランプ申請書を提出してください](https://dashboard.stripe.com/crypto-onramp/get-started)。ほとんどのオンランプ申請は 48 時間以内に審査され、承認された場合、または追加の情報が必要な場合には通知が送られます。アプリケーションステータスは[ダッシュボード](https://dashboard.stripe.com/crypto-onramp/onboarding)でいつでもご確認いただけます。 1. 申請が承認されたら[統合を選択](https://docs.stripe.com/crypto/onramp.md#integration-options)し、[サンドボックス](https://docs.stripe.com/sandboxes.md)を利用して開発を開始します。 ## Stripe 主催のオンランプ スタンドアロンオンランプのリダイレクト URL は、パラメーターのカスタマイズをサポートし、宛先通貨、ソース金額または宛先金額などのフィールドに事前入力できます。 次のデモのように、リンクをユーザーに直接送信するか、ボタンで表示して、リンクを共有します。 ## Stripe 主催のオンランプをカスタマイズする `Standalone` 関数を使用してコードでリダイレクト URL を生成し、目的のフィールドを渡すこともできます。リダイレクト URL を生成するか、リダイレクト URL を使用してセッションを作成するかを選択します。 | カスタマイズオプション | 概要 | 最適なユーザー | | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------ | | リダイレクト URL を生成する | Stripe アカウントなしでフロントエンドでリダイレクト URL を生成します。ソースまたは宛先の推奨金額、宛先通貨、ネットワークをカスタマイズします。 | ブランディングをせずに、部分的なカスタマイズでシンプルなフロントエンドのみの導入を希望する場合。 | | リダイレクト URL でセッションを発行する | Stripe アカウントのバックエンドでリダイレクト URL を使用してセッションをミントします。宛先のウォレットアドレスなど、完全なカスタマイズが可能です。パラメーターの一覧については、[取引パラメーターの事前入力](https://docs.stripe.com/crypto/onramp/stripe-hosted.md#customize-onramp)をご覧ください。 | ブランディングによるオンランプの完全なカスタマイズを希望する場合。 | ### リダイレクト URL を生成する 以下のスクリプトを、script タグを使用して HTML の `` 要素内に含めます。互換性と *PCI 準拠* (Any party involved in processing, transmitting, or storing credit card data must comply with the rules specified in the Payment Card Industry (PCI) Data Security Standards. PCI compliance is a shared responsibility and applies to both Stripe and your business)のため、このスクリプトは常に Stripe のドメイン (「https://js.stripe.com」、「https://crypto-js.stripe.com」) から直接読み込んでください。このスクリプトをバンドルに含めたり、そのコピーを自分でホストしたりしないでください。その場合、警告なしに実装が壊れる可能性があります。 ```html Onramp ``` `Standalone` 関数を使用して、リダイレクト URL を作成し、希望のパラメーターを渡します。 ```js 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 でセッションを発行する 他の実装と同様に、ユーザーがアクセスするたびに[新規オンランプセッションを作成](https://docs.stripe.com/api/crypto/onramp_sessions/create.md)するサーバーエンドポイントを実装する必要があります。オンランプセッションの作成リクエストが `redirect_url` を返します。スタンドアロン型オンランプで全面的にブランド化したカスタムの暗号資産オンランプの URL に、ユーザーをリダイレクトします。 次の curl コマンドを実行して、`redirect_url` 暗号資産オンランプセッションを生成します。 ```bash curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \ -u <>: ``` 次のようなレスポンスを受信します。 ```json { "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 } } ```