Web/WAP

• 创建 config 对象：必传，Object 类型。包含所有配置参数：
  • locale: 选传，String 类型。商户客户端识别用户浏览器使用的语言种类，并传入浏览器多语言信息，SDK 根据此信息提供对应语言的页面。目前 SDK 仅支持以下多语言信息的值，如果传入的值不是以下几种，将提供英语页面：
    • en_US：英语
    • pt_BR：葡萄牙语
    • ko_KR：韩语
    • es_ES：西班牙语
  • environment: 必传，String 类型。用于传入环境参数，支持的值包括：
    • sandbox：沙箱环境
    • prod：生产环境
  • analytics：选传，Object 类型，用于配置分析数据服务，包含以下参数：
    • enabled: 选传，Boolean 类型。默认值为 true ，代表允许 SDK 上传分析运行数据以提供更好的服务。如您不允许上传分析运行数据，需指定此值为 false 。
  • onLog: 选传，输出 SDK 运行期间触发的日志、接口异常等错误信息的回调函数。
  • onEventCallback: 选传，SDK 运行期间支付发生特定事件触发回调并返回具体事件码，例如支付结果、表单提交异常等。更多详情请查阅 参考信息 文档。
• 实例化 AMSCashierPayment 。

买家在支付方式选择页选择卡支付方式后，商户客户端自行实现支付按钮的点击事件监听。当监听到支付按钮被用户点击后，商户服务端需向 Alipay 服务器发起 支付会话创建 请求。收到支付会话创建请求的响应后，将响应中的 paymentSessionData 参数值用于步骤 4 。

• 使用 sessionData 参数创建配置对象: 将 支付会话创建 请求的响应中获取的 paymentSessionData 字段的完整数据传入 sessionData 参数。
• 调用实例对象中的 createComponent() 函数，返回值为 Promise, 支付区块 DOM 节点即可根据参数在当前页面渲染出浮层视图。
  • appearance：选传，Object 类型，用于自定义外观主题配置，包含以下参数：
    • showLoading：选传，Boolean 类型。默认值为 true，代表展示默认 loading 动画。如您不使用默认 loading 动画，需指定此值为 false。
  • ​​notRedirectAfterComplete：选传，Boolean 类型。默认值为 false，表示支付完成后跳回您的页面，当值为空时同理。值为 true 表示支付完成后不跳转，您需要通过客户事件码自行控制绑卡完成后续流程。需要注意的是客户端返回的支付结果事件码仅用于客户端页面的跳转操作参考，交易状态的更新请以服务端 支付结果通知 或 支付查询 接口返回结果为准。

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

  • 用户切换视图退出支付页面，需要回收 支付会话创建 中的组件资源。
  • 用户发起多笔支付，需要回收上一次 支付会话创建 中的组件资源。
  • 用户完成支付并配置了 notRedirectAfterComplete 为 true，可获取明确支付结果事件码时，需要回收组件资源。