接口描述
项 | 值 |
url | https://pay.qcloud.com/cpay/unfreeze |
输入参数
参数名 | 必填 | 类型 | 说明 |
request_content | 是 | String | 请求内容,该 string 可以转为 json 结构,json 格式见本节 RequestContent。 |
authen_info | 是 | AuthenInfo | 认证信息,详见接口调用说明。 |
RequestContent 结构
一级参数名 | 二级参数名 | 必填 | 类型 | 说明 |
out_freeze_no | 是 | String(32) | 冻结单号。 | |
| out_unfreeze_no | 是 | String(32) | 解冻单号。 |
| unfreeze_fee | 是 | Number(32) | 解冻金额,金额分。 |
| remark | 否 | String(128) | 解冻备注信息。 |
pay_platform | 是 | Number(32) | 第三方支付类型。 | |
| out_mch_id | 否 | String(32) | 服务商对外账号。 |
| out_sub_mch_id | 否 | String(32) | 子商户对外账号。 |
| out_shop_id | 是 | String(32) | 门店对外账号。 |
| is_sub_mch_admin | 是 | Bool | 操作者是否为商户管理员(此参数是为了校验解冻人身份,操作解冻人必须拥有退款权限。true 代表操作者是商户管理员,该角色默认拥有退款权限。当为 false 时与 authorization_staff_id 配合使用校验退款权限)。 |
| authorization_staff_id | 否 | String(64) | 如果 is_sub_mch_admin 为 false,则此项为必填,如果为 true 则此项不填。 1. 如果当前 staff_id 有退款权限则传自身的 staff_id。 2. 如果是其他人授权则填授权者的 staff_id。 3. 机具调用传机具内配置的 staff_id。 |
order_client | device_id | 是 | String(64) | 子商户自定义,终端设备号。 |
| terminal_type | 是 | Number(32) | 终端类型,1:Windows,2:Andriod,3:iOS,4:Linux,100:其他。 |
| sdk_version | 是 | String(10) | 云支付 SDK 版本号。 |
| spbill_create_ip | 是 | String(16) | 调用云支付 API 的机器 IP。 |
| sn_code | 否 | String(127) | 设备 sn 号。 |
nonce_str | - | 是 | String(32) | 随机字符串。 |
输出参数
参数名 | 必填 | 类型 | 说明 |
response_content | 是 | ResponseContent | 请求内容,详见本节 ResponseContent。 |
authen_info | 否 | AuthenInfo | 认证信息,详见接口调用说明。 |
ResponseContent 结构
参数名 | 必填 | 类型 | 说明 |
status | 是 | Status | 错误码,详见 Status。0:成功;非0:失败。 |
description | 否 | String(255) | 错误描述。 |
log_id | 是 | Number(32) | 消息 ID。 |
internal_status | 是 | Number(32) | 调试使用,调用者可以不予理会。 |
unfreeze | 否 | UnfreezeResponse | authen_info 存在时必填。详见 UnfreezeResponse。 |
UnfreezeResponse 结构
参数名 | 必填 | 类型 | 说明 |
pay_mch_key | 是 | PayMchKey | 支付商户信息,详见公共数据结构 PayMchKey。 |
unfreeze_order_content | 否 | UnfreezeOrderContent | 押金解冻单信息,详见公共数据结构 UnfreezeOrderContent。 |
nonce_str | 是 | String(32) | 随机字符串。 |
示例
输入参数示例:
{"authen_info": {"a": {"authen_type": 1,"authen_code": "7CFA24835EFC1E4349D45BC9E0B821196B5D56F1CDDFB1ED5F23951B159554D5"}},"request_content": "{"pay_mch_key": {"is_sub_mch_admin": false,"out_sub_mch_id": "sz01KzuCUOmw8yjtPite","sub_pay_platform": 100,"out_shop_id": "sz011biKxOguirmBqiFR","authorization_staff_id": "zz123","pay_platform": 1,"out_mch_id": "sz01lXKA6DKGjNzr2l4B"},"unfreeze_content": {"out_unfreeze_no": "sz010002cz11566551626","unfreeze_fee": 10,"remark": "test","out_freeze_no": "sz010002cz11566551329"},"nonce_str": "E94C00688C3F429CA2B0B396BF823548","order_client": {"terminal_type": 1,"sdk_version": "1.0","device_id": "824","spbill_create_ip": "90.0.00.0"}}"}
输出参数示例:
{"response_content": "{"status": 0,"description": "\\u64CD\\u4F5C\\u6210\\u529F\\u3002","log_id": 1733154361,"internal_status": 0,"unfreeze": {"pay_mch_key": {"pay_platform": 1,"out_mch_id": "sz01lXKA6DKGjNzr2l4B","out_sub_mch_id": "sz01KzuCUOmw8yjtPite","out_shop_id": "sz011biKxOguirmBqiFR","sub_pay_platform": 100,"wxpay_pay_mch_key_ext": {"app_id": "wx998fa95558590e1c","sub_app_id": ""}},"unfreeze_order_content": {"out_freeze_no": "sz010002cz11566551329","out_unfreeze_no": "sz010002cz11566551626","trade_type": 1,"nonce_str": "oyuP18zF30egrgKE","create_time": 1566551626,"last_update_time": 1566551627,"is_transforming": false,"unfreeze_fee": 10,"remark": "test","freeze_id": "4200000384201908236723637327","fee_type": "CNY","wxpay_unfreeze_order_content_ext": {"current_trade_state": 2}},"nonce_str": "EM8hO8MOMoPsbRXVEIooCdmgZx5WZ9FZ"}}","authen_info": {"a": {"authen_type": 1,"authen_code": "459BFAD5F0524252F1BBBE12B005ED8C0BB0D97B146B50E3A953A62D677E5AF5"}}}