メインコンテンツにスキップ
バージョン: 1.x

Mollieターミナルゲートウェイ

Mollieターミナルゲートウェイを使うと、Mollie Terminalのハードウェアでの対面決済を、WCPOSから直接受け付けられます。支払いはWooCommerceから開始し、ターミナル上で完了します。Mollieからの確認結果は注文に書き戻されます。

機能​

ハードウェア統合

Mollieアカウントに登録されたMollieターミナルへ支払いを送信し、カード提示による決済を受け付けます

手動ペアリング不要

ターミナルはMollieアカウントからリアルタイムで取得されます。ドロップダウンから選ぶだけで、デバイスIDを貼り付ける必要はありません

確実な完了

支払いはMollieへのポーリングで確認され、ターミナルが確定するとPOSは自動的に領収書へ遷移します

安全な取引

PCIに準拠したカード提示決済を、Mollieのハードウェア上で処理します

返金に対応

WooCommerceの注文画面から返金でき、Mollieと突き合わせるため返金が重複することはありません

仕組み​

Mollieターミナルは、Mollieのサーバーサイド pointofsale 決済を使用します。支払いを開始すると、WooCommerceがその注文に対するMollieの決済を作成し、Mollieがそれを選択されたターミナルへ送ります。お客様はデバイス上で支払い、決済と返金の状態については Mollieが正となります。ローカルのWooCommerce注文メタは、あくまでキャッシュです。

支払いが確定する仕組み。 支払いの進行中、POSはMollieにポーリングし（既定では2秒ごと）、ターミナルが確定した時点で「ありがとう」ページへ直接遷移します。これを速めるためにMollieのWebhookも利用されます。WebhookのURLは支払いのたびに自動的に設定されるため、Mollieのダッシュボードで設定するものはありません。

ターミナルは、プラグインと同じMollieアカウントに登録され、有効になっている必要があります。

セットアップ​

1

Mollie Terminal for WooCommerceをインストールする

WP管理 > POS > 設定 > 拡張機能からインストールするか、GitHubのリリースページから最新のプラグインzipアセット（GitHubのソースコードzipやtarballではありません）をダウンロードし、プラグイン > 新規追加 > プラグインのアップロードからアップロードします。

2

Mollieの認証情報を設定する

  1. WP管理 > WooCommerce > 設定 > 支払いに移動し、Mollieターミナルを開きます
  2. モードを Live に設定します。ターミナル決済にはライブアカウントが必要です（対応範囲と制限を参照）
  3. APIキーのソースを、公式のMollie Payments for WooCommerceプラグインのキーを再利用するか、この画面で入力したキーを使うかに設定します
  4. ここでキーを入力する場合は、MollieのライブAPIキーを Mollie APIキーに貼り付けます
  5. 保存します
ライブモードを使用してください

Mollieのターミナルはライブアカウントにのみ存在するため、テストAPIキーでターミナルを動かすことはできません。テストモードが選択されていると、設定画面に警告が表示されます。支払いを受け付けるには、ライブAPIキーとともに Live に切り替えてください。対応範囲と制限をご覧ください。

プロファイルIDは不要です

pointofsale 決済にMollieのプロファイルIDは必要なく、ターミナルはアカウント全体から一覧表示されるため、ほかに貼り付けるものはありません。

3

ターミナルを選択する

  1. ドロップダウンから既定のターミナルを選びます。一覧は選択したMollie環境から取得されます。Mollieでは再有効化ができないため、無効なターミナルは表示されません。
  2. (任意) 有効なターミナルを、実際に使用しているデバイスだけに制限します。保存済みの既定のターミナルは、ここで選択されていなくても引き続き利用できます。すべての有効なターミナルを許可する場合は、この設定を空のままにします。ターミナルを使わなくする場合は、既定のターミナルも変更するか空にしてください。
  3. (任意) ターミナル選択をロックを有効にすると、キャッシャーはチェックアウト時にターミナルを変更できなくなります。常に既定のターミナルが使用され、これはサーバー側でも強制されます。
  4. 保存します
