VibeFox DPO for WooCommerce — ヘルプ

要件

WordPress: 6.2 以降。

WooCommerce: 8.0 以降がインストールされ、有効になっている必要があります。WooCommerce がないと本プラグインは有効化を拒否します。

PHP: 8.0 以降。

DPO Pay アカウント: DPO 加盟店アカウントの Company Token と Service Type ID が必要です。これらはアカウント開設時に DPO から発行されます。DPO の担当者または dpogroup.com から取得してください。DPO は、独自の token と service type を持つテストアカウントも提供できます。別のテストサーバーは存在しません。DPO はテストアカウントと本番アカウントに同じ API アドレスを使用し、token によってアカウントが選択されます。

通貨: ストアの通貨は、DPO アカウントが対応している必要があります。例: USD、EUR、ZAR、KES、UGX、TZS、RWF、GHS、NGN、ZMW、XOF、AED。DPO は最大 2 桁の小数まで対応しているため、小数 3 桁の注文合計額（例: KWD 12.345）は支払うことができません。

VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。

インストール

1. WordPress で Plugins > Add New > Upload Plugin に移動し、プラグインの ZIP ファイルを選択して Install Now をクリックします。wcp_dpo_pay フォルダを FTP で /wp-content/plugins/ にアップロードすることもできます。

2. Activate をクリックします。

3. 設定を開きます: WooCommerce > Settings > Payments > DPO Pay > Manage、またはプラグイン一覧ページのプラグイン名の下にある Settings をクリックします。

4. ページ上部のライセンスブロックにVibeFox ライセンスキーを入力し、Activate をクリックします。

5. テストおよび/または本番の Company Token と Service Type を入力します（「設定」を参照）。

6. 設定ページに表示されているプッシュ通知の URL を DPO サポートに送信し、ストアのアカウントに設定するよう依頼します。

7. Enable/Disable を有効にします。テストモードでテスト注文を行い、その後 Test mode のチェックを外して実際の決済を受け付けるようにします。

設定

すべての設定は 1 つのページにあります: WooCommerce > Settings > Payments > DPO Pay。決済方法が有効になっているのに、選択したモードの Company Token または Service Type が空の場合、このページはチェックアウトで決済方法が非表示になる旨を警告し、保存時にも同じエラーが表示されます。テストモードが有効な間、ページには Test mode is on: payments are created with the test account credentials. と表示されます。

一般

Enable/Disable: Enable DPO Pay で決済方法の有効・無効を切り替えます。デフォルト: 無効。

Title: チェックアウト時に購入者が目にする決済方法の名前。デフォルト: DPO Pay。

Description: チェックアウト時に決済方法の下に表示されるテキスト。デフォルト: Pay securely by card or mobile money on the DPO Pay payment page。

API 認証情報

DPO は、ストアの加盟店アカウント用の Company Token と Service Type ID、およびテストアカウント用に別のものを発行します。これらは DPO の担当者または dpogroup.com から取得してください。

Test mode: Use the test account credentials below。有効にすると、新しい決済はテスト用の Company Token と Service Type で作成されます。デフォルト: 有効。本番の認証情報で実際の決済を受け付けるには、チェックを外してください。既存の注文の状態確認は、常に決済の作成時に使用したアカウントを使用します。

Test Company Token: DPO テストアカウントの Company Token。

Test Service Type: DPO テストアカウントの数値の Service Type ID。

Live Company Token: 本番 DPO 加盟店アカウントの Company Token。

Live Service Type: 本番 DPO 加盟店アカウントの数値の Service Type ID。

Service Type は数値である必要があります。その他の値は保存されません。ページにエラーが表示され、以前の値が保持されます。バージョン 1.0 からアップデートする場合、そのバージョンの認証情報もテスト用フィールドにコピーされます。

決済通知

プッシュ通知は、購入者が決済後にブラウザを閉じた場合でも、決済が行われたことをストアに即座に知らせます。このセクションには、プッシュ通知の URL が表示されます。これは https://your-site/wc-api/dpo_pay_notify/ のような形式です。この URL はダッシュボードで設定するものではありません。DPO サポートに、ストアのアカウントでこの URL を設定するよう依頼してください。

DPO のプッシュ通知には署名がないため、その内容は決して信頼されません。本プラグインはこれらを注文の特定にのみ使用し、その後 DPO 自体に決済を確認します。プッシュ URL がなくても、購入者がストアに戻ったときや、リダイレクト後 15 分および決済の時間制限後の自動再チェックによって、注文は確認されます。

