刷卡押金冻结

最近更新时间:2019-10-09 10:36:43

接口描述

url https://pay.qcloud.com/cpay/micro_freeze

输入参数

参数名 必填 类型 说明
request_content String 请求内容,该 string 可以转为 json 结构,json 格式见本节 RequestContent。
authen_info AuthenInfo 认证信息,详见接口调用说明。

RequestContent 结构

     
一级参数名 二级参数名 三级参数名 必填 类型 说明
freeze_content 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:iso,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"
        }
    }"
}