Antom, leading provider of tailored payment solutionsAntom, leading provider of tailored payment solutions

CVVElement

CVV 支付元素，用于收集买家输入的 CVV（Card Verification Value）安全码。CVV 是信用卡/借记卡背面的 3 位或 4 位数字，用于验证持卡人身份。

注意：CVVElement 仅负责 CVV 输入框的渲染与收集，实际发起支付需要调用 antom.confirmPayment() ，并将 CVVElement 实例作为 elements 参数传入；若不传 elements，此时 SDK 以无 UI 模式发起支付，不收集 CVV。

方法签名

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

copy
antom.createElement('CVV', options)

参数

参数名称

类型

是否必需

描述

elementType

String

是

Element 类型。此场景下需传入 CVV，用于收集 CVV。

options

Object

否

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

options

参数名称

类型

是否必需

描述

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 自定义属性，实现主题定制。

返回值

此方法返回一个 CVVElement 实例对象，提供挂载、卸载、销毁、注册事件监听器等方法：

方法名

描述

element.on()

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

element.mount()

用于将 Element 挂载到 DOM。

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