VibeFox PayU LATAM for WooCommerce — ヘルプ

要件

WordPress: 5.8 以降。

WooCommerce: 7.0 以降がインストールされ、有効であること。WooCommerce がなければプラグインは有効化できません。後で WooCommerce を無効にした場合、プラグインは動作せず、管理画面に通知を表示します。

PHP: 8.0 以降。

Currency: 注文は ARS、BRL、CLP、COP、MXN、PEN、USD のいずれかである必要があります。これらは PayU Latam がアルゼンチン、ブラジル、チリ、コロンビア、メキシコ、パナマ、ペルーで処理する通貨です。その他の通貨では、チェックアウトで決済方法が非表示になります。

PayU Latam account: 貴店の PayU 加盟店情報の三つの値が必要です。加盟店 ID、販売する国のアカウント ID、API キーです。PayU モジュール（PayU 加盟店パネル）の Settings > Technical configuration（加盟店 ID、API キー）と Accounts（アカウント ID）にあります。PayU は開発者ドキュメントの "Test your solution" ページで、公開サンドボックス認証情報とテストカードを提供しています。決済は PayU がホストするページで行われるため、API Login やその他の API 認証情報は不要です。

Internet access to your site: PayU は自社サーバーから貴店に決済結果を送信するため、サイトはインターネットからアクセス可能である必要があります（ローカルサイト、パスワード保護、メンテナンスページで遮断されたサイトは使用できません）。

VibeFox license key: vibefox.net で購入します。一つのキーは一つのドメインで使用できます。

インストール

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

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

3. 設定を開きます：WooCommerce > Settings > Payments > PayU LATAM > Manage。またはプラグイン一覧でプラグイン名の下の Settings をクリックします。

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

5. サンドボックスと本番の認証情報を入力します（「設定」を参照）。PayU で確認 URL を設定する必要はありません。

6. Enable/Disable をオンにして保存します。テスト決済が完了するまでは Sandbox をオンにし、その後チェックを外して本番認証情報で実際の決済を受け付けます。

設定

すべての設定は同じページにあります：WooCommerce > Settings > Payments > PayU LATAM。サンドボックスモードがオンのとき（Sandbox mode. 決済は PayU サンドボックスに送信され、実際の料金は請求されません。）、現在の環境の加盟店 ID、アカウント ID、API キーが不足しているとき、PayU LATAM がストア通貨を処理しないとき、フィールドの上に警告が表示されます。後二つの場合、チェックアウトに PayU LATAM は表示されません。決済方法一覧では、現在の環境の三つの認証情報が入力されるまで、PayU LATAM は設定が必要と示されます。認証情報の先頭と末尾の空白は無視されます。

一般

Enable/Disable: Enable PayU LATAM で決済方法をオンまたはオフにします。初期値：off。

Title: チェックアウトで購入者に表示する決済方法のタイトルです。初期値：PayU LATAM。

Description: チェックアウトで購入者に表示する決済方法の説明です。初期値：Pay with a card, cash or bank transfer on the secure PayU page. You will be redirected to PayU to complete your payment.

環境

Sandbox: Enable the PayU sandbox (test mode)。決済は以下のサンドボックス認証情報で PayU サンドボックスに送信され、実際の料金は請求されません。無効にすると、本番認証情報と PayU の本番チェックアウトが使用されます。初期値：on。

本番認証情報

PayU モジュールの Settings > Technical configuration（加盟店 ID、API キー）と Accounts（販売する国のアカウント ID）で確認します。このセクションには PayU 加盟店パネルへのリンクがあります。

Merchant ID: 貴店の PayU 加盟店の数値識別子です。

Account ID: PayU アカウントの識別子です。国ごとに一つのアカウントがあります。

API Key: 決済への署名と PayU 通知の検証に使用する秘密キーです。

サンドボックス認証情報

PayU はサンドボックス用に公開テスト認証情報とテストカードを提供しています。このセクションには PayU ドキュメントの "Test your solution" ページへのリンクがあります。

Sandbox merchant ID: PayU サンドボックスの加盟店 ID です。

