Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

24.5. 信用卡网关问题故障排除

作为 3scale API 供应商，使用 stripe 或 Braintree 作为支付网关，您可以使用这些信用卡网关排除某些问题。

Stripe

  • 要将数据与 3scale 上的数据映射，您可以使用名为 metadata.3scale_account_reference 的 stripe 字段，该字段由 3scale-[PROVIDER_ID]-[DEVELOPER_ACCOUNT_ID] 组成。

Braintree

  • 如果您的 Braintree 帐户处于沙盒模式，并且您遇到任何问题，您必须将其更改为生产环境。

  • 对于存储在 3scale Developer Portal 中但不启用 3D Secure(3D)的信用卡，这些是将 3scale 与 Braintree 集成的建议解决方案：

    1. 3scale API 提供程序：遵循 在 3scale 管理门户中配置计费 中列出的步骤。
    2. 3scale API 用户：遵循 在 3scale 开发人员门户中编辑信用卡详情 中列出的步骤。
  • 要将 Braintree 中的数据与 3scale 上的数据映射，您可以使用名为 customer.id 的 Braintree 字段，该字段由 3scale-[PROVIDER_ID]-[DEVELOPER_ACCOUNT_ID]组成。

24.5.1. 弃用的支付网关
复制链接

本节提供有关已弃用的支付网关的常规信息：Adyen、OGone 和 Authorize.net.这里的信息仅适用于现有集成。不支持与这些网关的新集成。

24.5.1.1. Adyen 集成
复制链接

重要

Adyen 集成已被弃用。不支持新的集成。对于 2019 年 8 月 22 日之前的集成，红帽提供支持，但建议迁移到完全支持的支付网关之一：条带和 Braintree.

完成这些步骤后，您将把 Adyen 配置为您的帐户的支付网关。这将允许您的开发人员输入其信用卡详细信息，并且您可以自动通过 Adyen 收取费用以访问您的 API（根据计算的发票）。

设置您的支付网关是关键步骤，可使信用卡收费使用您支付的 API。您可以将多种替代支付网关用于您的 3scale 帐户。这里我们介绍了 Adyen 的步骤。

24.5.1.1.1. 先决条件
复制链接
  • 在开始这些步骤之前，您将需要使用 Adyen 打开帐户。
  • 您需要一个公司 帐户和 其内的 Merchant 帐户（子帐户）。
  • 在使用 Adyen 申请实时帐户之前，必须满足许多要求。您可以 在这里 查看这些要求。
  • 该帐户应当处于生产模式。
24.5.1.1.2. 配置 Adyen 集成
复制链接

在您的 Adyen 帐户中找到相关信息

  1. 首先，登录到您的 Adyen 帐户。然后在 Settings > Users 区域中找到您的凭证，然后从以下视图的下拉菜单中选择 系统 ：
docs 账单公告设置
View larger image
docs 账单公告设置
  1. 单击 Company 帐户（列表顶部的帐户）。然后，您将进入 Company 帐户设置视图：
文档账单 Adyen 查看凭证
View larger image
文档账单 Adyen 查看凭证
  1. 最后，您可以访问 3scale 账单设置所需的 登录名、机密密码、客户端加密公钥、Merchant ID 和库位置。
  2. 若要查看 公钥，您必须单击 Generate Password，并在某一位置复制此密码。
文档账单 Adyen 凭据
View larger image
文档账单 Adyen 凭据

在 3scale 帐户中配置您的支付网关

  1. 在 Audience > Billing > Charging & Gateway 中，选中该框并点 Save 来启用计费。
  2. 您将看到需要设置的所有字段，以创建至您 Adyen 网关的链接。
  3. 您必须从 网关 下拉菜单中选择 Adyen，并保存更改。
docs 账单公告设置
View larger image
docs 账单公告设置

在 Adyen API 响应中启用 别名 附加数据

默认情况下，当将信用卡授权请求从 3scale 发送到 Adyen 时，返回的响应不包括信用卡的唯一标识符。

为确保 3scale 中保存了正确的信用卡引用，并且支付了正确的卡片，需要启用此附加数据。

联系顾问支持，在响应授权请求时启用 别名 附加数据。

测试您的账单工作流

  1. 通过启用 Pre付费模式 在一天左右生成收费，确保加快测试周期。

  2. 然后选择现有测试帐户并创建添加行项费用的发票。

    1. 立即收取帐户。
    2. 此测试方法将产生一些小的成本，但值得放心，在使用您的 API 真正支付开发人员之前，一切都可以正常工作。

支付网关现已设置，但您的用户可能还无法使用该网关，因为它未在 CMS 中进行配置。前往开发人员门户选项卡，在左侧导航窗格中查找名为 Payment Gateway / Show 的模板。

