Web/WAP

• 创建 config 对象：必传，Object 类型。包含所有配置参数：
  • locale：选传，String 类型。商户客户端识别用户浏览器使用的语言种类，并传入浏览器语言信息，SDK 根据此信息提供对应语言的页面。不同的支付方式支持的语言不同，以下是 SDK 提供的多语言信息，您可以根据支付方式所在地区选择需要传入的值，如果传入的语言不在以下范围内，SDK 将提供英语页面：
    • en_US：英语
    • pt_BR：葡萄牙语
    • ko_KR：韩语
    • es_ES：西班牙语
    • fr_FR：法语
    • nl_NL：荷兰语
    • it_IT：意大利语
    • de_DE：德语
    • zh_CN：中文简体
    • zh_HK：中文繁体
    • ms_MY：马来语
    • vi_VN：越南语
    • in_ID：印尼语
    • th_TH：泰语
  • environment：必传，String 类型。用于传入环境参数，支持的值包括：
    • sandbox：沙箱环境
    • prod：生产环境
  • analytics：选传，Object 类型，用于配置分析数据服务，包含以下参数：
    • enabled：选传，Boolean 类型。默认值为 true ，代表允许 SDK 上传分析运行数据以提供更好的服务。如您不允许上传分析运行数据，需指定此值为 false 。
  • onLog：选传，输出 SDK 运行期间触发的日志、接口异常等错误信息的回调函数。
  • onError：选传，在 SDK 运行期间发生错误时被触发（如初始化异常、网络超时等问题）。详情请参考 SDK 错误码。
  • onEventCallback：必传，SDK 运行期间支付发生特定事件触发回调并返回具体事件码，例如支付结果、支付取消等。更多详情请查阅参考信息文档。
• 实例化 AMSCashierPayment。

商户客户端自行监听支付按钮的点击事件。当买家选择支付方式并点击支付按钮后，商户服务端向 APO 服务器发起 支付会话创建 请求。一旦接收到 支付会话创建 请求的响应，将响应中的 paymentSessionData 值用于步骤 4。

• 使用 sessionData 参数创建配置对象：将 支付会话创建 请求的响应中获取的 paymentSessionData 字段的完整数据传入 sessionData 参数。
• 调用实例对象中的 createComponent() 函数，返回值为 Promise。支付区块 DOM 节点即可根据参数在当前页面渲染出浮层视图。

• 调用实例对象中的 unmount() 函数进行 SDK 组件的资源回收，请在以下两种场景中调用：

  • 用户退出支付页面时，需要回收 支付会话创建 中的组件资源。
  • 用户发起多笔支付时，需要回收上一次 支付会话创建 中的组件资源。

支付过程事件

在 SDK 运行期间通过 onEventCallback 回调函数返回支付过程状态码，以下几组状态码需要您特别关注并做进一步处理：

• 当用户在未提交订单状态下退出支付页面时，您会收到以下事件码：
  • SDK_PAYMENT_CANCEL：当收到此事件码时，建议您引导用户再次支付。

支付结果展示

• 跳端支付：在支付流程结束时，跳端支付方式会根据支付结果将用户重定向到您传入的回跳URL上，进而引导用户进行下一步操作。
• 非跳端支付：在支付流程结束时，非跳端支付方式将为您返回与支付结果相关的事件码，您可以根据不同的支付结果做进一步处理：
  • SDK_PAYMENT_SUCCESSFUL：支付成功。建议您重定向到支付结果页。
  • SDK_PAYMENT_FAIL：支付失败。建议您检查 onEventCallback 函数 result 数据中 paymentResultCode 的值，并在文末参考信息“支付失败或异常说明”表格中查阅进一步的行动建议，根据行动建议引导用户重新支付。
  • SDK_PAYMENT_ERROR：支付状态异常。建议您检查 onEventCallback 函数 result 数据中 paymentResultCode 的值，并在文末参考信息“支付失败或异常说明”表格中查阅进一步的行动建议。
  • SDK_PAYMENT_PROCESSING：支付处理中。建议您检查 onEventCallback 函数 result 数据中 paymentResultCode 的值，并在文末参考信息“支付失败或异常说明”表格中查阅进一步的行动建议。