4

WCPOSで有効にする

  1. WP管理 > POS > 設定 > チェックアウトに移動します
  2. Mollieターミナルゲートウェイを見つけ、POSで有効にします
  3. 設定を保存します
ノート

WooCommerceの設定画面にある有効化／無効化のチェックボックスは、オンラインストアのチェックアウトのみを制御します。WCPOSは、このチェックボックスの状態にかかわらず、設定が済んでいればこのゲートウェイを使用します。

設定リファレンス​

設定内容
有効化／無効化オンラインストアのチェックアウトでゲートウェイを有効にします（POSには不要です）
タイトル / 説明チェックアウト時にお客様に表示されるラベルとテキスト
モードTest または Live。ターミナル決済には Live が必要です。テストAPIキーでターミナルを動かすことはできません
APIキーのソース下で入力したキーを使うか、公式のMollie Payments for WooCommerceプラグインの対応するテスト／ライブキーを再利用します。共有キーが利用できない場合は、下のキーにフォールバックします
Mollie APIキー選択したモードのテストまたはライブAPIキー。APIキーのソースがここで入力したキーに設定されている場合に使用され、共有キーがない場合のフォールバックにもなります
既定のターミナルチェックアウト時に既定で使用されるターミナル。選択したMollie環境の有効なターミナルのドロップダウンから選びます
有効なターミナルチェックアウトの一覧を、選択したターミナルに制限します。空＝すべての有効なターミナル。保存済みの既定のターミナルは常に利用できるため、ターミナルを使わなくする際はそちらも変更するか空にしてください
ターミナル選択をロックチェックアウト時に既定のターミナルを強制し、キャッシャーが変更できないようにします（既定のターミナルの設定が必要です）
チェックアウトのデバッグログチェックアウトの支払いパネルに、ログを表示、コピー、消去のツールを表示します。サポート向けにログを収集する場合を除き、オフのままにしてください。支払いの動作は常に WooCommerce > ステータス > ログ に記録されます

WebhookのURLは支払いのたびに自動的に適用されるため、入力するWebhookの項目はなく、Mollieのダッシュボードでの設定も不要です。

使用方法​

支払いの処理​

  1. アイテムを追加: POSでカートに商品を追加します
  2. ゲートウェイを選択: 支払い方法として「Mollieターミナル」を選択します
  3. ターミナルを選択: ドロップダウンからターミナルを選びます（既定では設定済みのものが選ばれます。ターミナル選択がロックされている場合は非表示になります）
  4. 支払いを開始: ターミナル支払いを開始をクリックすると、Mollieがデバイスへ支払いを送信します
  5. お客様の支払い: お客様がターミナルでカードをタップ、挿入、またはスワイプします。ステータスはリアルタイムで更新されます — Sending to terminal… → Waiting for terminal…
  6. 自動完了: ターミナルが確定すると、注文が支払い済みとしてマークされ、POSは自動的に領収書へ遷移します

支払いコントロール​

  • ターミナル支払いを開始: 選択したターミナルへ新しい支払いリクエストを送信します
  • 支払いをキャンセル: まだ開いている支払いをキャンセルします。支払いがターミナルに到達した後は、Mollieはキャンセル不可と報告するため、キャッシャーはデバイス上でキャンセルします

注文管理​

  • 確認済みの完了: Webhook、ポーリング、キャンセル、再試行のいずれも、注文を変更する前にMollieの正となる状態を取得します。そのため、注文が支払い済みとしてマークされるのは、Mollie側の状態が確定している場合のみです
  • 支払いの追跡: 支払いの試行は、注文に追記のみの履歴として記録されます
  • 領収書の生成: 支払いが成功すると、標準のPOS領収書が生成されます

返金​

返金に対応しています。通常のWooCommerceの注文画面から返金すると、その返金がMollieへ送信されます。Mollieが正であるため、返金の再試行では、別の返金を作成する前にMollieの返金IDとメタデータと突き合わせます。そのため、誤って二重に返金されることはありません。

未完了の支払いのクリーンアップ​

