系统-交易设置-保存
系统设置 - 交易配置保存
接口信息
- 接口地址:
{your-site-url}/api/skill/system-setting/order-set - 基础 URL:
{your-site-url}需替换为你自己的独立站 URL 地址，如https://your-domain.com/apimanager666 - 请求方式:
POST - Content-Type:
application/json - 说明: 此接口用于保存订单相关配置
认证
请求头中需要携带 skill-access-token：
| Header | 值 |
|---|---|
skill-access-token |
{your-skill-access-token} （请替换为你自己的 token） |
请求参数 (JSON Body)
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
login_account |
int | ✅ 必填 | 登录要求。1 = 注册会员与非注册会员均可购买，2 = 只支持会员购买 |
deduct_stock |
int | ✅ 必填 | 扣减库存。1 = 发起结账时扣减库存（有效保证商品不会被超卖），2 = 成功下单时扣减库存（可避免产品库存被占用） |
product_status_check |
int | ✅ 必填 | 商品状态检验。1 = 不校验（创建订单后即使商品下架也可完成下单），2 = 强校验（只要存在商品下架就会取消订单，提示重新下单） |
checkout_page_type |
int | ✅ 必填 | 结账页形式（仅对 Vue 模版有效，Liquid 模版默认一页支付，此配置项无效）。1 = 快速结账页（单页，注重转化率，适用于 COD，仅用 PayPal 不收款的商家不推荐），2 = 标准结账页（细化流程，获取更精准的用户流失数据） |
coupon_show_type |
int | ✅ 必填 | 优惠码应用框显示位置（仅对 Vue 模版有效，Liquid 模版无效）。1 = 正常显示，2 = 仅在支付页面显示，3 = 支付页不显示，4 = 所有结账页不显示 |
pending_order_cancel_datetime |
int | ✅ 必填 | 待付款订单取消时间，单位：秒。0 = 不限时长，1800 = 30 分钟，3600 = 1 小时，可自定义 |
address_company |
int | ✅ 必填 | 结账页公司字段。1 = 必填，2 = 选填，3 = 隐藏 |
address_street_2 |
int | ✅ 必填 | 结账页第二行地址字段。1 = 必填，2 = 选填，3 = 隐藏 |
contact_type |
int | ✅ 必填 | 结账页联系方式类型。1 = 仅收集邮箱，2 = 仅收集手机号，3 = 仅收集手机号或邮箱，4 = 邮箱必填手机号选填，5 = 邮箱必填手机号必填，6 = 邮箱选填手机号必填 |
name_type |
int | ✅ 必填 | 结账页姓名类型。1 = 姓名一起填写，2 = 姓名分开填写 |
name_require_type |
int | ✅ 必填 | 结账页姓名要求。1 = 姓必填，2 = 姓名都必填 |
address_zip |
int | ✅ 必填 | 结账页邮编字段。1 = 必填，2 = 选填，3 = 隐藏 |
customer_can_cancel_order |
int | ✅ 必填 | 是否允许顾客取消订单。1 = 允许（默认），2 = 不允许 |
请求示例
cURL
curl --location --request POST '{your-site-url}/api/skill/system-setting/order-set' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
"login_account": 1,
"deduct_stock": 1,
"product_status_check": 1,
"checkout_page_type": 1,
"coupon_show_type": 1,
"pending_order_cancel_datetime": 3600,
"address_company": 3,
"address_street_2": 2,
"contact_type": 4,
"name_type": 2,
"name_require_type": 1,
"address_zip": 2,
"customer_can_cancel_order": 1
}'
返回结果
code 为 200 表示调用成功；code 不为 200 表示调用失败。
成功响应
{
"code": 200,
"data": [],
"message": "success"
}
返回字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
code |
Number | 状态码，200 表示成功 |
message |
String | 执行结果的文字描述 |
data |
Array | 返回数据，目前为空数组 |
注意事项
- 所有字段均为必填
- 保存前必须调用 系统-交易设置-获取 获取当前完整配置，在此基础上修改需要的字段后再传入保存，不可直接传入部分字段
checkout_page_type和coupon_show_type仅对 Vue 模版有效，Liquid 模版（如 Mirox 等新架构）默认一页支付，这两个配置项对该类模版无效pending_order_cancel_datetime单位为秒，0表示不自动取消- 注意：api保存是全量保存，即时您只配置修改一个选项，也要进行全量保存，因此，先通过获取api得到数据，然后进行更改数据，然后进行保存