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

暗号資産による支払い方法を有効にして、ステーブルコインの受け入れを開始します。

*Payment Links* (A link to a secure, hosted payment page that you can generate without code. Share it directly with your customers, or point them to it with a button or QR code)、*Checkout* (A low-code payment integration that creates a customizable form for collecting payments. You can embed Checkout directly in your website, redirect customers to a Stripe-hosted payment page, or create a customized checkout page with Stripe Elements)、*Elements* (A set of UI components for building a web checkout flow. They adapt to your customer's locale, validate input, and use tokenization, keeping sensitive customer data from touching your server)、または *Payment Intents API* (The Payment Intents API tracks the lifecycle of a customer checkout flow and triggers additional authentication steps when required by regulatory mandates, custom Radar fraud rules, or redirect-based payment methods) を通じて、*ステーブルコイン* (A cryptocurrency pegged to a fiat currency or other asset to limit volatility. Stripe supports OUSD and USDC for stablecoin balances, although transfers on the Tempo network use USDC.e) による決済を受け付けることができる。USDC などのステーブルコインで決済する場合、顧客は **crypto.stripe.com** にリダイレクトされ、暗号資産ウォレットを接続して取引を完了する。資金は USD で Stripe 残高に入金される。

## Before you begin

> ステーブルコインによる支払いは、ニューヨーク州を除くアメリカの全州のビジネスで利用できます。

ステーブルコイン決済の受け付けを開始するには、以下のようにします:

1. [Stripe アカウントを設定](https://dashboard.stripe.com/register)していることを確認してください。
2. ダッシュボードの[決済手段](https://dashboard.stripe.com/settings/payment_methods)の設定に移動し、**ステーブルコインと暗号資産**の決済手段をリクエストします。
3. Stripe はアクセスリクエストを審査し、必要に応じてさらなる詳細のご提供をお願いする場合があります。リクエストが審査されている間、当該決済手段は **保留中** と表示されます。
4. リクエストが承認されると、ダッシュボードで **ステーブルコインおよび暗号資産** という決済手段が有効になります。

## 動的支払い方法での使用 (推奨)

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

## カスタム導入する場合

必要に応じて、支払い導入に暗号資産による支払い方法を手動で追加することができます。

# ダイレクト API


*Payment Intents API* (The Payment Intents API tracks the lifecycle of a customer checkout flow and triggers additional authentication steps when required by regulatory mandates, custom Radar fraud rules, or redirect-based payment methods) を通じて、Pay with Crypto を直接統合します。

## Stripe を設定する [サーバ側]

まず、[Stripe アカウントを作成する](https://dashboard.stripe.com/register)か[サインイン](https://dashboard.stripe.com/login)します。

コーディングエージェント向け: お使いのオペレーティングシステム用のインストールスクリプトで[Stripe CLI をインストール](https://docs.stripe.com/cli/install)します。有効な API キーが付与される匿名の Stripe サンドボックスの作成手順を確認するには、新しいターミナルを開いて `stripe sandbox create --help` を実行します。アカウント登録は不要です。

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

#### Ruby

```bash
# Available as a gem
sudo gem install stripe
```

```ruby
# If you use bundler, you can add this line to your Gemfile
gem 'stripe'
```

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

[PaymentIntent](https://docs.stripe.com/api/payment_intents.md) オブジェクトは、顧客から支払いを回収する意図を表し、決済プロセスのライフサイクルを追跡します。サーバーで PaymentIntent を作成し、回収する金額とサポートされている通貨を指定します。

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=1099 \
  -d currency=usd \
  -d "automatic_payment_methods[enabled]=true"
```

### client secret を取得する

PaymentIntent には、クライアント側が支払いプロセスをセキュアに完了するために使用する *Client Secret* (The client secret is a unique key returned from Stripe as part of a PaymentIntent. This key lets the client access important fields from the PaymentIntent (status, amount, currency) while hiding sensitive ones (metadata, customer)) が含まれています。クライアント側に Client Secret を渡すには、さまざまな方法を使用できます。

#### 1 ページのアプリケーション

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

#### Ruby

```ruby
get '/secret' do
  intent = # ... Create or retrieve the PaymentIntent
  {client_secret: intent.client_secret}.to_json
end
```

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

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

#### サーバ側のレンダリング

サーバーからクライアントに client secret を渡します。この方法は、アプリケーションがブラウザーへの送信前に静的なコンテンツをサーバーで生成する場合に最適です。

決済フォームに [client_secret](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-client_secret) を追加します。サーバー側のコードで、PaymentIntent から client secret を取得します。

#### Ruby

```erb
<form id="payment-form" data-secret="<%= @intent.client_secret %>">
  <button id="submit">Submit</button>
</form>
```

```ruby
get '/checkout' do
  @intent = # ... Fetch or create the PaymentIntent
  erb :checkout
end
```

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

顧客が支払い方法として **仮想通貨** を選択した場合に、[Stripe.js](https://docs.stripe.com/js.md) を使用して Stripe に支払いを送信します。Stripe.js は、支払いフローを構築するための基本的な JavaScript ライブラリです。このライブラリにより、以下で説明するリダイレクトなどの複雑な処理が自動的に行われ、実装を他の支払い方法にも拡張できます。Stripe.js スクリプトは、HTML ファイルの `<head>` に追加して、Checkout ページに含めます。

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

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

```javascript
// 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('<<YOUR_PUBLISHABLE_KEY>>');
```

PaymentIntent の [client secret](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-client_secret) を使用して `stripe.confirmPayment` を呼び出し、Pay with Crypto のリダイレクトを処理します。`return_url` を追加して、決済完了後に顧客をリダイレクトする場所を指定します。

```javascript
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 の[ステータスを確認](https://docs.stripe.com/payments/payment-intents/verifying-status.md#checking-status)して、表示する内容を決定します。ステータス確認のために Stripe がリダイレクトする `return_url` には、次の URL クエリパラメーターが含まれています。また、独自のクエリパラメーターを `return_url` に追加することもできます。設定したパラメーターは、リダイレクトプロセス全体にわたって保持されます。

|  |
|  |
| `payment_intent`               | `PaymentIntent` の一意の ID。                                                                                                            |
| `payment_intent_client_secret` | `PaymentIntent` オブジェクトの [Client Secret](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-client_secret)。 |

## Optional: 支払い後のイベントを処理する

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

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

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

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

- **手動処理:** [Stripe ダッシュボード](https://dashboard.stripe.com/test/payments)を使用して、Stripe Payments の表示、メール領収書の送信、入金処理、失敗した支払いの再試行などを処理します。

- **カスタムコード:** [Webhook](https://docs.stripe.com/events/set-up-events.md#create-event-handler) ハンドラーを構築してイベントを受信し、非同期型のカスタムの決済フローを作成します。Stripe CLI を使用すると、ローカルで Webhook 連携をテストしてデバッグできます。

- **事前構築済みアプリ:** パートナーアプリケーションと連携して、[自動化](https://stripe.partners/?f_category=automation)や[マーケティングセールス](https://stripe.partners/?f_category=marketing-and-sales)などの一般的なビジネスイベントを処理します。

### サポートされている通貨

顧客の国に対応する通貨で暗号資産での支払いを作成できます。暗号資産のデフォルトの現地通貨は USD ですが、顧客は購入金額をこの通貨でも確認できます。

## Optional: リダイレクトを手動で処理する [サーバー側]

リダイレクトを処理するには、`confirmPayment` を指定して Stripe.js を使用することをお勧めします。顧客を手動でリダイレクトする場合の方法を紹介します。

1. 顧客が支払いを完了した後にリダイレクトされる URL を指定します。

```curl
curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/confirm \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "payment_method={{PAYMENT_METHOD_ID}}" \
  --data-urlencode "return_url=https://shop.example.com/crtA6B28E1"
```

1. `PaymentIntent` のステータスが `requires_action` であることを確認します。`next_action` のタイプは `redirect_to_url` になります。

```json
"next_action": {
  "type": "redirect_to_url",
  "redirect_to_url": {
    "url": "https://hooks.stripe.com/...",
    "return_url": "https://example.com/checkout/complete"
  }
}
```

1. `next_action` プロパティで指定された URL に顧客をリダイレクトします。

支払いプロセスを完了した顧客は、`return_url` の指定先に送られます。`payment_intent` と `payment_intent_client_secret` の URL クエリパラメーターが含まれます。上記のように、自社で作成したクエリパラメーターを渡すことができます。

## 実装内容をテストする

テスト API キーを使用して決済リダイレクトページを開き、暗号資産決済統合をテストします。[テストネットアセット](https://docs.stripe.com/payments/accept-stablecoin-payments.md#testnet-assets) を使用して、決済フローの成功を無料でテストできます。

1. *サンドボックス* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes)で、選択した統合方法を使用して新しいトランザクションを作成し、そのリダイレクト URL を開きます。
2. 任意のウォレットと決済ネットワークを接続します。
3. 決済を完了し、想定する URL にリダイレクトされることを確認します。

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

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

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

1. Web ブラウザ用の [MetaMask 拡張機能をダウンロード](https://metamask.io/download) します。
2. [新しいウォレットを作成](https://support.metamask.io/start/creating-a-new-wallet/) するか、[既存のウォレットをインポート](https://support.metamask.io/start/use-an-existing-wallet/) します。

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

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

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

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

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

返金をテストする際、ウォレットに送信されるトークンの契約が、決済に使用されるものとは異なることがあります。ブロックエクスプローラーで返金したトークンの [transaction_hash](https://docs.stripe.com/api/refunds/object.md?rds=1#refund_object-destination_details-crypto-reference) を確認し、そのトークンの契約をウォレットに追加することをお勧めします。たとえば、Sepolia ETH USDC 返金の `0x58277ebcabbe2a6694fbca8daf9e23163dbacf3e` トークンの契約アドレスを確認できます。

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

> 一部のテストネットのフォーセットを使用するには、少量のメインネットトークンを保有する必要がある場合があります。

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

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

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

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

### その他のテストネット Faucet

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

- [Paxos USDP](https://faucet.paxos.com/)
- [Devnet SOL](https://faucet.solana.com/)
- [Sepolia ETH](https://faucets.chain.link/sepolia)
- [Amoy POL](https://faucet.polygon.technology/)


## Optional: 税額計算

Stripe Tax では、顧客がカードで支払うかステーブルコインで支払うかに関わらず、実装から得られた金額、通貨、商品詳細、顧客の所在地が使用されます。ステーブルコイントークンは決済手段であり、個別の Stripe Tax の設定は不要です。

Checkout および Checkout セッションによる実装では、Checkout セッションの作成時に `automatic_tax[enabled]=true` を設定します。

```curl
curl https://api.stripe.com/v1/checkout/sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d mode=payment \
  -d "line_items[0][price_data][currency]=usd" \
  -d "line_items[0][price_data][product_data][name]=T-shirt" \
  -d "line_items[0][price_data][unit_amount]=2000" \
  -d "line_items[0][quantity]=1" \
  -d "automatic_tax[enabled]=true" \
  --data-urlencode "success_url=https://example.com/success"
```

税額は、取引通貨でのセッション金額をもとに Checkout で計算されます。顧客の住所は、[ドキュメントに記載された住所の優先順位](https://docs.stripe.com/tax/checkout/page.md#create-session)に従って再利用または収集されます。有形商品を取り扱う場合は、配送先住所を収集します。ユースケース上、Checkout で常に請求先住所を収集する必要がある場合にのみ、`billing_address_collection=required` を設定します。完全な設定については、[Checkout で税金を徴収](https://docs.stripe.com/tax/checkout/page.md)をご覧ください。

Payment Intents API を使用する Elements、ダイレクト API、モバイルでの実装については、[PaymentIntents を使用した Stripe Tax](https://docs.stripe.com/tax/payment-intent.md) をご覧ください。

## See also

- [ステーブルコインのサブスク](https://docs.stripe.com/billing/subscriptions/stablecoins.md)
- [Checkout で税を回収](https://docs.stripe.com/tax/checkout/page.md)