注文

Successful payment status: 確認済みの決済成功後の注文状態。この状態は即座に設定され、2 回目の状態変更は行われません。

詳細設定

Logging: Enable logging で、API 呼び出しと通知を WooCommerce > Status > Logs（ソース: wcp_dpo_pay）に記録します。エラーは常に記録されます。トークンはマスクされ、購入者データは記録されません。デフォルト: 無効。

Delete data: Delete all plugin data when the plugin is deleted。アンインストール時に、設定、注文に保存された DPO データ、ログを削除します。無効化だけではデータは削除されません。デフォルト: 無効。

チェックアウト

購入者は決済方法（デフォルトは DPO Pay）を選択して注文します。本プラグインは、注文の通貨で注文合計額の DPO トランザクションを作成し、注文番号とストアのサイト名を説明として設定し、購入者を DPO 決済ページに送ります。購入者の氏名、メールアドレス、電話番号、住所は、このページを事前入力するために渡されます。そこで、購入者はDPO アカウントで有効になっている任意の方法で支払います。決済リンクの有効期限は 5 時間です。

支払い後、購入者はストアに戻ります。注文が支払い済みになるのは、DPO が確認した後だけです。本プラグインは、購入者が戻ってきたとき、プッシュ通知が届いたとき、自動再チェック時に、DPO にトランザクションの結果を問い合わせます。決済が確認されると、購入者は注文受領ページに進みます。

決済が確認されない場合、購入者はチェックアウトまたは Pay for order ページに戻り、次のいずれかのメッセージが表示されます。

購入者が DPO ページで店舗に戻るボタンをクリックすると、注文は WooCommerce の標準的な方法で取り消され、その DPO 決済リンクも DPO 側で取り消されます。

購入者が同じ注文に再度支払う場合、前回の DPO 決済リンクが最初に確認されます。支払われていた場合、注文は再度請求されることなく完了します。まだ処理中の場合、購入者には Your previous payment for this order is still being processed by DPO. Please wait a few minutes before trying again. と表示されます。それ以外の場合、古いリンクは DPO 側で取り消され、新しいリンクが作成されます。

DPO が決済を開始できない場合、購入者には DPO のエラーコードに応じた簡潔なメッセージが表示されます。例えば、DPO Pay がこの注文の通貨に対応していない、または金額が DPO Pay で許可されている上限を超えているといった内容で、他の決済方法を選ぶことができます。

この決済方法は、クラシックチェックアウト、チェックアウトブロック、Pay for order ページで動作します。WooCommerce High-Performance Order Storage（HPOS）に対応しています。

本プラグインは、DPO ページでの一回限りの決済のみに対応しています。WooCommerce からの返金、保存済みカード、定期購入や継続課金、ストアのサイト上のカード入力欄には対応しておらず、承認のみの決済のキャプチャも行いません。

注文

注文状態

Pending payment: 購入者は DPO に送られましたが、まだ支払いを行っていない、または DPO がまだ決済を確認していません。

Processing、Completed、または On hold: 決済が確認されました。状態は Successful payment status に従います。注文メモには、金額、通貨、承認コード、DPO トランザクショントークンの先頭部分が表示されます。トランザクション ID は DPO トランザクショントークンです。

On hold after payment: DPO は決済を確認しましたが、金額または通貨が注文と異なる、決済が承認のみでキャプチャされていない、取引が過払いまたは不足払いである、あるいは注文が既に取り消されていた場合です。注文メモに理由が記載されます。DPO ポータルで取引を確認してください。承認のみの決済は DPO ポータルでキャプチャまたは取り消しを行い、その後注文を更新してください。

Failed: 決済が拒否された、取り消された、または決済の時間制限を過ぎた場合です。購入者は再度支払うことができます。

Cancelled: 購入者が DPO ページから店舗に戻った場合、または管理者による取り消し、あるいは未払い注文に対する WooCommerce のタイムアウトによって注文が取り消された場合です。未払いの DPO 決済リンクは DPO 側で取り消されます。

その後に届く拒否メッセージが、既に支払われた注文を変更することはありません。また、古い決済リンクの結果によって現在の試行が失敗することもありません。DPO が既に支払われている注文に対して 2 回目の決済成功を確認した場合、その注文には二重支払いの可能性についてのメモが付き、DPO ポータルで返金できるようになります。

