使用 Global Payments 收款
Global Payments 是一家国际支付服务商，兼容 Desjardins（魁北克）。您的用户在 Global Payments 的安全支付页面上使用银行卡付款，该页面同时负责 3-D Secure 身份验证。手续费按您与 Global Payments 签订的合同收取：OpenResa 不从这些付款中收取任何佣金。
前提条件
要接收真实付款，您的组织必须拥有 Global Payments 商户账户，例如通过魁北克的 Desjardins 开通。随后，您的客户经理会向您提供两个专属于您应用的凭证：App ID 和 App Key。
如果想在签约前试用该网关，请在 Global Payments 开发者门户（developer.globalpayments.com）上免费注册账户。门户中会创建一个测试应用，并附带其专属的 App ID 和 App Key。
在账单账户中配置 Global Payments
每个账单账户都有各自的支付网关：您可以只让部分活动使用 Global Payments，其余活动则保留在另一个账户上。
- 前往 管理›设置›计费›计费账户，打开相关的账单账户，然后进入 支付 选项卡。
- 启用 在线支付，并在网关列表中选择 Global Payments。
- 粘贴您的 App ID 和 App Key。App Key 会加密保存，之后不会再完整显示。
- 将 API 地址 保持为
apis.globalpay.com。仅当 Global Payments 明确告知时，才选择apis.eu.globalpay.com。 - 将 账户名称 留空：OpenResa 会自行选择要使用的账户（见下文）。
- 如果您输入的是测试应用的凭证，请勾选 测试环境（沙盒）。
- 点击 保存，然后点击 测试连接。
无需在您的 Global Payments 后台登记任何通知地址：OpenResa 会在每次付款时自动传送其返回地址。表单中的 在线帮助 链接汇总了这些步骤。
如果测试结果提示凭证被拒绝，请先检查测试环境复选框：测试凭证只有在勾选该复选框时才有效，而生产凭证只有在取消勾选时才有效。
选择处理账户
一个 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 Secure 身份验证进行确认。
之后，用户返回 OpenResa，OpenResa 会等待 Global Payments 的确认：付款已确认 消息通常在付款后约十秒显示。与其他网关一样，OpenResa 随后会向用户发送确认信息和发票。
以下是 Global Payments 特有的几条规则：
- 电子邮件地址。 Global Payments 要求提供付款人的电子邮件地址。因此，用户的订单或账户中必须有一个有效的电子邮件地址，且长度不超过 50 个字符。否则，在线支付将被拒绝，并显示消息 在线支付需要有效的电子邮件地址。请检查您的账户。
- 币种。 付款以订单的币种进行，例如魁北克的俱乐部使用加元。该币种必须已在您的 Global Payments 账户中启用：否则，用户会看到服务不可用的消息，并且在多次失败后您会收到提醒。
- 每个页面仅可尝试一次。 银行卡被拒绝后，用户返回 OpenResa 并重新发起付款：系统会创建一个新的支付页面。
Global Payments 的支付页面有效期为 24 小时。如果用户放弃付款，其订单将保持待付款状态，用户可以通过 Global Payments 或您提供的其他支付方式再次支付。
查找付款
在您的 Global Payments 门户中，每笔付款都有一个参考号，由去掉连字符的订单号和付款尝试编号组合而成：例如 BJ2026000123T15349533 对应订单 2026-000123。在 管理›仪表板›计费›发票与交易 中搜索该订单号即可打开订单。
在订单详情中，交易信息显示 Global Payments 的 交易标识符、授权号码 和 参考。账单账户的 事件日志 选项会列出从 Global Payments 收到的回传信息及查询结果，并注明可能的失败原因。在失败的行上，重播 会向 Global Payments 重新查询该付款，如果付款已成功则予以登记。
退款
退款从 管理›仪表板›计费›发票与交易 发起：打开订单，点击 退款，然后选择全额退款或部分退款。使用 Global Payments 磁贴时，OpenResa 会更新订单，并将退款传送给 Global Payments，由其将款项退回付款人的银行卡。
全额退款会撤销已交付的内容（退还点数、撤销订阅），并将订单状态改为已退款。部分退款会保持订单为已支付状态，仅减少已收款金额。Global Payments 不接受超过付款金额的退款。
如果 Global Payments 未确认退款，例如因连接中断，订单仍会被更新，并显示 退款待在 Global Payments 端核实 消息，提醒您在门户中核实退款是否已完成，如未完成请手动处理。
