VaultingElement

Vaulting 绑卡元素,用于收集买家的信用卡/借记卡信息,完成绑卡流程。绑卡是指将买家的支付方式保存到商户系统,以便后续快速支付。

注意:VaultingElement 仅负责绑卡表单的渲染与信息收集,实际提交绑卡需要调用 antom.confirmCardSetup(),并将 VaultingElement 实例作为 elements 参数传入。

方法签名

调用此方法时,请使用以下标准方法签名格式:

copy
antom.createElement('vaulting', options)

参数

参数名称

类型

是否必需

描述

elementType

String

Element 类型。此场景下需传入 vaulting,用于收集买家的信用卡/借记卡信息,完成绑卡流程。

options

Object

配置对象,用于设置组件的外观主题和多语言环境。

options

参数名称

类型

是否必需

描述

sessionData

String

绑卡会话数据。用于标识本次绑卡会话,该值由商户后端生成并返回。

locale

String

多语言配置。

注意:若同时在 loadAntom() 方法中设置了 locale 参数,则以antom.createElement() 参数中的 locale 值优先

有效值为:

  • en_US:默认值。英语
  • pt_BR:葡萄牙语(巴西)
  • pt_PT:葡萄牙语
  • es_ES:西班牙语
  • ko_KR:韩语
  • zh_CN:简体中文
  • zh_HK:繁体中文
  • ms_MY:马来西亚语
  • in_ID:印度尼西亚语
  • th_TH:泰语
  • vi_VN:越南语
  • tl_PH:菲律宾语
  • it_IT:意大利语
  • de_DE:德语
  • fr_FR:法语
  • nl_NL:荷兰语
  • ja_JP:日语
  • ro:罗马尼亚语
  • pl_PL:波兰语
  • ar_SA:阿拉伯语
  • tr_TR:土耳其语
  • hi_IN:印度语

appearance

Object

用于自定义外观配置,更多信息请参阅自定义外观样式其包含以下参数:

  • theme:主题颜色。
  • variables:通过 CSS 设计 Token(如 color-primary)覆盖底层 CSS 自定义属性,实现主题定制。

返回值

此方法返回一个 VaultingElement 实例对象,提供挂载、卸载、销毁、注册事件监听器和更新配置等方法:

方法名

描述

element.on()

为 Element 实例注册事件监听器。

element.mount()

用于将 Element 挂载到 DOM。

element.destroy()销毁当前 Element(不可再次挂载)。
element.unmount()卸载当前 Element(可再次挂载)。
element.updateConfig()

更新 Element 的配置。