下单接口
1.概述
2.接口基本信息
2.1 接口地址
| 环境 | 接口地址URL |
|---|---|
| 测试环境 | https://t-api.zuifuli.com/api/open/v5/trade/create |
| 生产 | https://api.zuifuli.com/api/open/v5/trade/create |
2.2 业务参数
| 名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| custId | Long | 是 | 宜员方用户id |
| outerTradeNo | String | 是 | 客户平台订单号，对账用 |
| payAmountFen | Long | 是 | 支付金额，单位分 |
| costFeeFen | Long | 是 | 成本价，单位分 |
| notifyUrl | String | 是 | 支付成功后的通知地址 |
| expireTime | Date | 是 | 订单过期时间 |
| originOrderUrl | String | 是 | 订单详情地址 |
| body | String | 是 | 商品内容 |
| returnUrl | String | 否 | 返回url |
| backUrl | String | 否 | 回退url |
| extMap | JSONObject | 否 | 扩展信息 |
| itemList | ItemVO | 否 | 商品明细 |
2.3 ItemVO
| 名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| outerSkuId | String | 是 | 商品skuid |
| skuName | String | 是 | 商品名称 |
| skuImgUrl | String | 是 | 商品图片 |
| fee | Long | 是 | 单价(单位 分)单个商品 |
| costFee | Long | 是 | 成本价(单位 分) |
| quantity | Long | 是 | 购买数量 |
| taxRate | String | 否 | 税率 |
| taxCode | String | 否 | 税码 |
2.3 响应参数
| 名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| orderId | String | 是 | 宜员订单号，双方对账用 |
| redirectUrl | String | 是 | 跳转地址 |
2.4响应示例(加密前)
{
"custId": 12345,
"outerTradeNo": "order12345",
"payAmountFen": 10000,
"costFeeFen": 8000,
"notifyUrl": "https://yournotifyurl.com",
"expireTime": "2024-10-13T12:00:00",
"originOrderUrl": "https://yourorderdetailurl.com",
"body": "example product",
"itemList": [
{
"outerSkuId": "sku123",
"skuName": "product name",
"skuImgUrl": "https://yourimgurl.com",
"fee": 5000,
"costFee": 4000,
"quantity": 2,
"taxRate": "0.1",
"taxCode": "code123"
}
]
}3.5响应示例（加密后）
{
"code": "0",
"message": "",
"data": {
"orderId": 10000000001,
"redirectUrl": "https://xxxx"
}
}