标题页 CyberSource Secure Acceptance Web/Mobile 配置指南 2018 年 4 月 CyberSource Corporation HQ | P.O.Box 8999 | San Francisco, CA 94128-8999 | 电话：800-530-9095 CyberSource 联系信息 有关我们的公司、产品和服务的一般信息，请访问 http://www.cybersource.com。 有关 CyberSource 服务的销售问题，请向 [email protected] 发送电子邮件或拨打 650-432-7350 或 888-330-2300（美国境内免费）。 有关任何 CyberSource 服务的支持信息，请访问支持中心： http://www.cybersource.com/support 版权 © 2018 CyberSource Corporation。保留所有权利。CyberSource Corporation（简称“CyberSource”）根据此 文档的读者（简称“您”）与 CyberSource 之间的适用协议（简称“协议”）提供此文档和此文档中所述的软 件。您必须遵守协议中的条款来使用本文档和/或软件。除非协议有明确规定，否则本文档中包含的信息会在不事 先通知的情况下发生更改，因此本文档中的信息在任何情况下均不应视为 CyberSource 作出的保证或担保。 CyberSource 对本文档中可能出现的任何错误不承担任何责任。您必须严格遵照本协议来使用随本文档一起提供 的受版权保护的软件。您在使用软件之前应认真阅读协议。除非协议允许，否则在未获得 CyberSource 事先书面 同意的情况下，您不得复制本文档的任何内容、将本文档存储在检索系统中，或者以任何形式或任何方法（电子、 机械、录制或其他方式）传输此文档。 受限权利标识 对于政府或国防部门。政府或国防部门的使用、复制或披露行为必须遵守 DFARS 252.227-7013“技术数据和计 算机软件中的权利”条款以及 FAR 和 NASA FAR 补充条款中类似条款的限制。 对于民间机构。使用、复制或披露必须遵守 52.227-19“商用计算机软件受限权利”条款 (a) 到 (d) 项规定的限制， 以及 CyberSource Corporation 关于此软件的标准商业协议中规定的限制。根据美国版权法的规定保留未公布的 权利。 商标 Authorize.Net、eCheck.Net 和 The Power of Payment 是 CyberSource Corporation 的注册商标。 CyberSource、CyberSource Payment Manager、CyberSource Risk Manager、CyberSource Decision Manager 和 CyberSource Connect 是 CyberSource Corporation 的商标和/或服务标志。 所有其他品牌和产品名称都是其各自所有者的商标或注册商标。 2 录 目 目录 本文档的近期修订 6 关于本指南 7 受众及用途 7 网站要求 7 约定 8 备注、重要说明和警告声明 8 文本和命令约定 8 相关文档 9 客户支持 10 章节 1 使用 Secure Acceptance Web/Mobile 11 Secure Acceptance Profile 12 Secure Acceptance 交易流程 12 支付令牌 13 一键式结账 14 订阅支付 14 II 级和 III 级数据 15 通过 Secure Acceptance 激活 15 章节 2 创建 Web/Mobile Profile 16 配置支付方式 17 添加卡类型 17 启用 3DS 验证 18 添加货币 19 启用自动授权撤销 19 启用电子支票 20 启用 Visa Checkout 21 启用 PayPal Express Checkout 22 启用服务费 23 创建安全密钥 24 Secure Acceptance Web/Mobile | 2018 年 4 月 3 目录 结账配置 25 配置结账流程 25 显示税额 26 显示账单信息字段 26 显示送货信息字段 27 显示电子支票信息字段 28 自定义订单审核详细信息 29 接收商户通知 30 发送客户收据 31 客户通知详细信息 31 公司徽标 32 自定义电子邮件收据 32 显示响应页面 33 交易响应页面 33 CyberSource 托管的响应页面 33 自定义托管响应页面 34 取消响应页面 34 CyberSource 托管的响应页面 34 自定义取消响应页面 35 自定义结账页面外观 35 本地化结账语言 39 激活 Profile 41 Profile 的附加选项 41 示例脚本语言 42 使用 JSP 的示例交易流程 42 章节 3 更新 Secure Acceptance Profile 43 章节 4 处理交易 45 端点和交易类型 45 创建支付令牌 47 信用卡 47 电子支票 49 处理支付令牌交易 51 一键式 51 电子支票 53 循环支付 55 分期付款 57 更新支付令牌 59 信用卡 59 电子支票 61 Secure Acceptance Web/Mobile | 2018 年 4 月 4 目录 章节 5 使用 Decision Manager 63 章节 6 测试和查看交易 65 测试交易 65 查看 Business Center 中的交易 66 附录 A API 字段 67 数据类型定义 67 请求字段 68 响应字段 94 原因代码 123 通知类型 125 AVS 代码 126 国际 AVS 代码 126 美国境内 AVS 代码 127 CVN 代码 128 附录 B iFrame 实施 129 预防点击劫持 129 端点 130 Secure Acceptance Web/Mobile | 2018 年 4 月 5 订 修 本文档的近期修订 发布 变更 2017 年 10 月  在以下字段中添加了与 JCN 支付接口相关的备注（请参阅“请求字 段”，位于第 68 页）：  bill_to_address_line1 2017 年 6 月 本次修订仅包含编排变更，无技术更新。 2017 年 4 月  更新“自定义电子邮件收据”部分。请参阅“自定义电子邮件收据”， 位于第 32 页。  更新了以下请求字段（请参阅表 7，“请求字段”，位于第 68 页）：  bill_to_address_postal_code  consumer_id  添加了以下响应字段（请参阅表 8，“API 响应字段”，位于第 95 页）：  req_bill_to_address_postal_code  req_consumer_id 2017 年 3 月  更新了“启用电子支票”部分。请参阅“启用电子支票”，位于第 20 页。  更新了以下请求字段（请参阅表 7，“请求字段”，位于第 68 页）：  e_commerce_indicator  echeck_routing_number  signed_date_time 2017 年 1 月  添加了以下请求字段（请参阅表 7，“请求字段”，位于第 68 页）：  issuer_additional_data  recipient_account_id  recipient_date_of_birth  recipient_surname  recipient_postal_code  添加了以下响应字段（请参阅表 8，“API 响应字段”，位于第 95 页）：  req_issuer_additional_data  req_recipient_account_id  req_recipient_date_of_birth  req_recipient_surname  req_recipient_postal_code 2016 年 12 月  更新了旅客字段名称。请参阅item_#_passenger_email，位于第 80 页。 Secure Acceptance Web/Mobile | 2018 年 4 月 6 南 指 于 关于本指南 关 受众及用途 本指南旨在为想要通过 CyberSource 托管的安全结账流程接收付款，而不希望处理敏感付 款信息或将其存储在自己服务器上的商户提供指导。 要使用 Secure Acceptance Web/Mobile，需要具备基本的脚本编写技能。您需要创建一个 安全脚本并修改您的 HTML 表单来调用 Secure Acceptance。此外，您还需要使用 Business Center 来审核并管理订单。 网站要求 您的网站必须满足以下要求： 有购物车或客户订单创建软件。   包含采用受支持的脚本语言设计的产品页面（请参阅“使用 JSP 的示例交易流程”， 位于第 42 页）。  IT 基础架构必须为公钥基础设施 (PKI)，支持使用基于 SSL 的 POST 表单提交方式。  IT 基础架构必须能够在将客户数据提交到 Secure Acceptance Web/Mobile 之前对其进 行数字签名。 Secure Acceptance Web/Mobile | 2018 年 4 月 7 关于本指南 约定 备注、重要说明和警告声明 备注包含有用建议或本文档中未包含材料的参考信息。 备注 重要说明包含关于成功完成某项任务或学习某个概念的重要信息。 重要说明 警告包含如果不加以留意，可能导致安全风险、不可挽回的数据丢失，或者时 间和/或收入巨大损失的信息或说明。 警告 文本和命令约定 约定 用途 加粗  文本中的字段和服务名称，例如： 包含 transaction_type 字段。  要求您执行的项目；例如： 点击保存。 屏幕文字  代码示例。  在 API 环境中输入的文本；例如： 将 transaction_type 字段设置为 create_payment_ token。 Secure Acceptance Web/Mobile | 2018 年 4 月 8 关于本指南 相关文档 有关完整的 CyberSource 技术文档，请参阅支持中心： http://www.cybersource.com/support_center/support_documentation 表 1 相关文档 主题 说明 信用卡 下列文档说明如何将信用卡处理集成到订单管理系统中：  使用 SCMP API 的信用卡服务 (PDF | HTML)  使用 Simple Order API 的信用卡服务 (PDF | HTML) Decision 下列文档说明如何集成和使用 Decision Manager 服务。 Manager  使用 SCMP API 的 Decision Manager 开发人员指南 (PDF | HTML)  使用 Simple Order API 的 Decision Manager 开发人员指南 (PDF | HTML) 电子支票 下列文档说明如何集成和使用电子支票服务：  使用 SCMP API 的电子支票服务 (PDF | HTML)  使用 Simple Order API 的电子支票服务 (PDF | HTML) II 级和 III 级 使用 Secure Acceptance 的 II 级和 III 级处理 (PDF | HTML) — 说明每个 II 级 和 III 级 API 字段及如何使用 Secure Acceptance 处理 II 级和 III 级交易。 3DS 验证 下列文档说明如何集成和使用 3DS 验证服务：  使用 SCMP API 的 3DS 验证 (PDF | HTML)  使用 Simple Order API 的 3DS 验证 (PDF | HTML) 支付安全标准 支付卡行业数据安全标准 (PCI DSS) — 网站提供用以强化支付卡数据安全的 标准和支持材料。 支付标记化 下列文档说明如何创建客户 Profile 和使用支付令牌进行即期支付：  使用 Business Center 的支付标记化 (PDF | HTML)  使用 SCMP API 的支付标记化 (PDF | HTML)  使用 Simple Order API 的支付标记化 (PDF | HTML) PayPal Express 下列文档说明如何集成和使用 PayPal Express Checkout 服务： Checkout  使用 SCMP API 的 PayPal Express Checkout 服务 (PDF | HTML)  使用 Simple Order API 的 PayPal Express Checkout 服务 (PDF | HTML)。 定期账单 下列文档说明如何创建客户订阅和使用支付令牌进行循环和分期付款：  使用 Business Center 的定期账单 (PDF | HTML)  使用 SCMP API 的定期账单 (PDF | HTML)  使用 Simple Order API 的定期账单 (PDF | HTML) 报告 报告开发人员指南 (PDF | HTML) — 说明如何查看和配置 Business Center 报告。 Secure  Secure Acceptance Silent Order POST 开发指南 (PDF | HTML)。 Acceptance  Secure Acceptance Silent Order POST 服务费指南 (PDF) Secure Acceptance Web/Mobile | 2018 年 4 月 9 关于本指南 表 1 相关文档 （续） 主题 说明 Visa Checkout Visa Checkout 入门 (PDF | HTML) — 说明如何注册 Visa Checkout 并创建 Visa Checkout Profile。 客户支持 有关任何 CyberSource 服务的支持信息，请访问支持中心： http://www.cybersource.com/support Secure Acceptance Web/Mobile | 2018 年 4 月 10