# PayPal リーダー (Zettle) ゲートウェイ

PayPal リーダー ゲートウェイを使用すると、**PayPal リーダー (Zettle)** カード端末を使用して、WCPOS から直接対面でのカード支払いを受け入れることができます。ブラウザは、安全な接続を介してリーダーから Zettle の Reader Connect API へのライブ支払いステータスをストリーミングするため、レジ担当者は支払いの各ステップを発生時に確認できます。

## 特長[​](#features "特長への直接リンク")

#### 対面でのカード支払い

PayPal リーダー (Zettle) 端末でチップ、非接触、モバイル ウォレットの支払いを行う

#### ライブ支払いステータス

POS は、接続、支払い進行中、完了、キャンセルなどの進行状況をリアルタイムで表示します。

#### サーバー側で確認された金額

報告された金額は、注文が行われる前に常に注文合計と照合されます。

#### 簡単なペアリング

デバイスに表示されるペアリング コードを使用して、ゲートウェイ設定からリーダーをリンクします。

## 要件[​](#requirements "要件への直接リンク")

WCPOS

<!-- -->

: POS チェックアウトには Pro バージョンが必要です

WordPress

<!-- -->

: WordPress 5.2 以降 (WooCommerce がアクティブな場合)

PHP

<!-- -->

: PHP 7.4以降

Zettle アカウント

<!-- -->

: Zettle 開発者販売アカウント、および Zettle 開発者ポータルからの Zettle クライアント ID およびアサーション (JWT)

互換性のあるハードウェア

<!-- -->

: PayPalリーダー（Zettle）カード端末

安定した接続

<!-- -->

: ライブ支払いはステータスをネットワーク経由でリーダーにストリーミングするため、インターネット接続が必要です

サポートされているハードウェアと地域

PayPal リーダー / Zettle の入手可能性、サポートされているリーダー モデル、およびサポートされている国は、WCPOS ではなく、**Zettle 販売アカウント**によって決まります。購入する前に、お使いのリーダーと地域が PayPal/Zettle に対応していることを確認してください。

## インストール[​](#installation "インストールへの直接リンク")

1

#### WooCommerce 用の PayPal リーダーをインストールする

