Cyber​​Source 统一结账

这是给谁看的？

任何已拥有运行托管结账功能的 Cyber​​Source 生产账户，并希望迁移到统一结账的商家，无需创建新的 Cyber​​Source 账户：此操作仅在现有生产商家 ID (MID) 上启用一项新服务，并将OpenApply的配置切换到该服务。

⚠️ 在OpenApply中，Cyber​​Source 模式（ Hosted Checkout与Unified Checkout ）是按学校单独设置的，而非按用户或会话设置。一旦切换，该学校的所有家长都将开始使用统一结账。由于没有逐步推广或仅限教职工预览，请提前做好规划。

检查清单

1. 提交 MID 配置请求，以在生产 MID 上启用统一结账、付款人身份验证 (3DS) 和决策管理器。
2. 服务获批后，生成新的 REST API 密钥。
3. 在流量较低的时段：备份托管结账凭据，然后使用新密钥和“决策管理器”复选框将OpenApply切换到统一结账。
4. 设置统一结账 Webhook
5. 使用一笔真实交易进行验证，然后保留切换或回滚。

步骤 1：激活服务（服务启用）

在商务中心，打开“支持”→“支持中心” ：

这将打开签证受理解决方案支持中心。转到支持案例 → MID 配置请求：

提交表单，仅勾选“服务启用”选项，并提出以下请求：

• 统一结账（REST API）
• 付款人认证（3DS）
• 决策管理器（如果需要进行欺诈筛查）

在“环境”下，仅勾选“生产环境”。保持“私有环境”勾选状态。

如有任何关于 Cyber​​Source 的具体问题，请直接联系 Cyber​​Source 支持团队。

Cyber​​Source 会在内部处理此项（根据其公开文档，通常在 3 个工作日内）。在获得批准之前，本操作手册中的其他任何步骤都无法继续，因为步骤 2 中创建的 REST 密钥和步骤 3 中的“决策管理器”复选框都依赖于商户账户上已启用这些服务。

步骤 2：生成并保存新的 REST API 密钥

⚠️统一结账密钥与托管结账密钥不同，即使它们属于同一商户/账户。托管结账使用安全受理访问密钥 + 私钥；统一结账使用单独的 REST API 密钥（密钥 ID + 共享私钥）。它们位于商务中心的不同位置，不可互换。

服务启用后，请转到“商务中心”→“支付配置”→“密钥管理” ：

点击+ 生成密钥：

选择密钥类型REST - 共享密钥，这是 Unified Checkout 使用的 REST API 的推荐类型：

忽略下方的旧版 SCMP / SOAP 工具包选项（Cyber​​Source 已将其标记为已停止使用），然后单击“生成密钥” ：

确认生成结果：

请立即复制（或下载）密钥和共享密钥，因为 Cyber​​Source 只会显示一次共享密钥：

步骤 3：备份托管结账，然后将OpenApply切换到统一结账

⚠️ 此步骤会立即将学校所有家长引导至统一结账模式：模式设置由全校共享（请参阅顶部警告），因此无法在不切换到统一结账模式的情况下对其进行测试。建议您在流量较低的时段一次性完成此步骤至步骤 5。

在进行任何更改之前，请打开OpenApply管理后台中的学校付款设置，并将当前的托管结账配置（商户 ID、配置文件 ID、访问密钥、密钥）记录在安全的地方，以防以后需要回滚：

然后将模式切换到统一结账，并填写新值：

• 商户 ID ：与之前相同；商户账户不变。
• 访问密钥/密钥：在步骤 2 中生成的密钥 ID 和共享密钥（请勿重复使用托管结账访问密钥/密钥；请参阅步骤 2 中的警告）
• 请注意，在此模式下， “个人资料 ID”字段将消失：它仅用于托管结账，统一结账功能不会使用它。
• 环境：选择实时环境
• 现在使用 Decision Manager 检查屏幕交易（如果已包含在步骤 1 请求中并获得批准）（在步骤 4 之前执行此操作：webhook 订阅是根据此复选框在设置时显示的内容构建的）。

步骤 4：设置 webhook

请先保存步骤 3 中的统一结账配置。保存后，再返回相同的设置界面（参见上方截图中的“统一结账 Webhook”部分），然后点击“自动设置 Webhook” 。此操作将生成并注册加密的 Webhook 凭据，运行运行状况检查，并创建订阅。无需在 Business Center 中执行任何手动步骤。

步骤 5：使用一笔真实交易进行验证，然后保留切换或回滚。

1. 确认新的 REST 密钥已保存，并且生产环境 MID 的 Decision Manager / 3DS / webhook 订阅均已激活。
2. 运行一笔小规模的真实交易并确认：授权成功，且OpenApply中的费用/发票状态已正确更新。
3. 如果一切正常，切换操作将保持不变：无需采取任何进一步行动，家长现在可以通过统一支付系统付款。如果发现任何问题，请立即回滚。

回滚：将模式切换回托管结账，并恢复步骤 3 中备份的凭据。这将立即把学校里的所有家长都恢复到托管结账模式。