README

UBC TouchNet uPay与Commerce 2的集成

安装与配置

1. 按照您通常的方法安装此模块。
2. 在 /admin/commerce/config/payment-gateways 添加一个新的支付网关，我们已将网关的机器名称设置为 upay。
3. 建议在 settings.php 中存储许多变量，并且不要将密钥和密钥在数据库中存储。
   1. 如果可能，在网站文档根目录外部的 .env 文件中进一步存储覆盖。

      UPAY_PROXY_API_URI='https://api.ubc.ca/upay/v1'
      UPAY_PROXY_MERCHANT_ID='MRCH'
      UPAY_PROXY_MERCHANT_STORE_ID='01'
      UPAY_PROXY_MERCHANT_PROXY_KEY='YOUR PROXY KEY'
      UPAY_PROXY_MERCHANT_UPDATE_SECRET='YOUR UPDATE SECRET'
      

      settings.php 中的覆盖

      /**
       * TouchNet uPay Proxy Payment Gateway override.
       */
      $config['commerce_payment.commerce_payment_gateway.upay']['configuration']['base_uri'] = getenv('UPAY_PROXY_API_URI');
      $config['commerce_payment.commerce_payment_gateway.upay']['configuration']['merchant_id'] = getenv('UPAY_PROXY_MERCHANT_ID');
      $config['commerce_payment.commerce_payment_gateway.upay']['configuration']['merchant_store_id'] = getenv('UPAY_PROXY_MERCHANT_STORE_ID');
      $config['commerce_payment.commerce_payment_gateway.upay']['configuration']['merchant_proxy_key'] = getenv('UPAY_PROXY_MERCHANT_PROXY_KEY');
      $config['commerce_payment.commerce_payment_gateway.upay']['configuration']['merchant_update_secret'] = getenv('UPAY_PROXY_MERCHANT_UPDATE_SECRET');
      

DPP端点

您将被要求输入端点，商积分将根据 支付网关的机器名称 生成路径。

我们为所有支付网关的机器名称命名为 upay，生成的路径如下所示

• 端点路径: /payment/notify/upay
• 成功链接路径: /payment/success/upay
• 错误链接路径: /payment/error/upay
• 取消链接路径: /payment/cancel/upay

将上述路径附加到您的 预发布 或 生产 环境的基本URI上

示例

预发布端点URL: https://stg-example.ubc.ca/payment/notify/upay

注意事项

• 我们尚未实现（由于需求）更改特定产品、订单或商店的任何WorkDay覆盖方式。
• 所有工作流程中已添加了 refunded 工作流状态和 refund 转变。没有逻辑与该附加转换相关联。
• 我们没有添加任何其他订单状态，如Drupal 7中可用的 pending，我们将保持为 draft 以保持简单。
• remote_id 映射到 uPayTrackingId 的值，目前不存储 paymentGatewayReferenceNumber
• 我们不使用 live 或 test 等模式，因为使用 settings.php 中的环境变量设置更容易且更简单。
• 成功、错误 和 取消 URL 仅用于展示，您可以替换消息或提供自定义页面。

如果您需要上述任何内容，请随时 提出请求。