コンテンツにスキップ
アカウントを作成またはサインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン

注

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

Accept payments in-person for a direct retail business

Learn how to accept card payments for your in-person business.

This guide describes how to set up your Stripe integration to accept payments with an in-person Point of Sale (POS) system.

For general in-person payments, we recommend Stripe Reader S700 using a server-driven integration. The steps in this guide use this reader and integration combination.

Create a Stripe account

Before integrating with Stripe, you must create a Stripe account.

  1. Create an account by entering your email address, full name, country, and creating a password.
  2. Fill out your business profile.
  3. In the Dashboard, click Verify your email. A verification email is sent to your email address.
  4. Verify your email address.

Order your reader

Order a card reader from the Stripe Dashboard. You can also order a physical test card to test your integration.

  1. In the Dashboard, go to Terminal > Overview.
  2. In the Hardware section, click Shop.
  3. Select I want to build a new integration using Stripe APIs and click Continue.
  4. Select Stripe Reader S700 (wi-fi only) and add it to your cart.
  5. Select your cart, then click Check out to complete your order.

Set up your reader

After you receive your card reader, you need to register it to a location. Registering a reader using its serial number lets you use the reader immediately after you unbox it. This method also allows you to re-register the reader without the need to physically have the reader to generate a pairing code.

Register your reader

After you find the serial number, register the reader in the Dashboard.

  1. In the Dashboard, go to the Hardware orders page and select your reader to find the reader’s serial number.
  2. On the Readers page, click Register reader.
  3. Enter the serial number and click Next. To register multiple devices at one time, you can enter multiple serial numbers, separated by commas.
  4. Optionally, choose a name for the reader.
  5. If you already created a location, select the reader’s new location. Otherwise, create a location by clicking + Add new.
  6. Click Register to finish registering your reader.

After you register your reader, it’s ready to use with the server-driven integration. We recommend storing the reader ID (tmr_xxx) within your application so you know which reader to send transactions from your point of sale. You can retrieve reader IDs using the list readers endpoint.

Create the payment flow

Collecting payments with Stripe Terminal requires you to create a payment flow in your application. Use the Stripe Terminal SDK to create and update a PaymentIntent, an object representing a single payment session.

  1. Create a PaymentIntent. You can define whether to automatically or manually capture your payments.
  2. Process the payment. Authorization on the customer’s card takes place when the reader processes the payment.
  3. (Optional) Capture the PaymentIntent.

Test your integration

テスト用の法人カード

物理テストクレジットカードを使用して、Stripe Terminal リーダーで Payments をテストします。Stripe ダッシュボードの Terminal タブからリーダーと物理テストカードを購入できます。B2 などのプロバイダーの物理テストカードもサポートしています。

This physical test card supports both chip entry and contactless payments. It only works with Stripe’s pre-certified readers, and only against the Stripe API in a sandbox. If you attempt to use your physical test card in live mode, the Stripe API returns an error. Unless stated otherwise, use the PIN 1234 when prompted.

When creating payments using a physical test card, use amounts ending in the following decimal values to produce specific responses:

小数結果
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」の支払いは拒否されます。

Interac テストカード カナダのみ

To test your Interac integration, you can use the simulated interac test card or an Interac physical test card. You can order it from the Terminal hardware shop in the Dashboard. You can’t use the Stripe-branded physical test card as an Interac card.

Interac テストカードは、interac_present 支払いと interac_present 返金の両方で機能します。card_present 支払いをテストする際に使用するのと同じテスト金額を使用できます。特に記載がない限り、要求された場合は PIN 1234 を使用してください。拒否された返金をテストするには、末尾が 01、05、55、65 または 75 の金額で一部返金を作成します。

注

Interac テストカードは、非接触型決済に対応していません。

eftpos テストカード オーストラリアのみ

eftpos の実装をテストするには、シミュレーションされた eftpos テストカードまたは「eftpos の物理的なテストカード」を使用できます。ダッシュボードの Terminal ハードウェアショップで注文できます。Stripe ブランドの物理的なテストカードを eftpos カードとして使用することはできません。

card_present 支払いをテストする際に使用するのと同じテスト金額を使用できます。特に記載がない限り、要求された場合は PIN 1234 を使用してください。

Go live

  1. In the Dashboard, open your Account settings.
  2. Enter your business type, tax details, business details, personal verification information, and customer-facing information (for example, a statement descriptor).
  3. Add bank details to confirm where your money will be paid out.
  4. Set up two-step authentication to secure your account.
  5. You can optionally add automatic tax collection or revenue-based climate donations.
  6. Review the information you entered, and click Agree and submit.
  7. After you activate your profile, Stripe updates you from sandbox mode to live mode.

Learn more about activating your Stripe account.

Next steps

After setting up your integration, we recommend you implement the following features:

このページはお役に立ちましたか。
はいいいえ