4.1.7完结支付分服务单


使用场景:完结支付分服务单

接口编号: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,无返回业务参数


yinjr 2024年7月30日 15:17 收藏文档