antom.createElement()
antom.createElement() 是一个工厂方法。在成功调用 loadAntom() 加载 SDK 并获取 antom 实例后,您可以通过此方法传入指定的 elementType 来动态创建相应的支付或绑卡元素实例。
方法签名
调用此方法时,请使用以下标准方法签名格式:
antom.createElement(elementType, options);antom.createElement(elementType: ElementType, options?: AppConfig): Element参数
此方法接收两个参数,分别用于指定要创建的元素类型及其配置。
参数 | 类型 | 是否必需 | 描述 |
elementType | String | 是 | Element 类型,有效值为:
|
Object | 是 | 配置对象,用于设置组件的外观主题和多语言环境。 |
options
请根据所使用的 Element 类型及具体业务场景,传入对应的 options 参数。
当 elementType 为 CVV 或 vaulting 时,传入以下 options 配置对象。
参数 | 类型 | 是否必需 | 描述 |
appearance | Object | 否 |
|
sessiondata | String | 是 | 会话数据。 |
locale | String | 否 | 多语言配置。 注意:
|
当 elementType 为 express 时,传入以下 options 配置对象。
参数 | 类型 | 是否必需 | 描述 |
sessionData | String | 否 | 支付会话数据。 注意:当支付方式为 Apple Pay、Google Pay、Alipay 时必填,PayPal 由 createOrder() 在服务端返回。 |
Object | 否 | 支付金额。 注意:当支付方式为 PayPal 时必填。 | |
paymentMethods | Object | 否 | 启用的支付方式列表,同时决定按钮渲染顺序。有效值为:
注意:该参数为非必填,如果不传则不会出现快捷支付按钮。如需渲染快捷支付按钮,请至少传入一个支付方式的值。 |
Object | 否 | PayPal 配置参数,集成 PayPal 时必填。 | |
Object | 否 | 各支付方式的按钮类型。 注意:Alipay 不支持该参数。 | |
Object | 否 | 各支付方式的按钮颜色。 注意:Alipay 不支持该参数。 | |
buttonHeight | Number | 否 | 统一按钮高度,单位为 px。 |
amount
paypal
参数 | 类型 | 是否必需 | 描述 |
businessDivision | String | 是 | 业务分区(国家/地区)标识。 |
channelMerchantAccountId | String | 是 | PayPal 商户 ID。 |
createOrder() | Function | 是 | |
Object | 否 | 按钮形状。 | |
Function | 否 | 配送地址变更回调,data 为 PayPal 返回的原始数据。 | |
Function | 否 | 配送方式变更回调,data 为 PayPal 返回的原始数据。 |
style
参数 | 类型 | 是否必需 | 描述 |
shape | String | 否 | 按钮形状:
|
buttonType
参数 | 类型 | 是否必需 | 描述 |
applePay | String | 否 | Apple Pay 支付方式按钮支持的文案包括:
|
googlePay | String | 否 | Google Pay 支付方式按钮支持的文案包括:
|
paypal | String | 否 | PayPal 支付方式按钮支持的文案包括:
|
buttonTheme
参数 | 类型 | 是否必需 | 描述 |
applePay | String | 否 | Apple Pay 支付方式按钮支持的颜色包括:
|
googlePay | String | 否 | Google Pay 支付方式按钮支持的颜色包括:
|
paypal | String | 否 | PayPal 支付方式按钮支持的颜色包括:
|
返回值
此方法返回一个 element 实例对象,提供挂载、卸载、销毁及配置更新等方法,用于灵活管理页面中的组件生命周期。
方法名 | 描述 |
为 Element 实例注册事件监听器。 | |
用于将元素挂载到指定的页面节点,可传入一个具体的 HTMLElement。 | |
卸载当前 Element(可再次挂载)。 | |
销毁当前 Element(不可再次挂载)。 | |
更新配置。 |