Web/WAP

1. 创建 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 运行期间绑卡结果事件码、状态码等，例如绑卡成功、绑卡失败等。详情请参见 SDK 状态码。
   • onError: 选传，在 SDK 使用中发生错误时被触发（初始化异常、网络超时等）。 详情请参见 SDK 错误码说明。
2. 实例化 AMSVaulting。

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

如果您需要在卡资产绑定完成后自动重定向买家到您的页面，通过 资产绑定会话创建 接口中的 redirectUrl 字段传入跳转地址。如果您希望通过客户端事件码自行控制绑卡完成后续流程，则无需传入该字段，并通过 onEventCallback 监听绑卡结果事件码。

• 使用实例对象中的 mountComponent 函数:
  • 使用 sessionData 参数创建配置对象: 将步骤 4 获取的 vaultingSessionData 字段的完整数据传入 mountComponent 的 sessionData 参数。
  • 调用实例对象中的 mountComponent() 函数，返回值为 Promise，内容为使用该函数所得的组件实例对象。支付区块 DOM 节点即可根据环境参数渲染出绑卡要素收集视图并插入当前页面中。您可以配置以下参数：
    • appearance：选传，Object 类型，用于自定义外观主题配置，包含以下参数：
      • showLoading: 选传，Boolean 类型。默认值为 true ，代表展示默认loading 动画。如您不使用默认 loading 动画，需指定此值为 false 。​​​
      • showSubmitButton：选传，Boolean 类型。默认值为false，表示是否由组件渲染绑卡按钮。若该值为false，则需要调用实例对象中 submit() 函数触发提交绑卡流程。
• 调用实例对象中的 submit() 函数：
  • 调用该函数，可触发绑卡提交流程，返回值为Promise，返回特定事件码。这些事件码也会通过onError或onEventCallback等事件返回。
  • 如果您需要传入提前收集好的 billing address 信息用于 AVS 验证，您可配置如下参数通过 submit 函数传入。
    • billingAddress：选传，Object 类型。用来识别付款人身份和位置的账单地址信息。包含如下参数：
      • ​region：必传，String (2)。遵循 ISO 3166 标准的二位国家码。
      • state：选传，String (8)。州、国家或省名称。
      • city：选传，String (32)。城市、地区、郊区、城镇或村庄名称。
      • address1：选传，String (256)。地址行 1，例如街道地址、邮政信箱和公司名称。
      • address2：选传，String (256)。地址行 2，例如公寓、套房、单元和建筑物信息。
      • zipCode：选传，String (32)。邮政编码。

调用实例对象中的 unmount() 函数，可以销毁已经创建的组件。如下情况下您需要卸载组件：

• 如果你的客户端设置了超时时间，到达所设置的超时时间时。
• 买家退出绑卡页面时。
• 您收到绑卡结果回调时。

SDK 提供的绑卡结果事件码（code）：

• SDK_ASSET_BINDING_FAIL：绑卡失败。建议您根据 vaultingResultCode 错误码提示信息，并重新引导用户绑卡。
• SDK_ASSET_BINDING_SUCCESSFUL：绑卡成功，需要注销SDK。建议重定向到绑卡结果页。
• SDK_ASSET_BINDING_ERROR：绑卡异常。建议您等待绑卡结果通知或重新引导用户绑卡。

SDK 查询服务端绑卡状态（vaultingStatus）：

• SUCCESS: 表示绑卡成功。
• FAIL: 表示绑卡失败。

SDK 查询服务端结果码（result.resultCode）：

SDK 查询服务端绑卡结果码（vaultingResultcode）：