完结租借订单
接口说明
| 接口url | https://api.mch.weixin.qq.com/wxv/finishrentbill |
|---|---|
请求方式 |
POST |
传输格式 |
XML |
注意事项
- 当返回错误码为“SYSTEMERROR”时，请不要更换商户订单号，一定要使用原商户订单号重试，否则可能造成重复支付等资金风险。
- XML具有可扩展性，因此返回参数可能会有新增，而且顺序可能不完全遵循此文档规范，如果在解析回包的时候发生错误，请商户务必不要换单重试，请商户联系客服确认付款情况。如果有新回包字段，会更新到此API文档中。
- 因为错误代码字段err_code的值后续可能会增加，所以商户如果遇到回包返回新的错误码，请商户务必不要换单重试，请商户联系客服确认付款情况。如果有新的错误码，会更新到此API文档中。
- 错误代码描述字段err_code_des只供人工定位问题时做参考，系统实现时请不要依赖这个字段来做自动化处理。
是否需要证书
是，详见证书说明
前置条件
用户确认使用业务后
请求参数
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 接口版本号 | version | 是 | String(32) | 1.0 | 接口版本号，默认值1.0 |
| 公众账号ID | appid | 是 | String(32) | wxd678efh567hg6787 | 微信公众平台分配的与传入的商户号建立了支付绑定关系的appid，可在公众平台查看绑定关系. 需要在本系统先进行配置. 需要与创建订单时保持一致. |
| 商户号 | mch_id | 是 | String(32) | 1230000109 | 微信支付分配的商户号. 需要在本系统先进行配置. 需要与创建订单时保持一致. |
| 随机字符串 | nonce_str | 是 | String(32) | ibuaiVcKdpRxkhJA | 随机字符串，长度要求在32位以内。推荐随机数生成算法 |
| 签名 | sign | 是 | String(128) | 029B52F67573D7E3BE74904BF9AEA | 通过签名算法计算得出的签名值，详见签名生成算法 |
| 签名类型 | sign_type | 是 | String(32) | HMAC-SHA256 | 签名类型，仅支持HMAC-SHA256 |
| 商户服务订单号 | out_order_no | 是 | String(32) | 1234323JKHDFE1243252 | 商户系统内部订单号（不是交易单号），要求32个字符内，只能是数字、大小写字母_-|* 且在同一个商户号下唯一。详见商户订单号 需要和创建租借订单的商户服务订单号一致 |
| 服务ID | service_id | 是 | String(32) | 该服务ID有本接口对应产品的权限. 需要与创建订单时保持一致. | |
| 是否归还 | returned | 是 | String(32) | TRUE | 是否归还 已归还:TRUE、 没归还:FALSE |
| 实际归还时间 | real_end_time | 否 | String(14) | 20091225091010 | 【是否归还】字段填写TRUE时必须填写, 否则不允许填写。订单生成时间，支持两种格式:yyyyMMddHHmmss和yyyyMMdd，如2009年12月25日9点10分10秒表示为20091225091010或者20091225.传入20091225默认时间为2009年12月25日23点59分59秒 |
| 归还地点 | service_end_location | 否 | String(30) | 嗨客时尚主题展餐厅 | 支持30个字符，按照字符计算 超过长度报错处理 表示用户归还物品的地点，线下相关服务可填写 |
| 总金额 | total_amount | 是 | int | 40000 | 总金额,单位:分 不能超过创建订单时候的押金金额 总金额需要等于租金金额和赔偿金金额之和 |
| 租金费用 | rent_fee | 二选一 | int | 5800 | 赔偿金费用和租金金额二者必须填写其中一个。赔偿金费用和赔偿金费用说明必须一起填写，单位：分 必须>=0，=0代表不需要扣费 |
| 赔偿金费用 | compensation_fee | int | 6000 | 赔偿金费用和租金金额二者必须填写其中一个。赔偿金费用和赔偿金费用说明必须一起填写，单位：分 必须>0，传入表示需要扣赔偿金 传入表示需要扣赔偿金 物品已归还——用户对物品产生了破坏行为造成的损失费用。 物品未归还——未还物品费用。 传入为0报错. | |
| 赔偿金费用说明 | compensation_fee_desc | String(30) | 充电宝有轻微损坏，赔偿30%押金 | 支持30个字符，按照字符计算 超过长度报错返回 | |
| 完结凭证 | finish_ticket | 是 | String(512) | 用于完结订单时传入,确保订单完结时数据完整. 需要确保和确认订单接口完全一致 需对字段再做处理。 （注意：该字段可通过查询订单或者用户确认使用服务回调里获取finish_ticket，finish_ticket是支付分用来校验的参数，商户不可自定义） |
|
| 分账标识 | profit_sharing | 是 | String(16) | Y | Y-是，需要分账 N-否，不分账 字母要求大写，不传默认不分账 |
返回参数
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 返回状态码 | return_code | 是 | String(16) | SUCCESS | SUCCESS/FAIL 此字段是通信标识，非业务标识，是否成功需要查看result_code来判断 |
| 返回结果 | return_msg | 否 | String(128) | 签名失败 | 返回信息，如非空，为错误原因，如签名失败，参数格式校验错误 |
以下字段在return_code为SUCCESS的时候有返回
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 签名 | sign | 是 | String(128) | 029B52F67573D7E3BE74904BF9A | 通过签名算法计算得出的签名值，详见签名生成算法 |
| 随机字符串 | nonce_str | 是 | String(32) | ibuaiVcKdpRxkhJA | 随机字符串，长度要求在32位以内。推荐随机数生成算法 |
| 业务结果 | result_code | 是 | String(16) | SUCCESS | SUCCESS/FAIL 完结成功返回SUCCESS,否则返回FAIL. FAIL情况需要根据err_code进行不同处理. |
| 错误代码 | err_code | 否 | String(32) | SYSTEMERROR | 错误码，详见错误码说明 |
| 错误描述 | err_code_des | 否 | String(128) | 系统错误 | 错误信息描述 |
| 公众账号ID | appid | 是 | String(32) | wxd678efh567hg6787 | 调用接口提交的公众账号ID |
| 商户号 | mch_id | 是 | String(32) | 1230000109 | 微信支付分配的商户号 |
| 商户服务订单号 | out_order_no | 是 | String(32) | 1234323JKHDFE1243252 | 调用接口提交的商户服务订单号 |
| 服务ID | service_id | 是 | String(32) | 调用该接口提交的服务ID |
以下字段当return_code、result_code都为SUCCESS时有返回
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 微信支付服务订单号 | order_id | 是 | String(128) | 微信支付服务订单号 每个微信支付服务订单号与商户号下对应的商户服务订单号一一对应 |
错误码
| 名称 | 描述 | 原因 | 解决方案 |
|---|---|---|---|
| SYSTEMERROR | 系统错误 | 系统超时 | 系统异常，请使用相同参数稍后重新调用 |
| PARAM_ERROR | 参数错误 | 请求参数不合法 | 请使用正确的参数重新调用 |
| INVALID_REQUEST | 无效的请求 | 商户没有接口权限 重入情况下参数不一致 | 请申请接口权限 请确认相同单号是否使用了不同的参数 |
| CANCELED | 单据已撤销 | 已撤销单据不可以完结 | 确认入参,传入正确单据 |
| ORDERNOTEXIST | 单据不存在 | 查询单据不存在 | 确认入参,传入正确单据 |
| RATE_LIMITED | 频率限制 | 超过接口调用频率限制 | 请求量不要超过XX/XX |