コンテンツにスキップ
アカウントを作成またはサインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン
概要構築済みのシステムをアップグレード
オンライン決済
概要ユースケースを見つけるManaged Payments を使用する
決済手段
決済インターフェイス
決済シナリオ
対面決済
決済以外の機能

注

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

ステーブルコイン決済の受け付け

仮想通貨支払い方法を有効にして、ステーブルコインの受け入れを開始します。

stablecoin による決済は、Payment Links、Checkout、Elements、または Payment Intents API で受け付けることができます。USDC などのステーブルコインで支払う場合、顧客は crypto.stripe.com にリダイレクトされ、仮想通貨ウォレットを接続して取引を完了します。資金は Stripe の残高として USD で処理されます。

はじめに

地域的な考慮事項
アメリカ

顧客は世界中でステーブルコインを支払いに利用できますが、現在、ステーブルコインの決済を受け付けることができるのはアメリカ企業のみです。

To start accepting stablecoin payments, activate the Crypto payment method:

  1. Stripe アカウントがアクティブ になっていることをご確認ください。
  2. 設定 > 支払い >支払い方法 にアクセスし、仮想通貨 支払い方法をリクエストしてください。
  3. Stripe reviews your access request, and might contact you for more details if necessary. In this case, the payment method appears as Pending while we review your request.
  4. After you’re approved, Crypto becomes active in the Dashboard.

動的支払い方法での使用 Recommended

Stripe のデフォルト動的支払い方法 を Payment Links、Hosted Checkout、Embedded Checkout Forms、または Elements でご利用の場合、これ以上のアップデートは必要ありません。Stripe は、対象となる顧客にステーブルコインの支払いオプションを自動的に表示します。

カスタム導入する場合

必要に応じて、支払い導入に仮想通貨支払い方法を手動で追加することができます。

Payment Intents API を通じて、仮想通貨での支払いを直接導入します。

Stripe を設定する
サーバ側

まず、Stripe アカウントを作成するかサインインします。

アプリケーションから Stripe API にアクセスするには、Stripe の公式ライブラリを使用します。

Command Line
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
# Available as a gem
sudo gem install stripe
Gemfile
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

PaymentIntent を作成し、client secret を取得する
サーバー側

PaymentIntent オブジェクトは、顧客から支払いを徴収する意図を表し、支払いプロセスのライフサイクルを追跡します。サーバーにPaymentIntentを作成し、徴収する金額と対応する通貨を指定します。既存の PaymentIntent を導入している場合は、payment_method_types のリストにcrypto を追加します。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=usd \
  -d "payment_method_types[]"=crypto

client secret を取得する

PaymentIntent には、client secret が含まれています。これは、支払いプロセスを安全に完了するためにクライアント側で使用されます。client secret をクライアント側に渡す際は、いくつかの方法を使用できます。

ブラウザーの fetch 関数を使用して、サーバーのエンドポイントから client secret を取得します。この方法は、クライアント側が 1 ページのアプリケーションで、特に React などの最新のフロントエンドフレームワークで構築されている場合に最適です。client secret を処理するサーバーのエンドポイントを作成します。

main.rb
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
get '/secret' do
  intent = # ... Create or retrieve the PaymentIntent
  {client_secret: intent.client_secret}.to_json
end

その後、クライアント側で JavaScript を使用して client secret を取得します。

(async () => {
  const response = await fetch('/secret');
  const {client_secret: clientSecret} = await response.json();
  // Render the form using the clientSecret
})();

ステーブルコインの支払いページへのリダイレクト

顧客が仮想通貨を決済手段として選択したときに、Stripe.js を使用して Stripe に支払いを送信します。Stripe.js は、決済フローの構築の基盤となる JavaScript ライブラリです。以下に説明するリダイレクトのような複雑な処理を自動的に行い、他の決済手段にもシステムを拡張させることができます。Stripe.js スクリプトを決済ページに含めるには、スクリプトを HTML ファイルの <head> に追加します。

<head>
  <title>Checkout</title>
  <script src="https://js.stripe.com/clover/stripe.js"></script>
</head>

決済ページで次の JavaScript を使用して Stripe.js のインスタンスを作成します。

// Set your publishable key. Remember to change this to your live publishable key in production!
// See your keys here: https://dashboard.stripe.com/apikeys
const stripe = Stripe(
'pk_test_TYooMQauvdEDq54NiTphI7jx'
);

PaymentIntent の client secret を使用して stripe.confirmPayment を呼び出し、Pay with Crypto のリダイレクトを処理します。return_url を追加して、決済完了後に顧客をリダイレクトする場所を指定します。

const form = document.getElementById('payment-form');

form.addEventListener('submit', async function(event) {
  event.preventDefault();

  // Set the clientSecret of the PaymentIntent
  const { error } = await stripe.confirmPayment({
    clientSecret: clientSecret,
    confirmParams: {
      payment_method_data: {
        type: 'crypto',
      },
      // Return URL where the customer should be redirected after the authorization
      return_url: `${window.location.href}`,
    },
  });

  if (error) {
    // Inform the customer that there was an error.
    const errorElement = document.getElementById('error-message');
    errorElement.textContent = result.error.message;
  }
});

return_url は、支払いの結果を表示する、お客様のウェブサイトのページに相当します。PaymentIntent のステータスを確認して、表示する内容を決定します。ステータス確認のために Stripe がリダイレクトする return_url には、次の URL クエリパラメーターが含まれています。また、独自のクエリパラメーターを return_url に追加することもできます。設定したパラメーターは、リダイレクトプロセス全体にわたって保持されます。

