Android

创建 SDK 实例的过程包含以下步骤：

1. 创建 configuration 对象：必传，Object 类型。包含所有配置参数：
   • ​setLocale: 选传，String类型。商户客户端识别用户浏览器使用的语言种类，并传入浏览器语言信息，SDK 根据此信息提供对应语言的页面。目前 SDK 支持以下几种多语言，如果传入的值不是以下几种，将提供英语页面：
     • en_US：英语
     • es_ES：西班牙语
     • fr_FR：法语
     • nl_NL：荷兰语
     • it_IT：意大利语
     • de_DE：德语
     • zh_CN：简体中文
   • setOption: 选传，用于设置是否采用默认 loading 样式以及是否使用沙箱环境，支持的值包括：
     • "sandbox", "true"：沙箱环境。
     • "sandbox", "false"：生产环境。
     • "showLoading", "true"：使用默认 loading 样式。
     • "showLoading", "false"：不使用默认 loading 样式。
     • "showSubmitButton", "true"：配置由 SDK 组件渲染绑卡按钮。
     • "showSubmitButton", "false"：配置由商户渲染绑卡按钮，同时需要调用实例对象中 submit函数触发提交绑卡流程。
2. 创建 onCheckoutListener 接口的实例，用于后续流程中对应事件发生时的处理，包含以下方法：
   • onEventCallback: 必传。收银台支付事件回调函数，返回事件码（eventCode）和事件信息（eventResult）。
3. 将 onCheckoutListener 接口的实例设置到 configuration 实例中，用于执行事件回调。
4. 实例化 AMSVaulting。

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

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

• 使用实例对象中的 mountComponent 函数并传入以下参数:
  • activity: 必传。Activity 类型对象，用于包含当前页面的上下文参数信息。
  • appearance，类型为AMSPaymentAppearance
    • ​"showSubmitButton", "true"：配置由SDK组件渲染绑卡按钮
    • "showSubmitButton", "false"：配置由商户渲染绑卡按钮，同时需要调用实例对象中 submit() 函数触发提交绑卡流程
  • sessionData：必传。String类型。将资产绑定会话创建 请求的响应中获取的 vaultingSessionData 字段的完整数据传入 mountComponent 的 sessionData 参数。
  • parentViewGroup：必填，FrameLayout 类型，用于绑定视图关联到商户的页面布局，布局参数需要设置为wrap_content, SDK 会根据视图内部内容的大小自动调整视图宽高。
• 调用实例对象中的 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)。邮政编码。

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

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

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）：