PayPal リーダー (Zettle) ゲートウェイ
PayPal リーダー ゲートウェイを使用すると、PayPal リーダー (Zettle) カード端末を使用して、WCPOS から直接対面でのカード支払いを受け入れることができます。ブラウザは、安全な接続を介してリーダーから Zettle の Reader Connect API へのライブ支払いステータスをストリーミングするため、レジ担当者は支払いの各ステップを発生時に確認できます。
特長
対面でのカード支払い
PayPal リーダー (Zettle) 端末でチップ、非接触、モバイル ウォレットの支払いを行う
ライブ支払いステータス
POS は、接続、支払い進行中、完了、キャンセルなどの進行状況をリアルタイムで表示します。
サーバー側で確認された金額
報告された金額は、注文が行われる前に常に注文合計と照合されます。
簡単なペアリング
デバイスに表示されるペアリング コードを使用して、ゲートウェイ設定からリーダーをリンクします。
要件
PayPal リーダー / Zettle の入手可能性、サポートされているリーダー モデル、およびサポートされている国は、WCPOS ではなく、Zettle 販売アカウントによって決まります。購入する前に、お使いのリーダーと地域が PayPal/Zettle に対応していることを確認してください。
インストール
WooCommerce 用の PayPal リーダーをインストールする
WP Admin > POS > Settings > Extensions からインストールするか、GitHub リリース ページ から最新の プラグイン zip アセット (GitHub ソースコード zip や tarball ではない) をダウンロードし、Plugins > Add New > Upload Plugin 経由でアップロードします。 WooCommerce がインストールされ、アクティブになっている必要があります。
ゲートウェイを構成する
WP Admin > WooCommerce > Settings > Paymentsに移動します- 支払い方法リストで PayPal Reader を見つけ、その設定を開きます
- セットアップを確認する間、テスト モードを有効にする はオンのままにしてください。 Zettle 開発者販売アカウントの認証情報をテスト モードで使用します。後で無効にしてライブ支払いを受けることができます
- Zettle クライアント ID を入力してください — Zettle 開発者ポータルからの Zettle OAuth クライアント ID
- Zettle アサーション — Zettle OAuth アサーション (JWT) を入力します。これは秘密として扱われます
- 必要に応じて、顧客に表示する タイトル と 説明 を設定します
- 設定を保存
「Web チェックアウト用に PayPal リーダーを有効にする」 チェックボックスは、オンライン ストアのチェックアウト専用です。POS には必要ありません。後の手順で POS のゲートウェイを有効にします。
リーダーをペアリングする
- 保存後、設定画面の下部にある [ペアリングされたリーダー] セクションまでスクロールします (クライアント ID とアサーションが保存されると表示されます)。
- PayPal リーダー デバイスで、[設定] → [開発者とリンク] を開き、ペアリング コードを表示します。
- 新しいリーダーのペアリング で、ペアリング コード を入力し、必要に応じて リーダー名 (例: 「フロント カウンター」) を入力します。
- [リーダーをペアリング] をクリックします。リーダーがペアリングされたリストに表示され、支払いを受ける準備ができています
支払いを受ける前に、リーダーが正常にペアリングされている必要があります。リーダーを削除するには、ペアリングされたリストで ペアリング解除 を使用します。
WCPOS で有効にする
WP Admin > POS > Settings > Checkoutに移動- リストで PayPal Reader ゲートウェイを見つけます
- POS で使用できるように有効にします。
- 設定を保存する
支払いを受ける
- POS のカートに アイテムを追加し、チェックアウトに進みます
- 支払い方法として PayPal リーダーを選択
- ペアリングされたリーダーを選択し、支払いを開始します。 (どれもペアリングされていない場合は、ストア管理者に
WooCommerce → Settings → Payments → PayPal Readerでペアリングするよう求めるメッセージが表示されます。) - POS は、接続中にライブ ステータスを表示します: 「リーダーに接続中…」、「リーダーの準備ができました。支払いを要求しています…」、「支払いが進行中です…」
- 顧客がカードをリーダーにタップまたは挿入します
- 成功すると、金額が注文合計と照合され、取引参照が記録され、注文が自動的に行われます。
- リーダーでのリクエストをキャンセルするには、いつでも 支払いのキャンセル を使用してください
ライブに行く
テストモードですべてを確認したら:
- テストモードを有効にするを無効にする
- Zettle テスト資格情報を 本番環境のクライアント ID とアサーションに置き換えます。
- 保存 — エンドポイントとフローは同一です。販売アカウントのみが異なります
要件の要約と制限事項
- 注文は、リーダーの結果が確認された後にのみ完了します。 WCPOS は、支払いが完了したと報告されない限り、注文を行いません。
- 金額不一致からの保護。 読者が報告した金額が注文合計と一致しない場合、支払いは拒否されるため、支払い途中でカート合計を編集することは避けてください。
- 接続。 ライブ支払いは、Zettle の Reader Connect API へのセッションを維持しているブラウザに依存します。安定したインターネット接続が必要です。
トラブルシューティング
ペアリングされたリーダーセクションが表示されない
まず、Zettle クライアント ID と アサーション を保存します。ペアリング パネルは、両方の認証情報が保存された場合にのみ表示されます。それ以外の場合は、「リーダーをペアリングする前に、上記の Zettle クライアント ID とアサーションを保存してください。」_ と表示されます。
リーダーがペアリングしない
- リーダーで [設定] → [開発者とリンク] を開いて新しいペアリング コードを取得していることを確認してください
- 有効期限が切れる前に、表示されているとおりにコードを正確に入力してください
- Zettle クライアント ID とアサーションが正しく保存されていることを確認します。
- リーダーとネットワークに安定したインターネット接続があることを確認してください
金額が一致しないため支払いが拒否される
プラグインは、読者から報告された金額を注文合計と照合し、不一致を拒否します。支払いの進行中はカートや注文合計を変更しないでください。支払いをキャンセルし、カートを調整してから、新しい支払いを開始してください。
実際の支払いは処理されません / 「模擬リーダー」に関する管理者の警告が表示されます
wp-config.phpには開発/CI定数(PRWC_USE_MOCK_READER)が定義されています。ライブ支払いを行う前にその定数を削除してください。この定数が設定されている間は、実際の支払いは処理されません。
助けを求める
- GitHub リポジトリ でゲートウェイの問題を報告する
- アカウント、リーダー ハードウェア、および地域の可用性に関する質問については、PayPal/Zettle サポートにお問い合わせください。