# 直接小売業の対面決済を受け付ける 対面ビジネスのカード決済を受け付ける方法をご紹介します。 このガイドでは、Stripe 導入を設定して、対面 POS システムで決済を受け付ける方法について説明します。 一般的な対面決済では、[サーバー主導の導入](https://docs.stripe.com/terminal/payments/setup-integration.md?terminal-sdk-platform=server-driven)を使用する [Stripe Reader S700/S710](https://docs.stripe.com/terminal/payments/setup-reader/stripe-reader-s700-s710.md) をお勧めします。このガイドの手順では、このリーダーと導入の組み合わせを使用します。 ## はじめに サーバー主導型の導入では、Stripe API を使用してスマートリーダーと直接通信します。バックエンドサーバーが API コールを行い、決済を作成してリーダーを制御します。 導入するには、以下が必要です。 - Stripe アカウント - Stripe API にリクエストできるバックエンドサーバー - Stripe S700/S710 リーダー - （オプション）テスト用のテストカード ![スマートリーダー実装アーキテクチャー](https://b.stripecdn.com/docs-statics-srv/assets/smart-reader-architecture.9adb3e895895b6513b9188ed74a9315e.png) ## Stripe アカウントを作成する Stripe を導入する前に、Stripe アカウントを作成する必要があります。 1. メールアドレス、氏名、国を入力し、パスワードを作成して[アカウントを作成](https://dashboard.stripe.com/register)します。 1. ビジネスプロフィールを入力します。 1. ダッシュボードで**メールアドレスを確認**をクリックします。Stripe から、アカウントに登録されているメールアドレス宛に確認メールが送信されます。 1. メールアドレスを確認 アカウントを作成したら、Stripeダッシュボードの **開発者** >[API キー](https://dashboard.stripe.com/apikeys)で [API キー](https://docs.stripe.com/keys.md)を取得します。API キーは、バックエンドサーバーからのリクエストを認証するために必要です。 ## リーダーを注文 Stripe ダッシュボードからカードリーダーを注文します。[物理テストカード](https://docs.stripe.com/get-started/use-cases/in-person-payments.md#testing)を注文して導入をテストすることもできます。 1. ダッシュボードで、**Terminal** > [概要](https://dashboard.stripe.com/terminal)に移動します。 1. 「ハードウェアの注文」セクションで、「**購入**」をクリックします。 1. \**I want to build a new deployment using Stripe APIs ** (Stripe API を使用して新しい導入を構築します)を選択し、**Continue** (続行) をクリックします。 1. **Stripe Reader S700** または **Stripe Reader S710** を選択してカートに追加します。 1. カートを選択し、**購入する** をクリックして注文を完了します。 ## リーダーを設定 カードリーダーを受け取ったら、その店舗に登録する必要があります。シリアル番号を使用してリーダーを登録すると、開梱後すぐにリーダーを使用できます。この方法では、リーダーを物理的に登録しなくても、リーダーを再登録してペアリングコードを生成できます。 リーダーを開梱したら、Ethernet (ドックが必要) または WiFi を使用して[リーダーをインターネットに接続](https://docs.stripe.com/terminal/payments/setup-reader/stripe-reader-s700-s710.md#connect-the-reader-to-the-internet)する必要もあります。[接続要件](https://docs.stripe.com/terminal/network-requirements.md#smart-readers)を満たしていることを確認してください。 ### リーダーを登録する シリアル番号を見つけたら、ダッシュボードでリーダーを登録します。 1. ダッシュボードで、[ハードウェア注文](https://dashboard.stripe.com/terminal/hardware_orders)ページに移動し、リーダーを選択してリーダーのシリアル番号を確認します。 1. [リーダー](https://dashboard.stripe.com/terminal/readers)ページで、**リーダーを登録** をクリックします。 1. シリアル番号を入力して、**次へ** をクリックします。複数のデバイスを一度に登録するには、複数のシリアル番号をカンマで区切って入力します。 1. 任意でリーダーの名前を選択します。 1. すでに場所を作成している場合は、リーダーの新しい場所を選択します。まだ作成していない場合は、 **+ 新規追加** をクリックして実際の動作場所を表す[場所](https://docs.stripe.com/terminal/fleet/locations-and-zones.md)を作成します。 1. **登録する** をクリックしてリーダーの登録を完了します。 リーダーを登録したら、サーバー主導型の導入で使用できるようになります。これにより、POS から取引を送信すべきリーダーを特定できます。場所またはリーダーのシリアル ID でフィルタリングして、リーダーを[リストする](https://docs.stripe.com/api/terminal/readers/list.md?api-version=2025-09-30.preview&rds=1)エンドポイントを使用してリーダー ID を取得できます。 ## 決済フローを作成する Stripe Terminal で決済を回収するには、アプリケーションに決済フローを作成する必要があります。Stripe Terminal SDK を使用して、1 つの Checkout セッションを表すオブジェクトである [PaymentIntent](https://docs.stripe.com/api/payment_intents.md?api-version=2025-09-30.preview&rds=1) を作成して更新します。 1. [PaymentIntent を作成](https://docs.stripe.com/terminal/payments/collect-card-payment.md?terminal-sdk-platform=server-driven#create-payment)します。決済を[自動](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-capture_method)キャプチャーするか、[手動](https://docs.stripe.com/payments/place-a-hold-on-a-payment-method.md)キャプチャーするかを定義できます。 ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d currency=usd \ -d "payment_method_types[]=card_present" \ -d capture_method=manual \ -d amount=1000 ``` 1. [決済処理](https://docs.stripe.com/terminal/payments/collect-card-payment.md?terminal-sdk-platform=server-driven#process-payment)します。顧客のクレジットカードのオーソリは、リーダーが決済を処理するときに行われます。 ```curl curl https://api.stripe.com/v1/terminal/readers/tmr_xxx/process_payment_intent \ -u "<>:" \ -d payment_intent=pi_xxx ``` 1. Webhook イベント`terminal.reader.action_succeeded` と `terminal.reader.action_failed` を調べて、[決済が回収され、オーソリされたことを確認](https://docs.stripe.com/webhooks.md)します。 1. (任意) [PaymentIntent をキャプチャー](https://docs.stripe.com/terminal/payments/collect-card-payment.md?terminal-sdk-platform=server-driven#capture-payment)する。 ```curl curl -X POST https://api.stripe.com/v1/payment_intents/pi_xxx/capture \ -u "<>:" ``` ## 実装内容をテストする ## テスト用の法人カード 物理テストクレジットカードを使用して、Stripe Terminal リーダーで Payments をテストします。[Stripe ダッシュボード](https://dashboard.stripe.com/terminal/shop)の Terminal タブからリーダーと物理テストカードを購入できます。[B2](https://b2ps.com/product-category/b2-payment-testing-products/) などのプロバイダーの物理テストカードもサポートしています。 このテスト用の法人カードは、チップ型および非接触型のどちらの決済にも対応しています。Stripe の認証済みリーダーで、[サンドボックス](https://docs.stripe.com/sandboxes.md)の Stripe API に対してのみ機能します。テスト用の法人カードを本番環境で使用しようとすると、Stripe API はエラーを返します。特に記載がない限り、要求された場合は PIN `1234` を使用してください。 テスト用の物理クレジットカードを使用して決済を作成する際は、末尾が以下の値になる金額を使用して特定のレスポンスを生成します。 | 小数 | 結果 | | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **00** | 支払いは承認されます。 | | **01** | 支払いは `call_issuer` コードで拒否されます。 | | **02** | カード保有者向けの画面を備えたリーダーを使用する場合、テストカードを挿入 (または、サポートされている場合はタップ) します。カードに PIN が必要な場合、支払いは `offline_pin_required` で拒否され、リーダーがチップ型に対応していれば PIN の入力が要求されます。`1234` を入力してテスト支払いを完了します。 | | **03** | カード保有者向けの画面を備えたリーダーを使用する場合、テストカードを挿入 (または、サポートされている場合はタップ) します。カードで PIN が求められる場合、支払いは `online_or_offline_pin_required` で拒否され、PIN の入力が要求されます。任意の 4 桁の PIN を入力してテスト支払いを完了します。 | | **05** | 支払いは `generic_decline` コードで拒否されます。 | | **55** | 支払いは `incorrect_pin` コードで拒否されます。 | | **65** | 支払いは `withdrawal_count_limit_exceeded` コードで拒否されます。 | | **75** | 支払いは `pin_try_exceeded` コードで拒否されます。 | たとえば、物理的なテストカードを使用して処理された「25.00 USD」の支払いは成功しますが、「10.05 USD」の支払いは拒否されます。 > 通貨によっては、小数[がゼロ](https://docs.stripe.com/currencies.md#zero-decimal)のものもあります。これらの通貨では、上の表の小数点以下 2 桁を、一番右の 2 桁として使用します。 > > たとえば、支払いが `generic_decline` コードで拒否されるようにするには、_「105 JPY」_の金額が必要です。 ### Interac テストカード (カナダのみ) Interac の導入をテストするには、シミュレーションされた `interac` テストカード、または *「Interac の物理テストカード」* を使用できます。このカードは、ダッシュボードの [Terminal ハードウェアショップ](https://dashboard.stripe.com/terminal/shop)で注文できます。Stripe ブランドの物理テストカードは、Interac クレジットカードとして使用できません。 Interac テストカードは、`interac_present` 支払いと `interac_present` 返金の両方で機能します。`card_present` 支払いをテストする際に使用するのと同じ[テスト金額](https://docs.stripe.com/terminal/references/testing.md#physical-test-cards)を使用できます。特に記載がない限り、要求された場合は PIN `1234` を使用してください。拒否された返金をテストするには、末尾が `01`、`05`、`55`、`65` または `75` の金額で一部返金を作成します。 > Interac テストカードは、非接触型決済に対応していません。 ### eftpos テストカード (オーストラリアのみ) eftpos の導入をテストするには、シミュレーションされた `eftpos` テストカード、または _eftpos の物理テストカード _ を使用できます。このカードは、ダッシュボードの [Terminal ハードウェアショップ](https://dashboard.stripe.com/terminal/shop)で注文できます。Stripe ブランドの物理テストカードは、`eftpos` カードとして使用できません。 `card_present` 支払いをテストする際に使用するのと同じ[テスト金額](https://docs.stripe.com/terminal/references/testing.md#physical-test-cards)を使用できます。特に記載がない限り、要求された場合は PIN `1234` を使用してください。 ## 本番環境へ移行 1. ダッシュボードで、[アカウント設定](https://dashboard.stripe.com/account/onboarding)を開きます。 1. 事業形態、税務情報、ビジネス情報、個人確認情報、顧客向け情報 (明細書表記など) を入力します。 1. 銀行口座の詳細を追加して、入金先を確認します。 1. アカウントを保護するための二段階認証を設定します。 1. オプションで、税金の自動回収や収入ベースの気候変動対策への寄付を追加できます。 1. 入力した情報をレビューし、**同意して送信する** をクリックします。 1. プロファイルを有効にすると、Stripe はサンドボックス環境から本番環境に更新します。 [Stripe アカウントの設定](https://docs.stripe.com/get-started/account/set-up.md)について詳しくはこちらをご覧ください。 実際の決済を受け付ける前に、次の事柄も実行する必要があります。 1. 本番環境で場所を作成します。 1. リーダーを本番環境に作成された場所に再登録します。 ## 次のステップ 導入を設定したら、次の機能を実装することを推奨します。 - 顧客に[紙またはデジタルの領収書を作成](https://docs.stripe.com/terminal/features/receipts.md)します。 - リーダーまたは領収書で[チップを収集](https://docs.stripe.com/terminal/features/collecting-tips/overview.md)します。