`WP Admin > POS > Settings > Extensions` からインストールするか、[GitHub リリース ページ](https://github.com/wcpos/paypal-reader-for-woocommerce/releases) から最新の **プラグイン zip アセット** (GitHub ソースコード zip や tarball ではない) をダウンロードし、`Plugins > Add New > Upload Plugin` 経由でアップロードします。 WooCommerce がインストールされ、アクティブになっている必要があります。

2

#### ゲートウェイを構成する

1. `WP Admin > WooCommerce > Settings > Payments` に移動します
2. 支払い方法リストで **PayPal Reader** を見つけ、その設定を開きます
3. セットアップを確認する間、**テスト モードを有効にする** はオンのままにしてください。 Zettle 開発者販売アカウントの認証情報をテスト モードで使用します。後で無効にしてライブ支払いを受けることができます
4. **Zettle クライアント ID** を入力してください — Zettle 開発者ポータルからの Zettle OAuth クライアント ID
5. **Zettle アサーション** — Zettle OAuth アサーション (JWT) を入力します。これは秘密として扱われます
6. 必要に応じて、顧客に表示する **タイトル** と **説明** を設定します
7. **設定を保存**

ノート

**「Web チェックアウト用に PayPal リーダーを有効にする」** チェックボックスは、オンライン ストアのチェックアウト専用です。**POS には必要ありません**。後の手順で POS のゲートウェイを有効にします。

3

#### リーダーをペアリングする

1. 保存後、設定画面の下部にある \[**ペアリングされたリーダー**] セクションまでスクロールします (クライアント ID とアサーションが保存されると表示されます)。
2. PayPal リーダー デバイスで、**\[設定] → \[開発者とリンク]** を開き、ペアリング コードを表示します。
3. **新しいリーダーのペアリング** で、**ペアリング コード** を入力し、必要に応じて **リーダー名** (例: 「フロント カウンター」) を入力します。
4. \[**リーダーをペアリング**] をクリックします。リーダーがペアリングされたリストに表示され、支払いを受ける準備ができています

重要

支払いを受ける前に、リーダーが正常にペアリングされている必要があります。リーダーを削除するには、ペアリングされたリストで **ペアリング解除** を使用します。

4

#### WCPOS で有効にする

1. `WP Admin > POS > Settings > Checkout` に移動
2. リストで **PayPal Reader** ゲートウェイを見つけます
3. POS で使用できるように有効にします。
4. 設定を保存する

## 支払いを受ける[​](#taking-a-payment "支払いを受けるへの直接リンク")

1. POS のカートに **アイテムを追加**し、チェックアウトに進みます
2. **支払い方法として PayPal リーダーを選択**
3. **ペアリングされたリーダーを選択**し、支払いを開始します。 (どれもペアリングされていない場合は、ストア管理者に `WooCommerce → Settings → Payments → PayPal Reader` でペアリングするよう求めるメッセージが表示されます。)
4. POS は、接続中にライブ ステータスを表示します: *「リーダーに接続中…」*、*「リーダーの準備ができました。支払いを要求しています…」*、*「支払いが進行中です…」*
5. 顧客がカードをリーダーにタップまたは挿入します
6. 成功すると、金額が注文合計と照合され、取引参照が記録され、注文が自動的に行われます。
7. リーダーでのリクエストをキャンセルするには、いつでも **支払いのキャンセル** を使用してください

## ライブに行く[​](#going-live "ライブに行くへの直接リンク")

テストモードですべてを確認したら:

1. **テストモードを有効にする**を無効にする
2. Zettle テスト資格情報を **本番環境**のクライアント ID とアサーションに置き換えます。
3. 保存 — エンドポイントとフローは同一です。販売アカウントのみが異なります

## 要件の要約と制限事項[​](#limitations "要件の要約と制限事項への直接リンク")

* **注文は、リーダーの結果が確認された後にのみ完了します。** WCPOS は、支払いが完了したと報告されない限り、注文を行いません。
* **金額不一致からの保護。** 読者が報告した金額が注文合計と一致しない場合、支払いは拒否されるため、支払い途中でカート合計を編集することは避けてください。
* **接続。** ライブ支払いは、Zettle の Reader Connect API へのセッションを維持しているブラウザに依存します。安定したインターネット接続が必要です。

## トラブルシューティング[​](#troubleshooting "トラブルシューティングへの直接リンク")

ペアリングされたリーダーセクションが表示されない

まず、**Zettle クライアント ID** と **アサーション** を保存します。ペアリング パネルは、両方の認証情報が保存された場合にのみ表示されます。それ以外の場合は、「リーダーをペアリングする前に、上記の Zettle クライアント ID とアサーションを保存してください。」\_ と表示されます。

リーダーがペアリングしない

* リーダーで **\[設定] → \[開発者とリンク]** を開いて新しいペアリング コードを取得していることを確認してください
* 有効期限が切れる前に、表示されているとおりにコードを正確に入力してください
* Zettle クライアント ID とアサーションが正しく保存されていることを確認します。
* リーダーとネットワークに安定したインターネット接続があることを確認してください

金額が一致しないため支払いが拒否される

プラグインは、読者から報告された金額を注文合計と照合し、不一致を拒否します。支払いの進行中はカートや注文合計を変更しないでください。支払いをキャンセルし、カートを調整してから、新しい支払いを開始してください。

実際の支払いは処理されません / 「模擬リーダー」に関する管理者の警告が表示されます

`wp-config.php`には開発/CI定数(`PRWC_USE_MOCK_READER`)が定義されています。ライブ支払いを行う前にその定数を削除してください。この定数が設定されている間は、実際の支払いは処理されません。

### 助けを求める[​](#getting-help "助けを求めるへの直接リンク")

* [GitHub リポジトリ](https://github.com/wcpos/paypal-reader-for-woocommerce) でゲートウェイの問題を報告する
* アカウント、リーダー ハードウェア、および地域の可用性に関する質問については、PayPal/Zettle サポートにお問い合わせください。