PayPal Reader (Zettle)決済ゲートウェイ
レジからPayPal Readerに注文の合計金額が送信され、お客様がリーダーにカードをかざすか挿入します。リーダーから決済完了が通知されると、販売処理は自動で完了します。このページでは、レジでの決済の受け付けと、WP Adminでの設定を説明します。
PayPal Reader拡張機能を拡張機能ディレクトリからインストールする場合も、レジで使用する場合も、WCPOS Proが必要です。
決済を受け付ける
- レジと店舗のサイトがオンラインであることを確認してください。決済は、POS内に表示される店舗のサイトの支払いページで行われます。
- WP Adminにアクセスできる担当者が、ゲートウェイの設定とリーダーのペアリングを済ませている必要があります。
- 店舗でレジの開閉を使用している場合は、レジを開いてください。レジが閉じている間は決済を記録できません。レジを参照してください。
-
カートに商品を追加し、チェックアウトを押します。
-
レガシータブを開きます。POS内に店舗のサイトの支払いページが表示されます。レガシータブを参照してください。
-
PayPal Readerを選択します。店舗によっては別の名前が設定されている場合があります。パネルにはリーダーを読み込み中…と表示され、続いてモード:テスト。決済を開始できます。 と表示されます(本番運用に切り替えた後はモード:本番。 と表示されます)。
-
リーダーを選択します。ペアリング済みのリーダーはそれぞれ、フロントカウンター(準備完了) のように名前付きのボタンで表示され、最初のリーダーが選択済みになっています。別のリーダーを使用する場合は、そのボタンをタップします。
警告パネル上部のテストモードは表示上のラベルにすぎません。リーダーでは実際の請求が発生する可能性があります。テストモードと本番運用への切り替えを参照してください。
-
リーダー決済を開始を押します。パネルにリーダーに接続中…、続いてリーダーの準備ができました。決済を要求中… と表示され、注文の合計金額全額がそのリーダーに送信されます。
-
お客様がリーダーにカードをかざすか挿入します。処理中は、パネルに決済処理中… と表示され、リーダーで実行中の処理が括弧内に表示されます。
-
リーダーから決済完了が通知されると、パネルに決済が完了しました。注文を送信中… と表示され、POSはレシート画面に進みます。
販売処理は自動で完了するため、レガシータブ下部の支払いを処理を押す必要はありません。リーダーの処理が完了する前に押すと、POSに注文を確定する前にPayPal Readerでの決済を完了してください。 と表示されます。
ボタンの下にある暗い背景のボックスには、処理の各段階が時刻付きで行ごとに記録されます。決済が途中で止まった場合に確認してください。
リーダーでは常に注文の全額を決済するため、ほかの支払い方法と併用できません。注文に対して一度でも支払いを受け付けると、レガシータブに全額決済のみと表示され、使用できなくなります。先にその支払いをキャンセルしてください。
決済を中止する
決済中に決済をキャンセルを押します。リーダーにキャンセル要求が送信され、レジはリーダーからの通知の受信を停止します。パネルには決済がキャンセルされました。 と表示されます。
決済をキャンセルを押した後、またはリーダーでの処理中に支払いページを閉じたり再読み込みしたりした場合、レジはリーダーからの通知を受信しなくなります。それでもリーダーに決済承認が表示されている場合、お客様は支払い済みです。再度請求しないでください。支払いタブのカードタイルでその支払いを記録し、Zettleアカウントで決済を確認してください。
お客様に請求されていないことを確認してから、リーダー決済を開始を押して再試行するか、タブを閉じて別の支払い方法を使用してください。
販売後
注文は支払い済みになり、取引IDにはZettleのカード決済IDが設定されます。このIDでZettleアカウント内の同じ決済を検索できます。注文メモには、決済の開始時刻と使用したリーダー(リンクID)、決済が完了した時刻、金額の不一致で拒否された時刻、または決済をキャンセルでキャンセルされた時刻が記録されます。
払い戻し
この拡張機能ではZettle経由で払い戻しできないため、PayPal Readerに払い戻しは使用できません。
お客様に現金を渡さないでください。カードへの払い戻しはZettleで行い、現金で払い戻しではWCPOSにその記録を残すだけです。レジが開いている場合は、ドロワー内にあるはずの現金残高も同額だけ減少します。現金での払い戻しとドロワーを参照してください。
- Zettleアカウントでカードへの払い戻しを行います。
- 現金で払い戻しを使用して、注文に払い戻しを記録します。払い戻し先を参照してください。
問題が発生した場合
ペアリング済みのリーダーがありません。店舗の管理者にペアリングを依頼してください… Zettleアカウントにペアリングされたリーダーがないため、リーダー決済を開始はグレー表示のままです。WP Adminにアクセスできる担当者がペアリングする必要があります。設定するのリーダーをペアリングするを参照してください。
パネルが「リーダーに接続中…」のまま変わらない リーダーで決済を受け付ける準備ができていません。スリープ中、電源がオフ、オフライン、または別の処理中の可能性があります。スリープを解除し、ホーム画面が表示されていてオンラインであることを確認してください。決済をキャンセルを押し、決済を中止するの説明に従ってリーダーで決済が行われていないことを確認してから、もう一度リーダー決済を開始を押してください。
決済がキャンセルされました。 リーダー上の操作、または決済をキャンセルで決済がキャンセルされました。 決済をキャンセルを押した場合は、決済を中止するの説明に従って、まずリーダーを確認してください。その後、再度開始するか、別の支払い方法を使用してください。
決済に失敗しました。カードに請求されていますか?
決済に失敗しました。 に続くメッセージから、お客様が支払い済みかどうか、つまり再度請求してよいかどうかを判断できます。メッセージを確認し、該当する手順に従ってください。
- 決済金額が一致しません。:請求済みのため、先に払い戻す。
- 括弧内に理由が表示される:未請求のため、再試行する。
- リクエストに失敗しました。、サーバーの応答が無効です。、リクエストが無効です。、または注文へのアクセスが無効です。:請求済みのため、支払いを記録する。
- 後続のメッセージがない、またはここに記載されていないメッセージが表示される:再試行する前に確認する。
決済金額が一致しません:請求済みのため、先に払い戻す
カードへの請求:あり。 パネルに決済に失敗しました。決済金額が一致しません。 と表示されます。リーダーで代金は受領していますが、決済開始後に注文の合計金額が変わったため、注文が拒否され、未払いのままになっています。Zettleアカウントでその決済を払い戻し、正しい合計金額で新たに決済を開始してください。これを防ぐため、リーダーでの決済中はカートを変更しないでください。決済をキャンセルを押し、カートを変更してから、新たに決済を開始してください。
括弧内に理由が表示される:未請求のため、再試行する
カードへの請求:なし。 パネルに決済に失敗しました。 と表示され、括弧内に理由が示されます。カードの承認が拒否された場合など、リーダーまたはZettleで決済が行われていません。リーダー決済を開始を押すか、別の支払い方法を使用してください。
「決済に失敗しました。」のみ、または記載のないメッセージ:再試行する前に確認する
カードへの請求:不明。 パネルには決済に失敗しました。 とだけ表示されます。レジとZettleの接続が切れたため、カードに請求されたかどうかを判断できません。このページに記載のないメッセージも同様に扱ってください。リーダーとZettleアカウントの決済一覧を確認します。該当する決済があれば、決済を中止するの説明に従って記録してください。決済が行われていないと確認できた場合にのみ、再度開始してください。判断できない場合は、再度請求する前にZettleアカウントの管理担当者に確認してください。
「リクエストに失敗しました。」など、ここに記載のメッセージ:請求済みのため、支払いを記録する
この手順が当てはまるのは、決済に失敗しました。 の後にリクエストに失敗しました。、サーバーの応答が無効です。、リクエストが無効です。、注文へのアクセスが無効です。 のいずれかが表示される場合のみです。ほかのメッセージの場合は、「決済に失敗しました。」のみの手順に従ってください。
カードへの請求:あり。 これらのメッセージは、リーダーが決済完了を通知した後にのみ表示されます。リーダーで決済は行われましたが、店舗のサイトに記録できなかったため、注文は未払いのままです。Zettleアカウントで該当する決済を見つけ、決済を中止するの説明に従って記録してください。Zettleアカウントに該当する決済がない場合は、「決済に失敗しました。」のみの手順に従い、確認できるまで再度請求しないでください。
その他のメッセージ
Zettleの認証情報が設定されていません。 ZettleクライアントIDまたはZettleアサーションが空欄です。ゲートウェイの設定担当者に入力を依頼してください。設定するのゲートウェイの設定を入力するを参照してください。
「Zettle OAuth交換でHTTP …が返されました」で始まるメッセージ Zettleが認証情報を拒否しました。ゲートウェイの設定担当者に、ZettleクライアントIDとZettleアサーションの確認を依頼してください。
パネルにボタンは表示されるが、「リーダーを読み込み中…」が表示されない 支払いページのスクリプトが読み込まれていません。ゲートウェイの支払いページが正しく表示されないを参照してください。
設定中のメッセージ
リーダーをペアリングする前に、上のZettleクライアントIDとアサーションを保存してください。 ペアリング済みのリーダーセクションは、両方の認証情報が保存されるまで使用できません。入力して保存してください。
先にペアリングコードを入力してください。 ペアリングコード欄が空です。リーダーに表示されているコードを確認し、入力してください。
ペアリング済みのリーダーを読み込めませんでした: この後にZettleからの応答が表示されます。設定ページからZettleに接続できなかったか、Zettleが認証情報を拒否しました。認証情報を確認し、再度保存してください。
「リーダーをペアリング」で「Zettle APIがHTTP …を返しました」で始まるメッセージが表示される Zettleがペアリングコードを拒否しました。リーダーで設定 → 開発者とリンクを開いて新しいコードを取得し、表示どおりに入力してください。また、リーダーがオンラインであることを確認してください。それでも失敗する場合は、ZettleクライアントIDとZettleアサーションが保存されているか確認してください。
PayPal Reader:モックリーダーが有効です。 開発者向けの設定PRWC_USE_MOCK_READERがwp-config.phpに定義されています。この設定がある間は、実際の決済は行われません。開発者またはホスティング会社に削除を依頼してください。
設定する
ここでは店舗のWP Adminを管理する担当者向けに、拡張機能のインストールからPOSでの有効化までを五つの手順で説明します。
インストール、認証情報の入力、リーダーのペアリング、POSでの有効化
拡張機能をインストールする
WP Admin > POS > 設定 > 拡張機能を開き、PayPal Reader for WooCommerceを見つけて、インストール、有効化の順にクリックします。拡張機能のインストールを参照してください。
ディレクトリを使用しない場合は、GitHubのリリースページからプラグインのzip(ソースコードのzipではありません)をダウンロードし、プラグイン > Add Plugin、プラグインのアップロードの順に進んでアップロードします。WooCommerceが有効になっている必要があります。
Zettleの認証情報を取得する
Zettle Developer Portalで、ZettleアカウントのクライアントIDとアサーション(JWT)を取得します。実際の請求を行わずにゲートウェイを試すには、まずZettleの開発者用(テスト用)加盟店アカウントを使用してください。
利用できるPayPal Readerの機種と国は、WCPOSではなくZettleアカウントによって決まります。リーダーを購入する前にPayPalに確認してください。
ゲートウェイの設定を入力する
WP Admin > WooCommerce > 設定 > 支払いに移動し、PayPal Readerを開きます。- テストアカウントで試す間は、テストモードを有効化をデフォルトのチェック付きのままにします。
- ZettleクライアントIDとZettleアサーションを入力します。
- 必要に応じて、レジ係が支払いページで選択するタイトルと、その説明を変更します。
- 保存します。
リーダーをペアリングする
- 同じ設定ページの下部にあるペアリング済みのリーダーまでスクロールします。両方の認証情報を保存すると表示されます。
- PayPal Readerで設定 → 開発者とリンクを開きます。リーダーにペアリングコードが表示されます。
- 新しいリーダーをペアリングで、ペアリングコードと、
Front counterなどのリーダー名を入力します。名前を入力しない場合は、WCPOS PayPal Readerという名前になります。 - リーダーをペアリングをクリックします。ページにリーダーをペアリングしました。 と表示され、リーダーが一覧に追加されます。
すべてのレジに、Zettleアカウントにペアリングされたすべてのリーダーが表示されます。レジ係はチェックアウト時に使用するリーダーを選択します。削除するには、該当するリーダーの横にあるペアリングを解除をクリックし、確認します。
POSで有効にする
WP Admin > POS > 設定 > 支払いに移動し、PayPal Readerの有効をオンにします。ゲートウェイの有効化を参照してください。
WebチェックアウトでPayPal Readerを有効化(WCPOSでは不要) のチェックは外したままにしてください。この設定はオンラインショップにゲートウェイを表示するためだけのものです。POSでは、ここの設定で有効にすると使用できます。
テストモードと本番運用への切り替え
テストモードは、リーダーをサンドボックスに切り替える設定ではありません。Zettleではテスト決済と実際の決済に同じ接続先を使用しており、実際のお金が動くかどうかは認証情報に紐づくアカウントで決まります。テストモードで変わるのは、決済パネルのテストモードバッジと、ステータス行のモード:テスト。 という表示だけです。
本番運用に切り替えるには:
- ZettleクライアントIDとZettleアサーションを、本番用Zettleアカウントのものに置き換えます。
- テストモードを有効化のチェックを外し、保存します。
- ペアリング済みのリーダーを確認します。一覧はZettleアカウントから取得されるため、テストアカウントにペアリングしたリーダーは表示されません。設定するのリーダーをペアリングするの手順に従って、再度ペアリングしてください。
- 少額の実際の決済を行い、Zettleで払い戻します。
設定リファレンス
設定はWP Admin > WooCommerce > 設定 > 支払い > PayPal Readerにあります。必要な設定は上記の手順で説明しています。すべての設定とデフォルト値を確認するには、一覧を開いてください。
全6項目の設定とペアリングパネル
| 設定 | 機能 |
|---|---|
| 有効化/無効化 | WebチェックアウトでPayPal Readerを有効化(WCPOSでは不要)。オンラインショップにゲートウェイを表示します。オンラインでは既存の注文の支払いページでしか機能しないため、オフのままにしてください。デフォルトはオフです。POSには、POS > 設定 > 支払いに専用のスイッチがあります |
| タイトル | レジ係が支払いページで選択する名前です。デフォルトはPayPal Readerです |
| 説明 | タイトルの下に表示される文です。デフォルトはPay in person using PayPal Reader.です |
| テストモード | テストモードを有効化。決済パネルにテストモードバッジを表示します。デフォルトはオンです。決済の接続先は変わりません |
| ZettleクライアントID | Zettle Developer Portalで取得するZettle OAuthクライアントIDです |
| Zettleアサーション | Zettle OAuthアサーション(JWT)です。パスワードと同様に非表示で保持されます |
設定の下にあるペアリング済みのリーダーには、各リーダーの名前とリンクID、ペアリングを解除が表示されます。新しいリーダーをペアリングには、ペアリングコードとリーダー名を入力します。
ログ
まず注文メモを確認してください。決済の開始、完了、金額不一致による拒否、およびレジでの決済をキャンセルの操作が、その注文に記録されます。カードの承認拒否、リーダーでのキャンセル、接続の切断は記録されないため、支払いページのログボックスを確認してください。
Zettleのリーダーサービスがリクエストを拒否した場合や接続できない場合は、拡張機能がWP Admin > WooCommerce > Status > ログにも記録を残します。ソースはpaypal-reader-for-woocommerceです。サポートを依頼する際は、このログと注文番号を送ってください。
要件
対応していない機能
- WooCommerceまたはPOSからZettle経由で行う払い戻し。
- リーダーでのチップの受け付け。
- 一部金額の支払い。リーダーでは常に注文の全額を決済します。
- 支払いページを閉じたり再読み込みしたりした後の決済の再開。
- オンラインショップの通常のチェックアウト。オンラインでは既存の注文の支払いページでのみ機能します。
開発者向け:仕組み
店舗のサイトはJWT-bearer OAuthグラント(oauth.zettle.com)でZettleにサインインし、有効期限の30秒前までアクセストークンをキャッシュします。ペアリング、リーダー一覧、決済セッションにはZettleのReader Connect API(reader-connect.zettle.com/v1/integrator)を使用します。ペアリングではリーダーのコードを使ってリンクオファーを取得し、各リーダーをリンクとして扱います。
リーダー決済を開始は、選択したリンクのセッションを開くよう店舗のサイトに要求します。続いて支払いページがZettleへのWebSocket接続を開き、リーダーの状態を要求します。リーダーの準備ができると、チップなしで注文の合計金額の決済リクエストを送信します。進捗は同じソケット経由で返されます。決済をキャンセルは、そのソケットでキャンセル要求を送信します。
リーダーがCOMPLETEDを通知すると、ページは結果を店舗のサイトに送信します。店舗のサイトは、金額が注文の合計金額と一致する場合にのみ受け入れます。Zettleのカード決済IDを取引IDとして保存し、注文を確定します。この確認が完了するまで注文は確定できません。
自動テストでは、PRWC_USE_MOCK_READER(またはpaypal_reader_for_woocommerce_use_mock_readerフィルター)とPRWC_MOCK_CANCEL_BEHAVIORを使用して、Zettleをモックリーダーに置き換えます。これは設定画面には表示されず、有効な間はWP Adminに警告が表示されます。
関連ドキュメント
- レガシータブ
- チェックアウト
- レジ設定
- 拡張機能
- GitHubで問題を報告する。Zettleアカウント、リーダー、対応国については、PayPalにお問い合わせください。