如果没有，请在 "stripe" %} 时以 {%开头的代码块后面添加以下代码片段： 

{% when "adyen12" %}
{% if current_account.has_billing_address? %}
  {% adyen12_form %}
{% else %}
  <p><a href="{{ current_account.edit_adyen12_billing_address_url }}">First add a billing address</a></p>
{% endif %}
Copy to Clipboard Toggle word wrap
注意
  • 对于在 2016 年 5 月 11 日之前创建的帐户，您必须手动添加上面的代码片段。在指定日期后，这将默认包含在模板中。
  • 要将 Adyen 中的数据与 3scale 上的数据进行映射，您可以使用名为 enterprise perReference 的 Adyen 字段，该字段由 3scale-[PROVIDER_ID]-[DEVELOPER_ACCOUNT_ID]组成。

24.5.1.2. Ogone 集成
复制链接

重要

Ogone 集成已弃用。不支持新的集成。对于 2018 年 7 月 27 日之前的集成，红帽提供支持，但建议迁移到完全支持的支付网关之一：条带和 Braintree.

以下是设置 Ogone 网关以便收费使用 API 的步骤。

24.5.1.2.1. 第 1 步：从 Ogone 获取您的 API 密钥
复制链接

您需要在 Ogone 处打开一个帐户。您需要一个高级 Ogone 电子商务帐户 - Horizon 使用 Alias Manager 选项激活。这是一个付费的选项，可以由 Ogone 或 Merchant 通过 后台 > options > 您的选项 激活。

PSPID 用于登录到您的 Ogone 帐户。然后，您可以在 Configuration > Users 下找到 UserID。

账单 Ogone id
View larger image
账单 Ogone id

确保 Ogone 帐户的技术设置处于活动状态。在 Transaction Feedback 页面上，您将找到 SHA-OUT 密码短语。在此页面中，您还应确保这两个设置已标记为如下所示：

账单 Ogone SHA-out
View larger image
账单 Ogone SHA-out

最后，可在日期和原始验证页面中找到 SHA-IN 密码短语：

账单 Ogone SHA-in
View larger image
账单 Ogone SHA-in
24.5.1.2.2. 第 2 步：在 3scale 中配置您的设置
复制链接

您需要告诉 3scale 使用这些 API 密钥。要做到这一点，登录到 3scale 管理门户并前往 Settings > Billing。

账单
View larger image
账单

如果 Charging Enabled 标志未激活，请启用它并单击 Save。

启用计费计费
View larger image
启用计费计费

您应该会在页面底部附近看到一个名为 Gateway 的下拉列表。将它更改为 Ogone。

账单网关
View larger image
账单网关

下拉菜单下的表单应更改为显示两个字段。插入 Ogone API 密钥并点 Save。

Ogone 账单网关
View larger image
Ogone 账单网关

更改支付网关时，您可能会看到一些警告。这是预期的。读取并接受（如果它们显示）。

支付网关现已设置，但您的用户可能还无法使用该网关，因为它未在 CMS 中配置。进入 Developer Portal 页面，再单击左侧导航窗格中名为 Payment Gateway / Show 的模板。

开发人员门户 - Billing
View larger image
开发人员门户 - Billing

如果不存在，请在 {% 前添加以下代码，当 "braintree_blue" %} 时： 

{% when "ogone" %}
  {% if current_account.has_billing_address? %}
    {% if current_account.credit_card_stored? %}
      {% ogone_form "Edit Credit Card Details" %}
    {% else %}
      {% ogone_form "Add Credit Card Details" %}
    {% endif %}
  {% else %}
    <p><a href="{{ current_account.edit_ogone_billing_address_url }}">First add a billing address</a></p>
  {% endif %}
Copy to Clipboard Toggle word wrap

最后，单击保存并发布。您的用户现在应该能够使用 Ogone 网关付费。

24.5.1.2.2.1. 备注
复制链接

要将 Ogone 中的数据与 3scale 上的数据映射，您可以使用名为 alias 的 Ogone 字段，该字段由 3scale-[PROVIDER_ID]-[DEVELOPER_ACCOUNT_ID]组成。

24.5.1.2.2.2. 故障排除
复制链接

如果某些内容无法正常工作，您可以尝试查看以下提示：

  • 本文档包括了与别名管理器配合使用的所有支付方法概述：付款方式处理/流程概述.
  • 在 Ogone 管理控制台中，请参阅技术信息 Transaction 反馈。滚动至 Directlink/Dynamic 参数并选择所有参数。这样，您可以更轻松地对错误进行故障排除（因为发票中将包含错误消息）。
  • 尝试更改您的 ogone 密码并在 3scale 控制台中更新此设置
  • 验证您的用户是否已在 Ogone 帐户中创建，选中了"用于 API 的特定用户（无法访问 admin）"复选框。您还可以为"API 用户"搜索 Ogone 支持常见问题解答以了解详细信息。
  • 确保您在 3scale 中输入"API 用户"的密码，而不是在 Ogone PSPID-account 的密码。
  • 如果您在 Ogone 中使用沙盒模式并遇到任何错误，请将其更改为生产环境。

24.5.1.3. authorize.Net Integration
复制链接

重要

authorize.Net 集成已弃用。不支持新的集成。对于 2018 年 7 月 27 日之前的集成，红帽提供支持，但建议迁移到完全支持的支付网关之一：条带和 Braintree.

将 Authorize.Net 支付网关与红帽 3scale 计费系统集成。

先决条件：

  • 有效的 Authorize.Net 帐户

  • 以下 Authorize.Net 凭证

    • API 登录 ID
    • 事务密钥

配置 3scale API 管理：

  1. 登录您的 3scale 管理门户。
  2. 导航到 Settings Billing 页面。
  3. 在 Basics 部分下，从下拉菜单中选择 Authorize.Net。
  4. 在 Authorize.Net Options 部分下，输入您的 Authorize.Net API 登录 ID 和事务密钥。
  5. 选择" 保存更改 "按钮。
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat