AMSVaultElementConfiguration

参数

类型

是否必需

描述

locale

String?

否

首选语言。由语言代码（ISO-639）和国家代码（ISO-3166）通过下划线连接组成，例如 new Locale("en", "US")。有效值为：

• 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：印度语

注意：如果不传或传入的语言值不在以上范围内，系统将默认使用英语。

options

[String: Any]?

否

配置选项字典，用于传递额外的配置参数。参见可用的 key。

Key

值类型

描述

sandbox

Bool

是否启用沙箱环境。

• true：沙箱环境。
• false：默认值。生产环境。

showLoading

Bool

是否在请求过程中显示加载动画。

• true：默认值。使用默认加载模式。
• false：不使用默认加载模式。设为 false 时，建议配合加载事件回调自行自定义。

notRedirectAfterComplete

Bool

用于设置绑卡完成后是否跳转回您的页面。有效值为：

• false：默认值。表示绑卡成功后自动跳回您的页面，绑卡失败或其他场景不会自动回跳，需要您自行处理。当值为空时同理。
• true：表示绑卡完成后不跳转，您需要通过客户端事件码自行控制绑卡完成后续流程。

注意：

• 绑卡成功或失败在回跳商户页面的最佳实践参见回跳商户页面。
• 客户端返回的绑卡结果事件码仅用于客户端页面的跳转操作参考，交易状态的更新请以服务端的 notifyVaulting 或 inquireVaulting 接口返回的结果为准
• 该参数仅针对 Vaulting Element 内完成绑卡的支付方式生效。

appearance

String（JSON）

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

• theme：String 类型，主题颜色。
• layout：String 类型，布局配置。
• variables：Object 类型，通过 CSS 设计 Token（如 content-primary）覆盖底层 CSS 自定义属性，实现主题定制。

notRedirectAfterComplete

绑卡结果

建议操作

true

成功/失败

若您在创建 Vaulting Element 实例时将 notRedirectAfterComplete 设置为 true 且该支付方式支持在 SDK 内完成绑卡，将通过 onSubmitPayCallback()

返回绑卡结果，您需要根据 onSubmitPayCallback() 返回的绑卡结果事件码自行处理跳转逻辑。

false

成功

绑卡完成后 Vaulting Element 会自动跳转至您在 createVaultingSession 接口中传入的 redirectUrl 。

false

失败

通过 onSubmitPayCallback() 返回绑卡结果，您需要根据对应场景下 onSubmitPayCallback() 返回的绑卡结果事件自行处理跳转逻辑。