8、线下实物商品下单接口

创建于 2025-04-08 / 最近更新于 2025-04-09 / 96
字体： [默认] [大] [更大]

接口说明：

本接口用于线下实物产品交易下单操作。扩展参数需根据商品详情中配置的扩展字段顺序依次组成数组。

例如，若扩展字段为 ['手机号', '备注']，则下单参数应为：['13888888888', '22334455']，其中第一个为手机号，第二个为备注。

扩展参数为可选项，若不传递，系统将默认收集收件人姓名、电话和地址等基本信息。

回调说明：

若所使用的 appid 未配置回调通知地址，则系统将不会发送订单结果回调。建议在下单完成后，间隔 1~3 秒调用订单查询接口以获取订单状态。

请求参数

参数

是否必填

类型

描述

appid

是

String

appid

time

是

Number

10位当前时间戳，间隔上下不低于120秒

sign

是

String

签名，规则参照签名规则

method

是

String

youquanyi.api.out.buyshiwu

count

是

String

购买数量

cus_order_no

是

String

客户端订单号，不能重复

good_id

是

String

产品id

extend_field

否

String

订单扩展信息，数组格式，内容请按商品详情扩展字段数据顺序传递，根据商品信息决定是否传递。

address_info

是

String

地址信息，包含area-省/市/区，name-收货人姓名，phone-联系方式。

safe_price

否

String

订单总价，用于防止亏本下单，为空则不执行

请求示例

{
    "address_info": {
        "area": "四川省成都市武侯区",
        "info": "xxx大街666号",
        "name": "小王",
        "phone": "18888888888"
    },
    "appid": "xxx",
    "count": "1",
    "cus_order_no": "xxx",
    "extend_field": [
        "111111",
    ],
    "good_id": "127",
    "method": "youquanyi.api.out.buyshiwu",
    "sign": "签名内容，请阅读签名方法",
    "time": "1699935886"
}

公共响应参数

参数

类型

描述

code

Number

返回码 0-成功 99-失败

msg

String

提示信息

data

String

业务返回数据

业务返回参数（data）

参数

类型

描述

order_number

String

订单号

money

String

订单金额

接口返回示例

{
    "msg": "请求成功！",
    "code": 0,
    "data": {
      	"order_number": "202309281613169896751688"
        "money": 0.01
    }
}
0 人点赞过