有奖捉虫:行业应用 & 管理与支持文档专题 HOT

接口描述

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"  
        }  
    }  
}