チェックアウトが中断されると、Mollieの pointofsale 決済がMollie側で「開いた」ままになることがあります。プラグインは次の場合に、これらの開いたままの支払いを自動的にキャンセルします。

  • 自動ポーリングがタイムアウトしたとき（既定では5分）。支払いを放置せずにキャンセルが送信されます
  • 別の支払い方法で注文が完了したとき（たとえばお客様が現金で支払った場合）、またはWooCommerceで注文がキャンセルされたとき
  • 支払いの途中でチェックアウトページが閉じられたとき。タブを離れる際にベストエフォートでキャンセルが送信されます
  • WP-Cronのスイープが10分ごとに実行され、未完了のしきい値（既定では10分）を過ぎて開いたままの支払いをキャンセルまたは解決するとき。ほかのクリーンアップ経路が実行される前にブラウザーが閉じられたり、ネットワークが切断されたりした場合も含みます

支払いがすでにターミナルに到達している場合、Mollieはキャンセル不可と報告するため、キャッシャーはデバイス上でキャンセルします。その場合、これらのクリーンアップは何もしない安全な処理になります。

要件​

Mollieアカウント: ライブAPIキーを持つ有効なMollieアカウント
互換性のあるハードウェア: そのMollieアカウントで有効になっているMollie Terminalデバイス
通貨: EUR — POSのターミナル決済は現時点ではEURに限定されています
WCPOS: POSチェックアウトにはProバージョンが必要です
安定した接続: API通信のための信頼できるインターネット接続

対応範囲と制限​

テストモードの制限

Mollieのターミナルはライブアカウントにのみ存在します。MollieのテストAPIキーでは、物理（またはiOS／Android）のターミナルを動かせないため、テストモードでターミナル決済をエンドツーエンドで試すことはできません。これはプラグインの制限ではなく、Mollieプラットフォーム側の制限です。テストモードが選択されていると、設定画面に警告が表示されます。ターミナル決済を受け付けるには、ライブAPIキーとともに Live モードを使用してください。

通貨

POSのターミナル決済は、Mollie Terminalのより広い通貨対応が確認されるまで、EUR に限定されています。

トラブルシューティング​

よくある問題​

ドロップダウンにターミナルが表示されない
  • モードが Live に設定され、実際に使われるAPIキーがライブキーであることを確認してください。テストアカウントにターミナルは存在しません
  • ターミナルがMollieアカウントに登録され、有効になっているか確認してください。Mollieでは再有効化ができないため、無効なターミナルは表示されません
  • サイトからMollieに到達できることを確認してください。一覧はAPI経由でリアルタイムに取得されます
支払いが開始できない
  • ターミナルが選択されているか（選択がロックされている場合は既定のターミナルが設定されているか）確認してください
  • ターミナルの電源が入っていて、オンラインで、同じMollieアカウントで有効になっているか確認してください
  • 注文の通貨が EUR であることを確認してください
ターミナルがタイムアウトした、または支払いが開いたままになった
  • プラグインはタイムアウト時（既定では5分）に、開いたままの支払いを自動的にキャンセルしようとします
  • 支払いがすでにターミナルに到達していて自動的にキャンセルできない場合は、デバイス上でキャンセルしてください
  • その後、あらためて支払いを開始するか、別の方法で支払いを受け付けられます
ターミナルで注文が完了したのに、更新が遅い
  • POSは2秒ごとにMollieへポーリングし、支払いが確定すると遷移します。通常はWebhookのほうが先に確定させます
  • Mollieが正であるため、注文はMollieの正となる状態と突き合わせて調整されます。失われることはありません
  • WooCommerce > ステータス > ログ でMollie APIのメッセージを確認してください

サポートを受ける​

技術サポートについて:

スクリーンショット​

スクリーンショットは今後のアップデートで追加され、次の内容を示す予定です:

  • Mollieターミナルの設定画面 — APIキー、既定のターミナル、有効なターミナル
  • WCPOS設定でのゲートウェイの有効化
  • POSチェックアウトでの支払い処理の流れ