Sandbox account ID: PayU サンドボックスのアカウント ID です。

Sandbox API key: PayU サンドボックスの API キーです。

各決済試行は使用した環境を記憶します。サンドボックス決済の確認はサンドボックスの API キーと加盟店 ID で、本番決済の確認は本番の値で検証されるため、切り替え後も保留中の決済は正常に処理されます。認証情報が一組だったバージョン 1.0 から更新する際、サンドボックスがオンだった場合は古い値がサンドボックスのフィールドにコピーされます。更新後に設定を確認してください。

確認 URL

このセクションには PayU が各決済結果を報告する URL が表示されます。形式は https://your-site/wc-api/payu_lp/ のようになります。プラグインが決済ごとに PayU に送信するため、PayU 側での設定は不要です。ページはインターネットからアクセス可能である必要があります。PayU は貴店の API キーで確認に署名します。有効な署名がない確認、加盟店 ID が異なる確認、貴店がその注文に発行していない決済参照番号の確認は拒否されます。プラグインは以下の PayU 取引状態を処理します。

その他の状態は注文メモに追加されるだけです。確認がなければ注文が支払い済みになることはなく、支払い待ちのままです。

詳細

Debug log: Log payment requests and PayU notifications は、キーや個人情報を含めずに WooCommerce > Status > Logs のソース wcp_payu_latam_payment に詳細を記録します。エラーと拒否された通知は常に記録されます。初期値：off。

Delete data: Delete the settings and logs when the plugin is deleted。プラグインの無効化で何かが削除されることはありません。注文に保存された PayU データは保持されます。初期値：off。

チェックアウト

購入者は決済方法（初期設定では PayU LATAM）を選び、注文します。サンドボックスモードのチェックアウトブロックでは Sandbox mode: no real payment is made. が表示されます。注文は支払い待ちのままで、購入者は Thank you for your order. You are being redirected to PayU LATAM to complete the payment… と表示される貴店の決済ページに移動します。このページは署名付きフォームを PayU WebCheckout ページに自動送信します。自動送信されない場合は Pay with PayU LATAM をクリックするか、Cancel order で注文をキャンセルします。

フォームには、注文合計と通貨、注文の税額と課税標準額（非課税注文では両方とも 0 とし、PayU が既定の VAT を追加しないようにします）、注文番号とストア名を伴う Order # の説明、購入者のメールアドレス、氏名、電話番号、請求先住所が含まれます。PayU ページはストアの言語に応じてスペイン語、ポルトガル語、英語で開きます。購入者は PayU ページで、貴店の PayU アカウントで有効な決済方法で支払います。

決済ページを訪れるたびに、固有の参照番号（注文番号とタイムスタンプ）を持つ新しい決済試行が開始されます。注文の直近 30 回の試行を記憶するため、古い PayU タブで支払っても決済は受け付けられます。

注文が支払い済みになるのは、PayU が署名付き確認で決済を確認した後だけです。購入者が PayU から戻っただけでは支払い済みになりません。戻ったときの動作は以下のとおりです。

現在の環境の認証情報が不足している場合は PayU LATAM is not available right now. Please choose another payment method. が表示されます。注文通貨が未対応の場合は PayU LATAM does not accept payments in に続いて通貨が表示されます。支払い済み注文が再度支払われることはなく、決済ページには This order has already been paid. と表示されます。

この決済方法はクラシックチェックアウト、チェックアウトブロック、Pay for order ページで動作します。WooCommerce High-Performance Order Storage（HPOS）と互換性があります。

本プラグインには、ストア内の決済フォーム、WooCommerce からの返金、保存済みカード、サブスクリプション、分割払いの設定はありません（分割払いは PayU のページに表示されます）。決済状況を PayU API に問い合わせることはなく、署名付き確認だけが注文を更新します。

注文

注文ステータス

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

Processing: PayU が決済を確認し、金額と通貨が一致しています。注文メモには PayU 取引、金額、決済方法、サンドボックス決済の場合は [sandbox] が表示されます。注文の取引 ID は PayU の取引 ID です。仮想のダウンロード可能な商品のみの注文は、WooCommerce の初期設定どおり完了になります。

