Square Terminal 決済ゲートウェイ
レジから Square Terminal に金額を送信し、お客様が端末で支払います。Square が承認すると、販売処理が自動で進みます。このページでは、レジでの決済の受付と、WP Admin での設定を説明します。
Square Terminal には WCPOS Pro 2.0 以降が必要です。
決済を受け付ける
- カートに商品を追加して、チェックアウトを押します。
- 支払いタブで Square Terminal のタイルをタップします。
- 端末の行にある 端末: と端末名を確認します。端末が複数ある場合は、変更を押して、自分のレジの端末をタップします。選択するまでは、パネルに 端末を選択 と表示されます。
- 金額を未払い残高のままにするか、一部だけをカードで支払う場合はそれより少ない金額を入力します。分割払いを参照してください。
- Square Terminal に $45.00 を送信を押します(ボタンには実際の金額が表示されます)。パネルには 端末を起動中…、続いて 端末でのお客様の操作を待っています と表示されます。
- お客様が端末にカードをタッチ、挿入、またはスワイプします。
- Square が承認すると、処理が 承認済み、売上確定済み の順に進みます。これで残高がなくなると販売が完了し、レシートが表示されます。残高がある場合は、同じ方法または別の方法で残りの支払いを受け付けます。
決済中は、パネルに次の内容が表示されます。
- 端末で処理中と送信した金額。
- 端末でのお客様の操作を待っています などのステータス行。
- 支払い方法と端末名。
- 四つのステップ:送信済み、端末で処理中、承認済み、売上確定済み。
- 詳細:Square から報告された各ステップとその時刻、および リーダー、アクション、支払いの ID。コピー(一部のデバイスでは 共有)で、サポート担当者にログを渡せます。
決済ステータスのメッセージと対処方法
- 承認済み、続いて 売上確定済み:支払いを受領しました。残高がなくなるとレシートが表示されます。残高がある場合は、残りの支払いを受け付けます。
- 支払いがキャンセルされました:端末がキャンセルを確認しました。再試行または 別の方法を選択 を押してください。
- タイムアウト — 支払いがキャンセルされました:5 分以内に支払いが行われませんでした。再試行または 別の方法を選択 を押してください。
- キャンセル中 — 端末の確認を待っています:端末がキャンセル要求に応答していません。そのまま待つか、この支払いを解除を押してください。決済を停止するを参照してください。
- 支払いが解除されました:注文を別の方法で支払えるようになりました。ただし、端末ではカードに請求済みの可能性があります。まず端末の画面を確認してください。
決済を停止する
端末でキャンセルを押すと、端末での決済のキャンセルを Square に要求します。パネルに キャンセル中… と表示され、端末が確認すると 支払いがキャンセルされました に変わります。再送信するには 再試行を、タイルの一覧に戻るには 別の方法を選択 を押してください。
端末が確認できない場合(電源が切れている、通信圏外、または動作が止まっている場合)、パネルに キャンセル中 — 端末の確認を待っています と表示されます。この支払いを解除と、注文を別の方法で支払えるようにします。店舗は端末の確認を続けます。 という説明が表示されます。
解除しても、Square 側の決済はキャンセルされません。店舗は約 10 分ごとにバックグラウンドで確認を続けます。別の方法で支払いを受け付ける前に、端末の画面を確認してください。決済が完了している場合は、再度請求しないでください。その後のいずれかの確認時に、店舗がその決済を注文に記録します。問題が発生した場合を参照してください。
この支払いを解除を押すと注文の制限は解除されますが、決済のキャンセルが確認されたわけではありません。パネルに 支払いが解除されました と表示されます。別の方法を選択 を押す前に、端末を確認してください。決済が完了している場合は再度請求せず、注文が更新されるまで待ちます。キャンセル済みの場合は、別の方法を選択 でタイルの一覧に戻り、別の方法で支払いを受け付けます。判別できない場合(端末の電源が切れている、通信できない、何も表示されない場合)は、結果が不明です。別の方法で支払いを受け付けた後、店舗の確認で端末の決済が見つかると、その決済も注文に記録されます。その場合は、注文からどちらか一方を払い戻してください。払い戻しを参照してください。
端末で 5 分以内に支払いが行われないと決済がキャンセルされ、パネルに タイムアウト — 支払いがキャンセルされました と表示されます。
問題が発生した場合
Square Terminal の端末が設定されていません。 この拡張機能とペアリングされた端末がまだありません。WP Admin の管理者にペアリングを依頼してください。
注文 #… が使用中 その端末では別の注文の決済を処理しています。先にその決済を完了またはキャンセルするか、別の端末を選択してください。
支払いに失敗しました と理由が表示されます。再試行または 別の方法を選択 を押してください。詳細で Square からの応答を確認できます。
キャンセル中 — 端末の確認を待っています。 端末がキャンセル要求に応答していません。そのまま待つか、この支払いを解除を押してください。決済を停止するを参照してください。
端末では決済が完了しているのに、レジが待機したままです。 レジは待機中も Square に問い合わせを続け、応答が届くと処理を進めます。Webhook があると、店舗はより早く通知を受け取れます。レジを閉じた場合や支払いを解除した場合など、レジが待機をやめても、店舗が約 10 分ごとに行うバックグラウンド確認で、レジが受け取れなかった決済結果が記録されます。待機中に別の方法で支払いを受け付けず、まず端末の画面を確認してください。
タイルがありません。 POS でこの決済ゲートウェイが有効になっていません。POS で有効にするを参照してください。
WP Admin 管理者向けの設定トラブル対処方法
端末が一覧に表示されない
端末をこの拡張機能とペアリングする必要があります。デバイスコードを作成でコードを生成し、端末に入力してください。Square ダッシュボードや Square アプリでペアリングした端末も、ここでペアリングするまでは表示されません。リーダーを確認の この店舗で Square が認識しているその他のデバイス に表示される場合、その端末は存在しますが、別のアプリケーションに属しています。店舗 ID が端末のログイン先の店舗と一致していることも確認してください。
端末をペアリングできない
コードの有効期間は 5 分です。新しいコードを作成してください。このコードで、ここに設定したアカウントと 店舗 ID にログインするため、端末はオンラインで、Square アプリや他の連携先からログアウトしている必要があります。環境もそのアカウントと一致している必要があります。
設定の検証に失敗する
接続済みの場合は、Square アカウントの行に引き続き Square に接続済み と表示されているか確認してください。独自のアクセストークンを使っている場合は、選択した 環境用のものか確認します。サンドボックス用のトークンは 本番では使えず、その逆も同様です。店舗 ID がそのアカウントに属していることを確認してください。
Square への再接続が必要
Square の認可は自動で更新されます。更新を完了できない場合、拡張機能は認可を終了し、再接続を求めます。Square に再接続を押してください。他の設定を変更する必要はありません。
ログの場所
WooCommerce > Status > ログ で、ソース square-terminal-for-woocommerce を選択します。主なステップは、Square Terminal: で始まる注文メモにも記録されます。
設定する
ここからは店舗の WP Admin 管理者向けの説明です。店舗が各決済を Square に送信し、Square がペアリング済みの端末に送信するため、レジは店舗に接続できる必要があります。次の四つの手順を順番に行ってください。
- 拡張機能ディレクトリから拡張機能をインストールします。
- Square に接続し、店舗を選択します。
- 端末をペアリングするか、サンドボックスで Square のテストデバイスを使用します。
- POS で有効にします。
拡張機能をインストールする
WP Admin > POS > 設定 > 拡張機能 を開き、Square Terminal を見つけて インストール、続いて 有効化をクリックします。拡張機能のインストールを参照してください。
ディレクトリを使わない場合は、GitHub のリリースページから プラグインの zip(ソースコードの zip ではありません)をダウンロードし、プラグイン > Add Plugin、プラグインのアップロードからアップロードします。WCPOS Pro 2.0 がない場合、この拡張機能は動作せず、必要であることを示すメッセージが表示されます。
Square に接続する
WP Admin > WooCommerce > 設定 > 支払いに移動し、Square Terminal を開きます。- Square アカウントで 環境を選択します。試す場合は テストモード(サンドボックス)(初期値)、実際の決済には 本番を選びます。一つの接続で利用できる環境は一つだけなので、接続する 前に選択してください。
- Square に接続をクリックし、Square が求める権限を承認します。
- 店舗 ID を選択します。これは、端末で決済を受け付ける Square の店舗です。
- どの Square デバイスを使用しますか? は Square Terminal のままにします。
公式の WooCommerce Square プラグインをすでに使用している場合、環境と 店舗 ID にはその設定があらかじめ入力されます。保存すると適用されます。二つのプラグイン間で認証情報は共有されないため、ここでも接続が必要です。
独自のアクセストークンを使う場合は、接続操作の代わりに 詳細設定を開き、サンドボックスアクセストークンまたは 本番アクセストークンを貼り付けます。
端末をペアリングする
端末で デバイスコードを作成をクリックし、5 分以内に端末にコードを入力します。その後、リーダーを確認をクリックします。詳しい手順、一覧の表示内容、サンドボックスのテストデバイスについては、ペアリング済み端末とテストデバイスを参照してください。
POS で有効にする
WP Admin > POS > 設定 > 支払い に移動し、Square Terminal を見つけて 有効をオンにします。決済ゲートウェイの有効化を参照してください。
Square Terminal はレジ担当スタッフ専用です。オンラインショップのチェックアウトには表示されません。WooCommerce の 決済一覧にある 有効スイッチは、この拡張機能には影響しません。
ペアリング済み端末とテストデバイス
レジ係が端末を選択するには、事前に この拡張機能とペアリングする必要があります。ペアリング時に Square の デバイスコード が作成されます。このコードによるペアリングが、拡張機能から端末に接続する唯一の方法です。
- 端末で デバイスコードを作成をクリックします。画面に ペアリングコード: … — 5 分以内に端末に入力してください。 と表示されます。
- 端末でデバイスコードによるログイン画面を開き、コードを入力します。端末が Square アプリや他の連携先にログインしている場合は、まずログアウトしてください。他で使用中は、デバイスコードの画面を開けません。
- リーダーを確認をクリックします。端末が このプラグインとペアリング済み — チェックアウトで選択可能 に表示されます。
リーダーを確認では、Square が認識しているデバイスが次の二つのグループに分けて表示されます。
- このプラグインとペアリング済み — チェックアウトで選択可能:レジ係が選択できる端末です。
- この店舗で Square が認識しているその他のデバイス:別のアプリケーションで設定された端末です。新しいコードでペアリングするまでは、ここでは選択できません。
設定を検証では、接続(またはアクセストークン)と店舗が有効かどうかを Square に確認します。有効な場合は、Square の認証情報と店舗を確認しました。 と表示されます。
Square は、デバイスコードでペアリングされた端末だけを一覧に表示します。Square アプリを実行している端末は、デバイスコードを入力するまで表示されません。
テストモード:端末の代わりに Square のテストデバイスを使う
テストモード(サンドボックス) ではデバイスコードはなく、ペアリングも不要です。レジにはペアリング済み端末の代わりに、Square のテストデバイスが表示されます。それぞれ、実機なしで特定の結果を再現できます。
| テストデバイス | 再現する結果 |
|---|---|
| サンドボックス: 成功(請求額 $25 以下) | カード決済が承認されます。金額は $25 以下にしてください。 |
| サンドボックス: 20% のチップ付きで成功 | チップ付きの決済です。ここでは Square のチップを受け付けないため、端末が異なる金額を確定しました という決済エラーになります。 |
| サンドボックス: 購入者が端末でキャンセル | お客様が端末でキャンセルします。 |
| サンドボックス: 即時タイムアウト | 支払いが行われず、決済がすぐにタイムアウトします。 |
| サンドボックス: オフラインの端末(保留のまま) | 応答しない端末です。実機なしで決済の停止を試せます。 |
Webhook
Webhook は 任意です。決済の状態が変わった瞬間に Square から店舗に通知されるため、レジの処理が早く進みます。Webhook がない場合、レジは待機中に Square に結果を問い合わせます。また、店舗が約 10 分ごとに行うバックグラウンド確認で、レジが受け取れなかった結果を記録します。どちらの場合も、Square が支払いそのものを確認したときにだけ、店舗が決済を記録します。Square がチェックアウトを完了としただけでは記録されません。
Webhook を追加する
この手順は、詳細設定で独自のアクセストークンを使って拡張機能を設定した場合にのみ利用できます。Square に接続を使った場合、認可したのは独自のアプリケーションではなく WCPOS アプリケーションなので、サブスクリプションを追加する対象のアプリケーションも、コピーする署名キーもありません。その場合でも、レジからの確認とバックグラウンド確認によって決済は確定します。
独自のアクセストークンを使っている場合は、Square Developer Dashboard で自分のアプリケーションを開きます。
- 設定画面の 端末にある Webhook 行で、コピーをクリックして Webhook URL をコピーします。
- Square Developer Dashboard でアプリケーションを開き、Webhook に移動します。
- その URL を通知 URL として、
terminal.checkout.updatedイベントのサブスクリプションを追加します。 - サブスクリプションの 署名キーを 詳細設定の Webhook 署名キーにコピーして保存します。
署名付き Webhook を受信すると、Webhook 行に …前に検証済み と表示されます。
Square は、指定された通知 URL を使って各 Webhook に署名します。Square に登録した URL が設定画面のものと一文字でも違うと、すべての配信が失敗します。手入力せず、コピーを使ってください。
バージョン 0.x からのアップグレード
バージョン 1.0.0 では、新しい Webhook URL が表示されます。すでにサブスクリプションがある場合は、Square 側の通知 URL を、現在の設定画面に表示されているものに変更してください。編集すれば署名キーは維持されます。Webhook URL の上書きはこの URL を変更しません。拡張機能独自の決済ページにのみ適用されます。サイトの公開アドレスが表示されているものと異なると、Webhook を検証できません。その場合でも、レジからの確認とバックグラウンド確認によって決済は確定します。
Square の Webhook サブスクリプションは Square アプリケーションに属しており、販売者のアクセストークンでは追加できません。そのため、拡張機能が代わりにサブスクリプションを追加することはできません。
Webhook を検証できなくなった場合
Webhook を受信し、現在の設定で検証できるまでは、Webhook 行に まだ検証されていません と表示されます。
決済後も「まだ検証されていません」と表示される
次の点を確認してください。
- Webhook 署名キーが Square 側のサブスクリプションのキーと一致していること。
- Square 側の通知 URL が設定画面のものと完全に一致していること。
- サブスクリプションに
terminal.checkout.updatedが含まれていること。 - インターネットから HTTPS でサイトにアクセスできること。Square のダッシュボードで、各配信の試行を確認できます。
環境、Webhook URL、署名キーを変更すると、次の Webhook を受信するまで行の表示がリセットされます。これは意図した動作です。以前の設定で検証できた Webhook では、新しい設定の有効性は確認できません。
設定リファレンス
WP Admin > WooCommerce > 設定 > 支払い > Square Terminal の設定を、設定手順の順に紹介します。グループを開くと、その設定が表示されます。
Square アカウント
- 環境:テストモード(サンドボックス) (初期値)または 本番。一つの接続で利用できる環境は一つです。
- Square に接続:このサイトを Square で認可します。完了すると、Square に接続済み、加盟店情報、切断が表示されます。
- 店舗 ID:端末で決済を受け付ける Square の店舗です。
- どの Square デバイスを使用しますか?:Square Terminal(このページの対象、初期値)または Square Reader。
端末
- デバイスコードを作成、リーダーを確認、設定を検証:端末のペアリング、Square が認識しているデバイスの一覧表示、設定の確認を行います。ペアリング済み端末とテストデバイスを参照してください。
- Webhook:署名付き Webhook の受信状況と、コピーする URL が表示されます。Webhook を参照してください。
チェックアウトの動作
- レシート画面をスキップ:端末独自のレシート画面を表示せず、待機状態に戻ります。
- 署名を取得:署名に対応した決済では、お客様に端末での署名を求めます。
- チェックアウトのデバッグログ:拡張機能独自の決済ページに、コピー可能なログパネルを表示します。サポート用の機能で、オフのままで問題ありません。
詳細設定
- サンドボックスアクセストークン、本番アクセストークン:上の接続操作を行わない場合にのみ必要です。
- Webhook 署名キー:任意です。店舗が Webhook を検証するために使用します。なくても決済は確定します。
- Webhook URL の上書き:拡張機能独自の決済ページにのみ適用されます。Webhook を参照してください。
設定画面でも、詳細設定は初期状態では閉じています。
端末の代わりに Square Reader を使う
どの Square デバイスを使用しますか? を Square Reader に設定すると、スマートフォンやタブレットにペアリングした Square Reader を使い、Square Point of Sale アプリで決済を受け付けられます。設定画面には、五つの手順からなるチェックリスト Square Reader を設定 が表示されます。
Square Reader を設定する五つの手順
- Square アカウントに接続します。
- 店舗を選択します。
- アプリケーション ID を貼り付けて、店舗を Square に登録します。
- 店舗の戻り先アドレスを Square に登録します。
- スマートフォンまたはタブレットを設定します。
レジでは、レガシータブにある拡張機能独自の決済ページで処理します。Square Point of Sale を開く を押し、Square アプリで決済を完了します。利用できるのは、次の条件を満たす場合のみです。
- テストモードではなく 本番であること。
- Square Point of Sale アプリがインストールされた Android または iOS のスマートフォンやタブレットであること。それ以外ではボタンが無効になり、理由が表示されます。
払い戻し
注文から Square Terminal の決済を払い戻すと、Square を通じてお客様のカードに返金されます。一部払い戻しも可能です。払い戻しを参照してください。
1.0.0 より前のバージョンでの決済など、拡張機能独自の決済ページで受け付けた支払いは、Square ダッシュボードから払い戻してください。
要件
関連ドキュメント
- 決済の受付:カードリーダーを使う
- 支払いパネル
- 決済のキャンセル
- ハードウェアや API については、Square Terminal API ドキュメントを参照してください
- 拡張機能の問題は GitHub で報告してください。アカウントやハードウェアに関するお問い合わせは、Square サポートが対応します。