返金

このバージョンでは WooCommerce からの返金は利用できません。DPO 加盟店ポータルで決済の返金を行い、その後 WooCommerce で注文を返金済みにしてください。

ライセンスキー

本プラグインは、vibefox.net の VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Payments > DPO Pay の上部にあります。License key にキーを貼り付け、Activate をクリックします。このブロックには、ライセンスが有効な期限の日付やストアのドメインなど、ステータスが表示されます。Check now で再度ステータスを確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除できます。Manage licenses and domains in your account のリンクから、vibefox.net アカウントが開きます。

1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、そのドメインのスロットは解放されません。vibefox.net アカウントでスロットを解放してください。

有効なキーがない場合、DPO Pay はチェックアウト時に購入者には表示されません。それでも決済が開始された場合、購入者には This payment method is not available. Please choose another one. と表示されます。ログインしているストア管理者には、依然として決済方法が表示され、(unlicensed — visible to admins only) とマークされます。これにより、キーを購入する前に本プラグインを設定・テストできます。プラグイン一覧ページと WooCommerce の各ページにリマインダーが表示されます。既存の注文には影響しません。既に開始されている決済は、引き続き確認されます。

ライセンスが期限切れになると、本プラグインは動作を続けますが、アップデートとサポートにはライセンスの更新が必要です。ステータスはバックグラウンドで自動的に再確認されます。

トラブルシューティング

チェックアウトに DPO Pay が表示されない: ライセンスが有効であること、Enable/Disable が有効であること、選択したモードの Company Token と Service Type が設定されていること（テストモードではテスト用フィールド、それ以外では本番用フィールド）を確認してください。これらが欠けている場合、設定ページに警告が表示されます。

決済は完了したが、注文が Pending payment のままになっている: おそらくDPO アカウントにプッシュ通知の URL が設定されておらず、購入者が店舗に戻らなかった可能性があります。設定に表示されている URL を設定するよう DPO サポートに依頼してください。注文は、リダイレクトから 15 分後の自動再チェックでも確認されます。Logging を有効にして、WooCommerce > Status > Logs（ソース: wcp_dpo_pay）を確認してください。

プッシュ通知が Unknown transaction と応答する: トランザクショントークンが、この店舗の DPO Pay 注文に属していません。例えば、同じ DPO アカウントの別の店舗からの通知だった場合などです。

プッシュ通知が Verification failed と応答する: 決済を確認するために DPO に接続できませんでした。DPO は通知を再送し、自動再チェックでも注文が確認されます。

Service Type が保存されない: DPO から発行された数値の Service Type ID である必要があります。

購入者に DPO Pay is temporarily unavailable と表示される: DPO がトランザクションの作成を拒否しました。例えば Company Token または Service Type が間違っている、あるいは別のモードのトークンを使用している場合です。DPO の結果コードは WooCommerce > Status > Logs（ソース: wcp_dpo_pay）にあります。

購入者に DPO は小数 2 桁までしか受け付けないと表示される: 注文合計額に小数 3 桁が含まれています。DPO はこのような金額を請求できません。

支払い後に注文が On hold になる: 注文メモを確認してください。支払われた金額または通貨が注文と異なっていた、決済が承認のみだった、取引が過払いまたは不足払いだった、あるいは注文が取り消されていた可能性があります。DPO ポータルで取引を確認してください。

ライセンスブロックにエラーが表示される: ブロック内のメッセージに従ってください。例えば、キーが既に別のドメインで使用されている場合は、vibefox.net アカウントでスロットを解放し、Check now をクリックしてください。サイトのアドレスが変わった場合は、Check now をクリックして新しいドメインでキーを有効化してください。ライセンスサーバーに接続できない場合、本プラグインは最後に確認された状態で動作を続けます。

アンインストール

本プラグインを無効化しても、すべてのデータは保持され、予定されている状態確認が停止するだけです。削除するには、Plugins ページで無効化してから削除してください。本プラグインのライセンスキーとライセンス状態は常に削除されます。設定、注文に保存された DPO データ、予定されている確認、ログは、Delete data が有効になっていた場合にのみ削除されます。そうでない場合、これらは後の再インストールのために保持されます。既存の注文は、決済メモとトランザクション ID を保持します。

DPO Pay はそれぞれの所有者の商標です。本プラグインは DPO Pay と提携しておらず、DPO Pay による推奨も受けていません。