Web/WAP

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

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

对于已绑卡的卡令牌支付模式下您需要通过 paymentMethod.paymentMethodId 字段传入买家绑卡后 APO 返回给您的卡令牌，获取卡令牌方式如下：

• 独立绑卡：通过 APO 向您发送的资产绑定结果通知中的 card.cardToken 字段获取卡令牌。
• 非独立绑卡：通过 APO 向您发送的支付结果通知或主动查询支付结果的响应中的 paymentResultInfo.cardToken 字段获取卡令牌。

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

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

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