PayArc Terminal ゲートウェイ
PayArc Terminalゲートウェイを使うと、WCPOSからPayArc Connect経由でPayArc PAX端末による対面決済を受け付けられます。WooCommerceで決済を開始し、端末で完了します。PayArcの確認後にのみ、注文は支払い済みになります。
機能
PAX端末との連携
ローカルでペアリングすることなく、クラウド上のPayArc Connect経由でPayArc PAX端末に決済を送信します
決済完了の検証
完了前に金額と通貨が注文と一致している必要があります。カードブランド、入力方式、末尾4桁は注文に保存されます
明確な拒否理由
拒否理由はレジ係に表示され、注文メモにも追加されます
端末レシート
端末で加盟店用レシート、顧客用レシート、または両方を印刷できます
組み込みの診断機能
設定を検証ボタンと識別情報をマスキングした診断テーブルで接続を確認できます
仕組み
WordPressがPayArc Connectを呼び出し、PayArcがPAX端末に接続します。POSはサイトとのみ通信します。各決済では注文合計全額が請求されます。
決済ページは1.5秒ごとに結果を確認し、5分後に停止します。PayArcからWebhook URLへのコールバックにより結果の反映が速くなります。コールバックがなくてもポーリングで決済は完了します。顧客が端末で支払っている間は、決済ページを開いたままにしてください。
設定
WooCommerce用PayArc Terminalをインストールする
WP Admin > POS > 設定 > 拡張機能からインストールするか、GitHubリリースページからpayarc-terminal-for-woocommerce.zipをダウンロードし、プラグイン > 新規追加 > プラグインのアップロードからアップロードします。プラグインを有効化してください。
PayArcの認証情報を入力する
WP Admin > WooCommerce > 設定 > 支払いに移動し、PayArc Terminalを開きます- Modeを選択します。既定値は
Liveです。TestはPayArcテストダッシュボードの認証情報とPayArc Connect Testアプリを使用する場合に限ります。環境を混在させないでください - PayArc加盟店ダッシュボードへのサインインに使うメールアドレスをPayArc login emailに入力します
- 端末IDではなく、PayArc Merchant Profileに記載されているPayArc MIDを入力します
- ダッシュボードのAPIセクションにあるPayArc ClientSecretと、PayArcダッシュボードにあるPayArc SecretKey / API bearer tokenを入力します
- PayArcサポートから発行されていない限り、Callback bearer tokenは空欄のままにします。この項目は任意です
接続
これらの認証情報で接続をクリックします。成功すると、端末のシリアル番号の入力または確認を求められるので、設定を保存します。認証情報が別の環境のものと思われるというメッセージが表示された場合は、Modeを切り替えて再接続してください。
モードまたは認証情報を変更した後は、再度これらの認証情報で接続をクリックして保存してください。モードと認証情報が保存済みの接続と一致するまで、決済はブロックされます。0.1.14より前のバージョンからアップグレードした場合は、接続を一度クリックしてください。
端末を追加する
- PayArcアカウント用に設定された、端末背面のS/Nラベルに記載されているPAXのTerminal serial numberを入力します
- Tender typeとPrint receiptを選択します
- Webhook URLがHTTPSであることを確認します。PayArcから求められた場合にのみURLを伝えてください
- 変更を保存をクリックします
LiveモードにはHTTPSのサイトが必要です。
WCPOSで有効にする
WP Admin > POS > 設定 > 支払いに移動します- PayArc Terminalゲートウェイを見つけ、POSで有効にします
- 設定を保存します
WooCommerceの設定画面にあるEnable/Disableチェックボックスは、オンラインストアのチェックアウトのみを制御します。このチェックボックスの状態にかかわらず、WCPOSではゲートウェイの設定後に利用できます。
ほとんどの店舗では、このチェックを外したままにします。
設定項目
| 設定 | 説明 |
|---|---|
| Enable/Disable | オンラインストアのチェックアウトでPayArc Terminalを有効にします。既定ではオフです。POSでの有効化はPOS > 設定 > 支払いで設定します |
| Title | チェックアウトに表示するラベルです。既定値はPayArc Terminalです |
| Description | チェックアウトに表示する説明です。既定値はPay in person at a PayArc PAX terminal.です |
| Mode | Live（既定）またはTestです。TestにはPayArcテストダッシュボードの認証情報とPayArc Connect Testアプリが必要です |
| PayArc login email | PayArc加盟店ダッシュボードへのログイン用メールアドレスです。接続前に入力が必要です |
| PayArc MID | PayArc Merchant Profileにある加盟店MIDです。端末IDではありません |
| PayArc ClientSecret | ダッシュボードのAPIセクションにあるシークレットです。サーバーにのみ保存されます |
| PayArc SecretKey / API bearer token | PayArcダッシュボードにあるトークンです。ログインと端末レジストリの取得に使用します |
| Callback bearer token | 任意です。PayArcサポートから発行された場合にのみ入力します |
| PayArc connection | これらの認証情報で接続、端末を更新、切断の各ボタンがあります |
| Terminal serial number | アカウントに割り当てられたPAXのS/Nです。決済に必須です。レジストリで見つかると自動入力されますが、保存前に入力または確認してください |
| Tender type | CREDIT（既定）またはDEBITです |
| Print receipt | 0 — 印刷しない（既定）、1 — 加盟店用、2 — 顧客用、3 — 両方 |
| Webhook URL | 読み取り専用のコールバックアドレスです。HTTPSであることを確認してください。PayArcから求められた場合にのみ伝えてください |
| PayArc diagnostics | 接続情報と設定を検証ボタンを表示します。シークレットは表示されません |
保存済みのシークレット項目には末尾4文字のみが表示されます。保存済みの値を維持するには、シークレット項目を空欄のままにしてください。
PayArc diagnosticsテーブルには、モード、エンドポイント、マスキングされたMID / テナントID / シリアル番号、Connectアクセストークンの設定状況、Webhook URL、最後のコールバック、最後のPayArcエラーが表示されます。設定を検証を使って設定を確認してください。
使い方
決済の処理
- ゲートウェイを選択：POSで支払い方法としてPayArc Terminalを選びます
- 決済を開始：決済を開始をクリックして注文合計を端末に送信します
- 顧客による支払い：顧客がPAX端末で支払いを完了するまで、ページを開いたままにします。ステータスメッセージを確認してください：
Starting terminal payment...→Payment sent to terminal.→Waiting for the terminal result...→Payment approved. Completing the order... - 自動完了：PayArcが支払いを確認すると、注文は自動的に完了します
決済の操作
- 決済の開始後に決済をキャンセルが表示されます。PayArcからtrace idがまだ返されていない場合は、キャンセルする前に少し待ってください
- 拒否、キャンセル、またはタイムアウト後は再試行できます。タイムアウトした決済を再試行する前に、端末を確認してください
- 決済アクティビティログは既定で折りたたまれています。アクティビティを表示で表示し、クリアで表示中のアクティビティを消去します
レシート
Print receipt設定は、端末での印刷（なし、加盟店用、顧客用、または両方）を制御します。
返金
このプラグインでは返金に対応していません。PayArcで返金した後、WooCommerceに返金を手動で記録してください。
ログ
ログはWooCommerce > Status > ログのpayarc-terminal-for-woocommerceソースにあります。接続試行、開始または失敗した販売、キャンセル、受理または拒否されたコールバックが記録されます。識別情報はマスキングされ、シークレットは伏せられます。
サポートバンドルをダウンロードする機能はありません。問い合わせる際は、注文番号と関連するログ行を送ってください。完全なMID、端末ID、トークン、カード情報は共有しないでください。
要件
対象範囲と制限
- このプラグインでは返金に対応していません
- 決済では注文合計全額が請求されます。一部のみの決済や複数の支払いに分ける決済には対応していません
- チップには対応していません
- 店舗ごとに端末は1台です。シリアル番号の設定は1つで、レジ係が選択する機能はありません
- 通貨はUSD、CAD、GBP、EUR、JPYに限られます
- モードと認証情報が保存済みの接続と一致するまで、決済はブロックされます
トラブルシューティング
よくある問題
認証情報が別の環境のものと思われる
- 選択したモードと認証情報の環境が一致していません
- 認証情報に合わせてModeを切り替えるか、選択したモードに対応する認証情報に置き換えてください
- もう一度これらの認証情報で接続をクリックして保存してください
PayArcに接続できない
- PayArcがログイン認証情報を拒否しました。入力した認証情報を確認して、もう一度お試しください
- 詳細は
WooCommerce > Status > ログのpayarc-terminal-for-woocommerceソースを確認してください
決済リクエストを処理できません。（HTTP 500）
- このレジ係向けメッセージは一般的な内容です。実際の原因はWooCommerceログのPayArc payment action failedで確認してください
- モードまたは認証情報を変更した後は、もう一度これらの認証情報で接続をクリックして保存してください
- Terminal serial numberが入力されていることを確認してください
- ログにConnectアクセストークンとSecretKeyの両方がPayArcに拒否されたと記録されている場合は、加盟店アカウントでPayArc Connect V3が有効になっているかPayArcサポートに確認してください
- 店舗の通貨がUSD、CAD、GBP、EUR、JPYのいずれかであることを確認してください
決済開始時にアクセスが拒否されました。（HTTP 403）
- POSセッションでこのエラーを修正した0.1.12以降に更新してください
Terminal Registryが空です
- レジストリが空、またはPOS識別子のない端末が表示されるのは正常です
- レジストリのデータは情報表示のみです。決済にはTerminal serial numberを使用します
決済の応答に時間がかかる
- 端末の画面を確認し、決済ページを開いたままにしてください
- 再試行する前に、注文メモとPayArcダッシュボードを確認してください
- ページは1.5秒ごとに確認し、5分後に停止します
サポートへの問い合わせ
- サポートへの問い合わせには、注文番号と関連するログ行を添えてください
- 問題を報告するにはGitHubリポジトリをご覧ください
- アカウント、PayArc Connect、端末の設定についてはPayArcサポートにお問い合わせください