使用场景:完结支付分服务单
接口编号:serviceordercomplete
请求参数(bizdata):
参数 | 参数名称 | 取值 | 可空 | 类型 | 备注 |
---|---|---|---|---|---|
out_order_no | 商户订单号 |
商户系统内部服务订单号(不是交易单号) 要求32个字符内,只能是数字、大小写字母 且在同一个商户号下唯一 |
否 | String(32) | |
post_payments | 后付费项目 |
后付费项目列表,最多包含100条付费项, 用于用户侧展示与完结订单时的总金额计算创建订单接口: 1.name是选填; 2.若name非空: amount和description,二者必须填其一,也可同时填写; 完结订单接口: 1. name和amount是必填; |
否 | array | 格式见创建服务单 |
post_discounts | 商户优惠 |
body商户优惠列表,最多包含30条商户优惠 用于用户侧展示与完结订单时的总金额计算创建订单接口: 1.name和description是选填,但是要填写的话,须同时填写; 完结订单接口: 1.若name和description非空,amount金额必填; 2. 优惠项目名称可以重复 3. 订单优惠项目,均以完结订单传入的信息为准; |
是 | array | 格式见创建服务单 |
total_amount | 总金额 |
1.金额:数字,必须≥0(单位:分) 2. 总金额 =(付费项目1+...+付费项目n)-(商户优惠1+…+完结商户优惠n) 3. 总金额上限 1)【评估不通过:交押金】模式:总金额≤创单时填写的“订单风险金额” 2)【评估不通过:拒绝】模式:总金额≤“服务风险金额” 示例值:50000 |
否 | int64 | |
time_range | 实际服务时间 | 实际服务时间,创建订单未填写服务结束时间,则完结的时候,服务结束时间必填 | 是 | object | 格式见创建服务单 |
complete_time | 完结服务时间 |
body时间使用ISO 8601所定义的格式 示例: YYYY-MM-DDTHH:mm:ss.SSSZ YYYY-MM-DDTHH:mm:ssZ YYYY-MM-DDTHH:mm:ss.SSS+08:00 YYYY-MM-DDTHH:mm:ss+08:00 示例值:2019-11-11T16:24:05+08:00 |
String(64) | ||
location | 实际服务位置 | 实际服务位置,覆盖创建订单时的服务位置,用于用户端展示 | 是 | object | 格式见创建服务单 |
响应参数(bizrsp):
处理成功,状态码为204,无返回业务参数
错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
500 | SYSTEM_ERROR | 系统错误 | 5开头的状态码都为系统问题,请使用相同参数稍后重新调用 |
400 | PARAM_ERROR | 参数错误 | 根据错误提示,传入正确参数 |
403 | NO_AUTH | 商户信息不合法 | 登录商户平台核对,传入正确信息 |
429 | FREQUENCY_LIMITED | 频率超限 | 请求量不要超过接口调用频率限制 |
400 | INVALID_REQUEST | 请求参数符合参数格式,但不符合业务规则 | 请确认相同单号是否使用了不同的参数 |
404 | ORDER_NOT_EXIST | 订单不存在 | 确认入参,传入正确单据 |
400 | INVALID_ORDER_STATE | 单据状态错误 | 确认操作是否符合流程 |
400 | ORDER_CANCELED | 单据已取消 | 当前状态无需操作 |
400 | ORDER_DONE | 订单已完成 | 当前状态无需操作 |
请求样例:
{
"out_order_no": "1234323JKHDFE1243252",
"complete_time": "2019-11-11T16:24:05+08:00",
"location": {
"end_location": "嗨客时尚主题展餐厅",
"start_location": "嗨客时尚主题展餐厅"
},
"post_discounts": [
{
"amount": 100,
"count": 2,
"description": "不与其他优惠叠加",
"name": "满20减1元"
}
],
"post_payments": [
{
"amount": 40000,
"count": 4,
"description": "就餐人均100元",
"name": "就餐费用"
}
],
"time_range": {
"end_time": "20091225121010",
"end_time_remark": "备注2",
"start_time": "20091225091010",
"start_time_remark": "备注1"
},
"total_amount": 50000
}
返回样例:
处理成功,状态码为204,无返回业务参数