setOption()

setOption()方法用于设置配置选项。

方法签名

Java

copy
public AMSBaseConfiguration setOption(String key, Object value)

参数

参数

类型

是否必需

描述

key

String

是

配置项的键。参见可用的 key。

value

Object

是

配置项的值，类型因 key 不同而异。

可用的 key

Key

值类型

描述

sandbox

Boolean

是否启用沙箱环境。

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

showLoading

Boolean

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

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

notRedirectAfterComplete

Boolean

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

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

注意：

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

appearance

String（JSON）

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

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

返回值

返回 this() 方法，以支持链式调用。

最佳实践

回跳商户页面

回跳商户页面及返回支付或绑卡结果有以下情况，请您按照指引进行处理：

notRedirectAfterComplete

支付或绑卡结果

建议操作

true

成功/失败

若您在创建 Payment Element 或 Vaulting Element 实例时将 notRedirectAfterComplete 设置为true 且该支付或绑卡方式支持在 SDK 内完成支付或绑卡，将通过 onSubmitPayCallback() 方法返回支付或绑卡结果，您需要根据对应场景下 onSubmitPayCallback() 方法返回的支付或绑卡结果事件码自行处理跳转逻辑：

false

成功

支付或绑卡完成后 Payment Element 或 Vaulting Element 会自动跳转至您在 createPaymentSession（单笔支付） 传入的 paymentRedirectUrl 或 createVaultingSession 接口中传入的 redirectUrl。

false

失败

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

注意：