payment_intentPaymentIntent の一意の ID。
payment_intent_client_secretPaymentIntent オブジェクトの Client Secret。

オプション支払い後のイベントを処理する

支払いが完了すると、Stripe は payment_intent.succeeded イベントを送信します。ダッシュボード、カスタム Webhook、またはパートナーソリューションを使用して、これらのイベントを受信し、顧客への注文確認メールの送信、データベースへの販売の記録、配送ワークフローの開始などのアクションを実行します。

クライアントからのコールバックを待たずにこれらのイベントをリッスンします。クライアント側では、コールバックが実行される前に顧客がブラウザーのウィンドウを閉じたり、アプリを終了したりする可能性があるだけでなく、不正なクライアントによってレスポンスが操作される可能性もあります。非同期イベントをリッスンするようにシステムを設定すると、今後より多くの決済手段を受け付けられるようになります。サポートされている決済手段のそれぞれの違いについては、決済手段ガイドをご確認ください。

イベントを受信し、ビジネスアクションを実行する

ビジネスアクションを受信して実行するためのオプションとして、以下をご利用いただけます。

  • 手動処理: Stripe ダッシュボードを使用して、Stripe Payments の表示、メール領収書の送信、入金処理、失敗した支払いの再試行などを処理します。
  • カスタムコード: Webhook ハンドラを構築してイベントをリッスンし、カスタムの非同期決済フローを構築します。Stripe CLI を使用して、ローカルで Webhook の実装をテストまたはデバッグすることも可能です。
  • 事前構築済みアプリ: パートナーアプリケーションと連携して、自動化やマーケティングセールスなどの一般的なビジネスイベントを処理します。

サポートされている通貨

仮想通貨での支払いは、お住まいの国に対応する通貨で作成できます。仮想通貨のデフォルトの現地通貨は USD であり、顧客もこの通貨単位で購入金額を確認できます。

実装内容をテストする

テスト API キーを使用して決済リダイレクトページを開き、暗号資産決済統合をテストします。テストネットアセット を使用して、決済フローの成功を無料でテストできます。

  1. サンドボックスで、選択した統合方法を使用して新しいトランザクションを作成し、そのリダイレクト URL を開きます。
  2. 任意のウォレットと決済ネットワークを接続します。
  3. 決済を完了し、想定する URL にリダイレクトされることを確認します。

テストネットアセットで決済をテストする

ほとんどの暗号資産は、ブロックチェーントランザクションのテストに使用できるテストネットアセット (金銭的価値のないトークン) を提供しています。Stripe は、テストに MetaMask ウォレット、Polygon Amoy テストネット、Circle Faucet を推奨していますが、独自のサービスを使用することもできます。

ウォレットをインストールする

  1. Web ブラウザ用の MetaMask 拡張機能をダウンロード します。
  2. 新しいウォレットを作成 するか、既存のウォレットをインポート します。

テストネットを有効にする

  1. MetaMask ウォレットで、メインメニューからネットワークを選択します。
  2. カスタムネットワークを追加をクリックします。
  3. 次の詳細を入力します。
    • ネットワーク名: Polygon Amoy
    • デフォルトの RPC URL: https://rpc-amoy.polygon.technology/
    • チェーン ID: 80002
    • 通貨シンボル: POL
    • ブロックエクスプローラーの URL: https://amoy.polygonscan.com/
  4. 保存 をクリックします。

トークンをインポートする

  1. MetaMask ウォレットのトークンで、ネットワークドロップダウンからPolygon Amoy を選択します。
  2. オーバーフローメニュー () をクリックし、トークンのインポートを選択します。
  3. ネットワークを選択 > Polygon Amoy をクリックします。
  4. トークンコントラクトアドレスに、Polygon Amoy のテストネットコントラクトアドレスを貼り付けます。
    0x41E94Eb019C0762f9Bfcf9Fb1E58725BfB0e7582
    トークンシンボルフィールドは USDC で自動的に更新され、小数点以下桁数フィールドは 6 で更新されます。
  5. 次へ をクリックします。
  6. USDC トークンをインポートしていることを確認し、インポートをクリックします。

MetaMask ウォレットのトークンリストに Polygon Amoy と USDC が表示されるようになりました。

テストネットアセットを取得する

  1. faucet.circle.com を開きます
  2. USDC をクリックします。
  3. ネットワークで、Polygon PoS Amoy を選択します。
  4. 送信先にウォレットアドレスを貼り付けます。
  5. 10 USDC を送金をクリックします。

決済を行うための USDC に加えて、トランザクションコストを支払うための POL が必要です。

  1. faucet.polygon.technology を開きます。
  2. チェーンとトークンの選択で、Polygon Amoy と POL を選択します。
  3. 本人確認で、認証に使用するサードパーティプラットフォームをクリックし、ログインプロセスを完了します。
  4. ウォレットアドレスの入力に、ウォレットアドレスを貼り付けます。
  5. Claim をクリックします。

テストネットトランザクションの完了には数分かかる場合があります。ウォレットを確認して、USDC と POL が送金されたことを確認してください。

その他のテストネット Faucet

より多くのテストトークンオプションについては、次の Faucet サービスを確認してください。

このページはお役に立ちましたか。
はいいいえ
関連ガイド
ステーブルコインのサブスクリプション