On hold: PayU が決済を待機中と報告した場合（現金または銀行決済）、支払額や通貨が注文合計と一致しない場合、キャンセルされた注文の決済が承認された場合です。注文メモに理由が表示されます。PayU モジュールで決済を確認してから、注文の処理、復元、または返金を行ってください。

Failed: 最新の決済試行が拒否、期限切れ、またはエラーになりました。メモに PayU のメッセージが表示されます。購入者は再度支払えます。古い試行の拒否や、すでに承認済み決済のある注文への拒否は、メモに追加されるだけです。

各通知は注文ごとのロックの下で一度だけ処理されます。PayU の重複通知でメモ、在庫減少、メール送信が重複することはありません。別のリクエストによる注文更新が長引く場合は、確認にエラーを返し、PayU が後で再送します。支払い済み、完了、返金済みの注文が再開されることはありません。支払い済み注文に別の承認済み決済が届いた場合はメモで通知されます。購入者が二重に支払った場合、PayU モジュールで重複分を返金してください。

返金

WooCommerce からは返金しません。PayU モジュールで取引を返金し、必要に応じて WooCommerce に手動で返金を記録してください。

ライセンスキー

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

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

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

ライセンスが失効してもプラグインは動作し続けますが、更新とサポートには更新契約が必要です。状態はバックグラウンドで自動的に再確認されます。

トラブルシューティング

チェックアウトに PayU LATAM が表示されない：ライセンスが有効で、Enable/Disable がオン、現在の環境の加盟店 ID、アカウント ID、API キーが入力済みであることを確認してください。Sandbox がオンならサンドボックス、オフなら本番の認証情報です。ストア通貨（注文の支払いページでは注文通貨）が ARS、BRL、CLP、COP、MXN、PEN、USD のいずれかであることを確認してください。設定ページには各問題の警告が表示されます。

決済は成功したが注文が Pending payment のまま：PayU の確認が貴店に届かなかったか、拒否されました。設定に表示される確認 URL がインターネットからアクセス可能か確認してください（ローカルサイト、メンテナンスモード、ファイアウォール、パスワード保護による遮断がないこと）。拒否された確認は WooCommerce > Status > Logs のソース wcp_payu_latam_payment で確認できます。エラー応答があれば、PayU は確認を再送します。

確認への応答が Invalid signature：決済環境の API キーで署名されていません。本番決済は API Key、サンドボックス決済は Sandbox API key を確認してください。

確認への応答が Merchant mismatch：確認の加盟店 ID が決済環境の Merchant ID または Sandbox merchant ID と異なります。決済を処理する PayU アカウントの加盟店 ID を入力してください。

確認への応答が Gateway not configured：決済環境の API キーまたは加盟店 ID が不足しています。サンドボックス決済の待機中にサンドボックス認証情報を削除した場合などです。再入力すれば PayU が確認を再試行します。

確認への応答が Busy, retry later：別のリクエストが同時に注文を更新していました。変更は行われず、PayU が確認を再送します。

確認への応答が Unknown reference：決済参照番号がこのストアの PayU LATAM 注文に属していません。注文の決済方法が変更された場合や、注文が削除された場合などです。

注文が On hold：注文メモを読んでください。PayU で決済がまだ待機中（現金または銀行決済）、支払額や通貨が注文と異なる、または注文キャンセル後に決済が届いた場合です。PayU モジュールで取引を確認してください。

その他の通貨やフォームフィールド：開発者は payu_lp_supported_currencies フィルターで通貨一覧、payu_lp_icon フィルターでチェックアウトのアイコン、payu_lp_payment_fields フィルターで WebCheckout のフォームフィールドを変更できます。

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

アンインストール

プラグインを無効化してもすべてのデータが保持されます。削除するには Plugins ページで無効化して削除します。このプラグインのライセンスキーとライセンス状態は常に削除されます。ゲートウェイ設定とログは Delete data がオンだった場合にのみ削除されます。それ以外は後日の再インストールに備えて保持されます。既存の注文は決済メモ、PayU 参照番号、取引 ID を保持します。

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