# Checkout で Link を使用する

Stripe の構築済みの決済ページで Link を使用します。

Linkを [Payment Links](https://docs.stripe.com/payment-links.md) で使用することもできます。

Checkout は[構築済みの決済フォーム](https://docs.stripe.com/payments/checkout.md)であり、自社のサイトに埋め込むことも、Stripe がホストする決済画面として使用することもできます。Link を Checkout と組み合わせて使用すると、顧客は決済情報を安全に保存して再利用できるようになります。すでに Link を利用しているログイン顧客の場合、別のビジネスの決済画面で最初に保存した情報であっても、自動的に入力されます。

Checkout は追加料金なしで Link に対応しており、他のカード決済と同じ [pricing](https://stripe.com/pricing) が適用されます。決済連携が Link に与える影響については、[Link in different payment integrations](https://docs.stripe.com/payments/link/link-payment-integrations.md) をご覧ください。
![Add Link to your prebuilt checkout page](https://b.stripecdn.com/docs-statics-srv/assets/link-in-checkout.2eb9f8d06da3dca74af9b81fa7524049.png)

構築済みの Checkout ページに Link を追加する

## Before you begin

Checkout を使用して[決済を受け付け](https://docs.stripe.com/payments/accept-a-payment.md?integration=checkout)られるようにシステムを構築します。

## Enable Link in Checkout

顧客が [Link アプリ](https://link.com/)に格納した情報を使用して、Linkで決済を受け付けます。決済で Link を使用した顧客から決済を受け取ると、決済に対する `payment_method.type` は `link` になります。[Checkout 導入](https://docs.stripe.com/payments/accept-a-payment.md?integration=checkout)に Link を追加するには、決済手段タイプとして `link` を指定して決済セッションを作成します。

#### 動的な支払い方法を使用する

[動的な決済手段法](https://docs.stripe.com/payments/payment-methods/dynamic-payment-methods.md)を利用して、最も関連性の高い決済手段を顧客に表示することで、購入完了率を向上できます。[Setup Intent で今後の使用のために](https://docs.stripe.com/payments/save-and-reuse.md)カード詳細を収集している場合は、動的な決済手段を使用するのではなく、手動で決済手段を一覧表示します。

決済手段としてLinkを追加するには:

1. [決済手段の設定](https://dashboard.stripe.com/settings/payment_methods)からLink決済手段を有効にします。
1. 決済手段を手動で一覧表示する既存のシステムがある場合は、構築済みのシステムから [payment_method_types](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-payment_method_types) パラメーターを削除します。
![Preview of Link enabled as payment method in the Stripe Dashboard](https://b.stripecdn.com/docs-statics-srv/assets/enable-link-stripe-dashboard.1bd2411da48c323997c27a6dabee9b4c.png)

Stripe ダッシュボードで決済手段として Link が有効になっている状態

システムから `payment_method_types` パラメーターを削除すると、カードやウォレットなどの一部の支払い方法は自動的に有効になります。currency パラメーターにより、購入セッションの際に顧客に提示する支払い方法が制限されます。

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

#### 支払い方法を手動でリストアップする

新しい [Checkout セッション](https://docs.stripe.com/api/checkout/sessions.md)を作成する際は、以下を行う必要があります。

1. `link` を `payment_method_types` のリストに追加します。
1. `card` も `payment_method_types` のリストに含まれていることを確認します。
1. すべての `line_items` が同じ通貨を使用していることを確認します。

#### Ruby

```ruby
client.v1.checkout.sessions.create({
  mode: 'payment',payment_method_types: ['card', 'link'],
  line_items: [{
    price_data: {
      currency: 'usd',
      product_data: {
        name: 'T-shirt',
      },
      unit_amount: 2000,
    },
    quantity: 1,
  }],
  success_url: 'https://example.com/success',
})
```

## 実装をテストする

> *サンドボックス* (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)Linkアカウントには実際のユーザーデータを保存しないでください。これらのテストアカウントは公開可能キーに関連付けられているため、公開可能なものとして扱ってください。

現在、Link はカード、および資格を満たしたアメリカの銀行口座からの購入にのみ対応しています。Link では、[ドメインの登録](https://docs.stripe.com/payments/payment-methods/pmd-registration.md)が必要です。

有効な任意のメールアドレスを使用して、Link のサンドボックスアカウントを作成できます。以下の表には、Stripe のサンドボックスアカウントの認証に使用できる、固定値のワンタイムパスコードが示されています。

| 値                     | 結果                   |
| --------------------- | -------------------- |
| 以下に記載されていない任意の 6 桁の数字 | 成功                   |
| 000001                | エラー: コードが無効です        |
| 000002                | エラー: コードの有効期限が切れています |
| 000003                | エラー: 最大試行回数を超えました    |

### 複数の資金供給元

対応する資金供給元を Stripe が追加した場合でも、貴社で構築済みのシステムを更新する必要はありません。Stripe が自動的に対応し、カード決済や銀行口座決済の場合と同じ売上処理時間と保証が適用されます。

## Connect プラットフォームの Link

Connect プラットフォームの導入を介して Checkout を使用する連結アカウントは、自動的に Link を利用できるようになります。

- Connect プラットフォームの場合は、ダッシュボードの [Link の設定](https://dashboard.stripe.com/settings/link)で、プラットフォームアカウントの Link を管理できます。連結アカウントはそれぞれのダッシュボードの設定で Link を管理します。
- Connect プラットフォームを介して決済を処理している連結アカウントの場合は、ダッシュボードの Link の設定で、プラットフォームを介して処理された決済と、プラットフォームを使用せずに処理された決済の両方の Link を管理できます。

## Link を無効にする

Link は、Stripe ダッシュボードの[決済手段設定](https://dashboard.stripe.com/settings/payment_methods)で無効にできます。Linkの設定は、[決済手段設定](https://docs.stripe.com/payments/payment-method-configurations.md)ごとに個別に変更する必要があります。

決済手段の設定に対して Link を無効にした後、変更が Web サイトに反映されるまでに数分かかる場合があります。

## See also

- [Stripe Checkout](https://docs.stripe.com/payments/checkout.md)
- [Checkout の仕組み](https://docs.stripe.com/payments/checkout/how-checkout-works.md)
- [クイックスタート](https://docs.stripe.com/checkout/quickstart.md)