enabledPaymentMethod 字段说明
1. Overview
enabledPaymentMethod 是一个 可选参数，适用于 LinkPay 和 Drop-in 集成场景。
当商户希望在自己的结账页面中让用户选择支付方式，并在调用 Evonet 接口时控制支付方式的展示顺序或范围时，可使用该字段。
默认情况下，Evonet 会根据商户的签约信息自动展示所有可用的支付方式。
仅当商户需要自定义展示逻辑时，才建议使用此参数。
2. Parameter Definition
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
enabledPaymentMethod | array(string) | 否 | 指定希望在 Evonet 支付页面中展示的支付方式列表。数组的顺序即展示顺序。 |
3. Usage Examples
示例 1 — 单一支付方式
如果商户希望在 Evonet 支付页仅展示 Boost：
"merchantOrderInfo": {
"enabledPaymentMethod": ["Boost"]
}示例 1 — 多个支付方式
展示 Alipay 和 WeChat Pay，并按照数组顺序显示：
"merchantOrderInfo": {
"enabledPaymentMethod": ["Alipay", "WeChat_Pay"]
}示例 1 — 使用通配符 “*”
通配符 “*” 可用于表示 “除已指定外的所有可用支付方式”。
"merchantOrderInfo": {
"enabledPaymentMethod": ["Visa", "Mastercard", "*"]
}此示例表示：
- 优先展示 Visa 与 Mastercard；
- 之后展示商户账户下所有其他已开通的支付方式（例如 Alipay、WeChatPay 等）；
- 这样即使未来新增支付方式，也可自动展示，无需修改集成逻辑。
4. Recommended Use Cases
| 场景 | 推荐设置 | 说明 |
|---|---|---|
| 使用 Evonet 默认支付页面 | 不传该字段 | 系统自动展示所有可用支付方式 |
| 商户自行展示支付方式 | 传递所选支付方式 | 仅展示用户在商户页面已选择的方式 |
| 希望在前端固定展示部分方式，并提供 “全部支付方式” 入口 | 使用 “*” | 自动包含剩下已开通的支付方式 |
当在数组末尾使用 “*” 时，可在页面设计一个 “其他支付方式” 或 “全部支付方式” 的入口。用户点击后， Evonet 将展示剩余的可用支付方式。
5. Best Practices
- 仅传递商户账户下已开通的支付方式。
- 通配符
“*”应始终位于数组的最后一个位置。 - 排序功能目前只支持 Drop-in
Updated 7 days ago