地域的な考慮事項

カナダで Terminal を導入する

Stripe はカナダで、Visa、Mastercard、アメリカン・エキスプレス、ディスカバー、および Interac による支払いに対応しています。取引はすべて、カナダドル (CAD) で行う必要があります。カナダで Terminal での決済を受け付けるには、プラットフォームアカウントまたは連結アカウントのいずれかがカナダにある必要があります。

場所を使用する

カナダの所在地でビジネスの Location (場所) を作成し、その場所にリーダーを関連付けます。このようにすることで、カナダで適切に支払いを処理するために必要な設定が自動的にダウンロードされます。

カナダ の有効な Location の住所には、line1, city, state, postal_code, and country プロパティを含める必要があります。

curl https://api.stripe.com/v1/terminal/locations \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "display_name"="HQ" \
  -d "address[line1]"="3040 Bur Oak Ave" \
  -d "address[city]"="Markham" \
  -d "address[state]"="ON" \
  -d "address[country]"="CA" \
  -d "address[postal_code]"="L6B 0R1" \

リーダーソフトウェアのバージョン

カナダで使用する Verifone P400 リーダーの場合、リーダーソフトウェアバージョン 3.0.1.15 以降を使用する必要があります。詳細については、Verifone P400 ソフトウェアの更新をご覧ください。

同様に、BBPOS WisePad 3 リーダーは、リーダーソフトウェアバージョン 4.01.00.41_Prod_NA_off_v23_480001 以降を使用している必要があります。詳細については、BBPOS WisePad 3 ソフトウェアの更新をご覧ください。

翻訳

言語に関する規制により、POS サービスなどのサービスは、カード保有者とカード発行会社が英語の使用に同意した場合を除き、Frenchでサービスを提供する必要があります。規制がお客様のビジネスに該当する場合、Terminal は要件に準拠できるようにサポートします。

リーダーのデフォルトの言語

Verifone P400 インターフェイスは、カナダ 内の所在地に登録されている場合、英語の他にFrenchでテキストを表示します。

BBPOS WisePOS EおよびStripeリーダーS700は、Settings (設定) パネルでリーダーの言語を変更できます。画面を右にスワイプして Settings (設定) パネルにアクセスし、言語を選択します。

BBPOS WisePad 3 は、リーダーインターフェイスで直接リーダーの言語を変更できます。リーダーを、カナダ 内の所在地で Location (場所) に登録すると、リーダーは、その地域に対応する言語パックがインストールされていなければ、そのパックをインストールします。使用できる言語オプションを表示して言語を選択するには、Power / Settings (電源 / 設定) ボタンをクリックし、矢印キーを使用して下にスクロールして言語選択メニューに移動します。希望の言語をハイライトし、緑の Enter キーを押します。

取引言語

カード保有者がカードを提示すると、リーダーはカード保有者の優先言語を判定します。その時点以降の画面は、カード保有者の言語設定に基づいて翻訳されます。

その他の翻訳

Frenchでサービスを提供する必要がある場合、またはテキストを英語に加えてこの言語に翻訳する必要がある場合は、カスタムのリーダー画面と領収書の両方に適切な翻訳が表示されるようにします。

Interac 支払い

Interac is the interbank network that handles routing of debit payments in Canada. Consumer debit cards in Canada are branded with an Interac logo and might also be co-branded with another payment network’s logo. Even if the card is co-branded, however, all Interac debit transactions must be routed through Interac. To maximize card acceptance, you should build Interac support into your integration.

PaymentIntent を作成する

Interac 取引を受け付けるには、interac_present の支払い方法タイプを使用して決済を作成する必要があります。Visa、Mastercard、アメリカン・エキスプレスによる決済を受け付ける場合は、card_present の支払い方法タイプも含めます。

クライアント側

Create a PaymentIntent from your client using one of the following options:

サーバー側

The JavaScript SDK and the server-driven integration require you to create the PaymentIntent on your server. For the other client SDKs, you can create the PaymentIntent on your server if the information required to start a payment isn’t readily available in your app.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=999 \
  -d currency=cad \
  -d "payment_method_types[]"=card_present \
  -d "payment_method_types[]"=interac_present \
  -d capture_method=manual

支払いを回収して処理する

支払いを処理すると、リーダーは提示されたカードのプロフィールに基づき、Interac ネットワーク全体で支払いの経路を選定するかどうかを判断します。

Interac カードが提携ブランドのものである場合には、PaymentIntent の返された charge の payment_method_details.interac_present.brand フィールドに、提携ブランドが示されます。Interac 取引の payment_method の type フィールドは、常に interac_present です。

さらにいくつかの Interac の要件に、Stripe が自動的に対処します。追加の組み込み作業を行う必要はありません。

• カードが提示されるまで、画面上の指示はリーダーのデフォルト言語で表示されます。カード情報の収集後は、提示されたカードの設定言語に従ってローカライズされます。
• リーダーは必要に応じて自動的に PIN を要求します。
• Interac Flash (非接触型) 支払いは、250 CAD までに制限され、通常 3 回まで続けて実行できます。250 CAD を超える取引や、連続 4 回目以降の非接触型取引では、顧客は Interac カードを差し込み、PIN を入力する必要があります。

キャプチャーと照合

Unlike Visa, Mastercard, and American Express transactions, Interac transactions are authorized and automatically captured in a single step. Make sure that your application doesn’t continue to capture the PaymentIntent. If you attempt to capture an interac_present payment, the Stripe API returns an error. Make sure that you prevent unintended and duplicate payments in your integration; if failures or declines occur while processing Interac, you can attempt to re-use the same PaymentIntent from the original transaction to safeguard against double-charging.

Interac 支払いを返金する

カナダの Interac 取引では、対面での返金が必須とされます。このタイプの支払いには、API やダッシュボードで返金を作成することはできません。このフローでは、リーダーがカード保有者に対し、元の支払いに使用されたカードを提示するように求めます。カード詳細が読み込まれると、お客様のアプリケーションで返金を処理できるようになります。オンラインでの返金と同様に、元の取引額よりも少ない金額を渡して一部返金を行うこともできます。

返金処理に使用される通貨とカードは、元の支払いのものと一致する必要があります。異なる場合、リクエストがエラーになって失敗します。

フォールバックとして、ストアクレジットや現金など、さまざまな支払い方法での返金機能を提供できます。

curl https://api.stripe.com/v1/terminal/readers/tmr_xxx/refund_payment \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d payment_intent=pi_xxx \
  -d amount=2000

{
  "id": "tmr_xxx",
  "object": "terminal.reader",
  "action": {
    "type": "refund_payment",
    "refund_payment": {
      "payment_intent": "pi_xxx"
    },
    "status": "in_progress",
    "failure_code": null,
    "failure_message": null
  },
  …
}

curl https://api.stripe.com/v1/test_helpers/terminal/readers/tmr_xxx/present_payment_method \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d type=interac_present