Global Payments で決済を受け付ける

Global Payments は国際的な決済代行会社で、Desjardins（ケベック州）に対応しています。利用者は、Global Payments の安全な決済ページでクレジットカードで支払います。このページでは 3-D セキュア認証も行われます。手数料は Global Payments との契約に基づくもので、OpenResa はこれらの支払いに手数料を一切課しません。

前提条件

実際の支払いを受け付けるには、組織が Global Payments の加盟店アカウントを持っている必要があります。ケベック州では、たとえば Desjardins を通じて開設できます。開設後、担当者からアプリケーション専用の識別情報が 2 つ提供されます。App ID と App Key です。

契約前にゲートウェイを試すには、Global Payments の開発者ポータル（developer.globalpayments.com）で無料アカウントを作成してください。テスト用アプリケーションが作成され、専用の App ID と App Key が発行されます。

請求アカウントで Global Payments を設定する

請求アカウントごとに独自の決済ゲートウェイを設定できます。一部のアクティビティだけに Global Payments を使用し、それ以外のアクティビティは別のアカウントで管理することも可能です。

1. 管理›設定›請求›請求アカウント に移動し、対象の請求アカウントを開いて、支払い タブを表示します。
2. オンライン支払い を有効にし、ゲートウェイの一覧から Global Payments を選択します。
3. App ID と App Key を貼り付けます。App Key は暗号化して保存され、全体が再表示されることはありません。
4. APIアドレス は apis.globalpay.com のままにしてください。Global Payments から指示された場合にのみ、apis.eu.globalpay.com を選択します。
5. アカウント名 は空欄のままにしてください。使用するアカウントは OpenResa が自動で選択します（下記参照）。
6. テスト用アプリケーションの識別情報を入力する場合は、テスト環境（サンドボックス） にチェックを入れます。
7. 保存 をクリックし、続いて 接続をテストする をクリックします。

Global Payments の管理画面で通知先アドレスを登録する必要はありません。OpenResa が支払いのたびに戻り先アドレスを自動で送信します。フォーム内の オンラインヘルプ リンクから、これらの手順を確認できます。

テストで識別情報が拒否されたと表示された場合は、まずテスト環境のチェックボックスを確認してください。テスト用の識別情報はチェックを入れた状態でのみ、本番用の識別情報はチェックを外した状態でのみ機能します。

処理アカウントを選択する

1 つの Global Payments アプリケーションには、複数の決済処理アカウントを含めることができます。アカウント名 が空欄の場合、OpenResa は利用可能な唯一のアカウントを選択します。複数ある場合は、決済ページ専用の唯一のアカウント（名前が _hpp で終わるもの）を選択します。接続テストでは、選択されたアカウントが表示されます（例：Global Payments との接続に成功しました — 処理用アカウントが自動的に選択されました：transaction_processing_hpp）。

OpenResa が自動で選択できない場合は、テストのメッセージに利用可能なアカウントが一覧表示されます。Global Payments から指定されたアカウント名を アカウント名 に入力して保存し、テストを再実行してください。

テスト環境で試す

テスト用アプリケーションの識別情報を使用し、テスト環境（サンドボックス） にチェックを入れた状態では、支払いは架空のものになります。カードに請求されることはなく、支払い済みの注文には会計上の効力を持たない SPECIMEN シリーズの請求書が発行されます。

テスト決済を行うには、Visa のテストカード 4263970000005262、有効期限 05/39、セキュリティコード 599 で注文を支払ってください。支払いが承認されます。その他のテストカードについては、Global Payments のドキュメントをご覧ください。

本番環境に切り替えるには、App ID と App Key を本番用の識別情報に置き換えます。次にチェックを外して保存し、接続テストを再実行してください。

利用者側の支払いの流れ

支払いの際、利用者は オンライン支払い（Global Payments経由 という表示付き）を選択し、Global Payments の決済ページにリダイレクトされます。決済ページは利用者の言語に応じて、フランス語または英語で表示されます。利用者はカード情報を入力し、銀行から求められた場合は 3-D セキュア認証で確認します。

その後、利用者は OpenResa に戻り、OpenResa が Global Payments からの確認を待ちます。通常、支払いから 10 秒ほどで 支払いが確認されました というメッセージが表示されます。他のゲートウェイと同様に、OpenResa から利用者に確認メールと請求書が送信されます。

Global Payments には、以下の固有のルールが適用されます。

• メールアドレス。 Global Payments では支払者のメールアドレスが必須です。そのため、利用者は注文またはアカウントに、50 文字以内の有効なアドレスを登録している必要があります。登録がない場合、オンライン決済は拒否され、オンラインで支払うには有効なメールアドレスが必要です。アカウントをご確認ください。 というメッセージが表示されます。
• 通貨。 支払いは注文の通貨で行われます。たとえばケベック州のクラブではカナダドルになります。この通貨は Global Payments のアカウントで有効になっている必要があります。有効でない場合、利用者には利用不可のメッセージが表示され、複数回の失敗の後に管理者に通知が届きます。
• 1 ページにつき 1 回の試行。 カードが拒否された場合、利用者は OpenResa に戻って支払いをやり直します。新しい決済ページが作成されます。

Global Payments の決済ページは 24 時間有効です。利用者が途中で離脱した場合、注文は支払い待ちのままとなり、Global Payments またはクラブが提供する別の支払い方法で再度支払うことができます。

支払いを確認する

Global Payments のポータルでは、各支払いに参照番号が付いています。この参照番号は、ハイフンを除いた注文番号と支払い試行の番号を組み合わせたものです。たとえば BJ2026000123T15349533 は注文 2026-000123 に対応します。この注文番号を 管理›ダッシュボード›請求›請求書と取引 で検索すると、注文を開けます。

注文の詳細では、取引に Global Payments の トランザクションID、認証番号、参照 が表示されます。請求アカウントの イベントログ オプションでは、Global Payments から受信した応答と照会結果が一覧表示され、失敗した場合はその理由も確認できます。失敗した行では、リプレイ で Global Payments に支払いを再照会し、支払いが完了していれば記録されます。

支払いを返金する

返金は 管理›ダッシュボード›請求›請求書と取引 から行います。注文を開き、払い戻す をクリックして、全額返金または一部返金を選択します。Global Payments のタイルを選択すると、OpenResa が注文を更新し、Global Payments に返金を送信します。Global Payments は支払者のカードに返金します。

全額返金では提供済みの項目が取り消され（クレジットの返還、サブスクリプションの取り消し）、注文は返金済みになります。一部返金では注文は支払い済みのままとなり、受領金額のみが減額されます。Global Payments では、支払い金額を超える返金はできません。

接続の切断などにより Global Payments が返金を確認しなかった場合でも、注文は更新されます。その際、Global Payments側で返金の確認が必要 というメッセージが表示されます。ポータルで返金が正しく行われたかを確認し、行われていなければ返金してください。

関連情報