iOS

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

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

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

• 使用实例对象中的 mountComponent 函数:
  • 使用 sessionData 参数创建配置对象: 将步骤 4 获取的 vaultingSessionData 字段的完整数据传入 mountComponent 的 sessionData 参数。
  • 调用实例对象中的 mountComponent() 函数初始化 SDK。
• 调用实例对象中的 submit() 函数：
  • 调用该函数，可触发绑卡提交流程，返回值为 Promise，返回特定事件码。这些事件码也会通过 onError 或 onEventCallback 等事件返回。
  • 如果您需要传入提前收集好的 billing address 信息用于 AVS 验证，您可配置如下参数通过 submit() 函数传入。
    • billingAddress：选传，Object 类型。用来识别付款人身份和位置的账单地址信息。包含如下参数：
      • region：必传，String (2)。遵循 ISO 3166 标准的二位国家码。
      • zipCode：选传，String (32)。邮政编码。
      • address2：选传，String (256)。地址行 2，例如公寓、套房、单元和建筑物信息。
      • address1：选传，String (256)。地址行 1，例如街道地址、邮政信箱和公司名称。
      • city：选传，String (32)。城市、地区、郊区、城镇或村庄名称。
      • state：选传，String (8)。州、国家或省名称。

调用实例对象中的 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）：