接口描述
项 | 值 |
url | https://pay.qcloud.com/cpay/micro_freeze |
输入参数
参数名 | 必填 | 类型 | 说明 |
request_content | 是 | String | 请求内容，该 string 可以转为 json 结构，json 格式见本节 RequestContent。 |
authen_info | 是 | AuthenInfo | 认证信息，详见接口调用说明。 |
RequestContent 结构
一级参数名 | 二级参数名 | 三级参数名 | 必填 | 类型 | 说明 |
out_freeze_no | - | 是 | String(32) | 冻结押金授权单号。 | |
| author_code | - | 是 | String(256) | 刷卡支付授权码。 |
| freeze_fee | - | 是 | Number(32) | 冻结金额，单位：分。 |
| fee_type | - | 是 | String | 冻结货币类型。 |
| body | - | 是 | String(128) | 商品或订单简要描述。 |
| detail | - | 否 | String | 商品详细列表，由 json 转化而来，json 结构见公共结构 Detail。 |
| remark | - | 否 | String | 支付备注信息。 |
| wxpay_freeze_content_ext[1] | attach | 否 | String(127) | 附加数据，记录子商户自定义数据。 |
| | goods_tag | 否 | String(32) | 商品标记，代金券或立减优惠功能的参数。 |
| | limit_pay | 否 | String(32) | 定支付方式，目前只能是 no_credit，指定不能使用信用卡支付。 |
| alipay_freeze_content_ext[1] | enable_pay_channels | 否 | String | 商户指定支付渠道。 |
pay_mch_key | pay_platform | - | 是 | Number(32) | 第三方支付类型。 |
| sub_pay_platform | - | 否 | Number(32) | 第三方支付子类型。 |
| out_mch_id | - | 是 | String(32) | 服务商对外账号。 |
| out_sub_mch_id | - | 是 | String(32) | 子商户对外账号。 |
| out_shop_id | - | 是 | String(32) | 门店对外账号。 |
| wxpay_pay_mch_key_ext[2] | app_id | 否 | String(32) | 微信分配给服务商的公众账号 ID。 |
| | sub_app_id | 否 | String(32) | 微信分配给子商户的公众账号 ID。 |
| alipay_pay_mch_key_ext[2] | user_id | 否 | String(32) | 用户支付宝 user_id。 |
order_client | device_id | - | 是 | String(64) | 子商户自定义，终端设备号。 |
| staff_id | - | 否 | String(64) | 子商户自定义，店员 ID。 |
| terminal_type | - | 是 | Number(32) | 终端类型，1：Windows，2：Andriod，3：iOS，4：Linux，100：其他。 |
| machine_no | - | 是 | String(32) | 每个收银终端的唯一码。 |
| sdk_version | - | 是 | String(10) | 云支付 SDK 版本号。 |
| spbill_create_ip | - | 是 | String(16) | 调用云支付 API 的机器 IP。 |
| sn_code | - | 否 | String(127) | 设备 sn 号。 |
nonce_str | - | - | 是 | String(32) | 随机字符串。 |
注意
1. wxpay_freeze_content_ext 与 alipay_freeze_content_ext 只能填写一个。
2. wxpay_pay_mch_key_ext 与 alipay_pay_mch_key_ext 只能填写一个。
输出参数
参数名 | 必填 | 类型 | 说明 |
response_content | 是 | ResponseContent | 请求内容，详见本节 ResponseContent。 |
authen_info | 否 | AuthenInfo | 认证信息，详见接口调用说明。 |
ResponseContent 结构
参数名 | 必填 | 类型 | 说明 |
status | 是 | Status | 错误码，详见枚举值 Status。此字段仅表示接口调用成功状态，订单状态请以 current_trade_state 字段为准。 |
description | 否 | String(255) | 错误描述。 |
log_id | 是 | Number(32) | 消息 ID。 |
internal_status | 是 | Number(32) | 调试使用，调用者可以不予理会。 |
micro_freeze | 否 | MicroFreezeResponse | authen_info 存在时必填。详见 MicroFreezeResponse。 |
MicroFreezeResponse 结构
参数名 | 必填 | 类型 | 说明 |
freeze_order_content | 是 | FreezeOrderContent | 冻结单信息，详见公共数据结构 FreezeOrderContent。 |
pay_mch_key | 是 | PayMchKey | 支付商户信息，详见公共数据结构 PayMchKey。 |
nonce_str | 是 | String(32) | 随机字符串。 |
示例
输入参数示例：
{"authen_info": {"a": {"authen_type": 1,"authen_code": "35EAA19538EFD9A9A2A22D48AF262F09B774986251231F8F45DA8C7DBF8275D3"}},"request_content": "{"pay_mch_key": {"pay_platform": 1,"sub_pay_platform": 100,"out_shop_id": "1234ruQCleTa9w30AaAH","out_sub_mch_id": "12343ycHpBDv8GX]fmSvT7","out_mch_id": "1234mcWYS3iM5TjKLorAZ"},"nonce_str": "E94C00688C3F429CA2B0B396BF823548","freeze_content": {"author_code": "32323232","body": "body","out_freeze_no": "sz010002cz11564384955","freeze_fee": 10,"fee_type": "CNY"},"order_client": {"staff_id": "1206","machine_no": "00-05-9a-3c-7a-00","terminal_type": 1,"sdk_version": "1.0","device_id": "824","spbill_create_ip": "90.0.00.0"}}"}
输出参数示例：
{"authen_info": {"a": {"authen_type": 1,"authen_code": "3B11C7489804E267C917DBA8508D403A3CF53C895272AC43587A631325629A18"}},"response_content": "{"status": 0,"description": "\\u64CD\\u4F5C\\u6210\\u529F\\u3002","log_id": 1971094428,"internal_status": 0,"micro_freeze": {"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","open_id": "ovJrDwsjamQql-k7Zr1Q-EaKFQ0k"}},"freeze_order_content": {"out_freeze_no": "sz010002cz11564386781","trade_type": 1,"author_code": "134550264496882447","time_expire": 1564386901,"time_end": 1564386782,"create_time": 1564386781,"last_update_time": 1564386783,"is_transforming": false,"freeze_fee": 10,"fee_type": "CNY","cash_fee": 10,"cash_fee_type": "CNY","settlement_total_fee": 10,"body": "body","wxpay_freeze_order_content_ext": {"current_trade_state": 2,"bank_type": "CFT","goods_tag": "X293123"}},"nonce_str": "hFiSO4JaMpDB38qWELxmG45Maue5Wdzp"}}"}