查询退款单

最近更新时间:2019-11-08 15:13:14

接口描述

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

输入参数

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

RequestContent 结构

一级参数名 二级参数名 必填 类型 说明
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) 门店对外帐号。
order_client device_id String(64) 子商户自定义,终端设备号。
terminal_type Number(32) 终端类型,1:windows,2:andriod,3:iso,4:linux,100:其他。
sdk_version String(10) 云支付 SDK 版本号。
spbill_create_ip String(16) 调用云支付 API 的机器 IP。
out_trade_no - String(32) 订单号。
out_refund_no - String(32) 退款单号。
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) 调试使用,调用者可以不予理会。
query_refund_order QueryRefundOrderResponse authen_info 存在时必填。详见 QueryRefundOrderResponse。

QueryRefundOrderResponse 结构

参数名 必填 类型 说明
pay_mch_key PayMchKey 支付商户信息,status 为0时必填。详见公共数据结构 PayMchKey。
refund_order_content RefundOrderContent[] 退款单信息列表,详见公共数据结构 RefundOrderContent。
order_client OrderClient 详见公共数据结构 OrderClient。
nonce_str String(32) 随机字符串。

示例

输入参数示例:

{
    "authen_info": {
        "a": {
            "authen_type": 1,
            "authen_code": "1068AA0F2CBEBEAEC3DA1115C32EBE54B303A65A64264BCA1D89564E1D9F004D"
        }
    },
    "request_content": "{
        "pay_mch_key": {
            "pay_platform": 1,
            "sub_pay_platform": 100,
            "out_shop_id": "sz011biKxOguirmBqiFR",
            "out_sub_mch_id": "sz01KzuCUOmw8yjtPite",
            "out_mch_id": "sz01lXKA6DKGjNzr2l4B"
        },
        "nonce_str": "E94C00688C3F429CA2B0B396BF823548",
        "out_trade_no": "sz010002cz11566803216",
        "out_refund_no": "sz010002cz11566825386",
        "order_client": {
            "staff_id": "1192",
            "machine_no": "1111",
            "terminal_type": 1,
            "sdk_version": "1.0",
            "device_id": "12345",
            "spbill_create_ip": "90.0.00.0"
        }
    }"
}

输出参数示例:

{
    "response_content": "{
        "status": 0,
        "description": "\u64CD\u4F5C\u6210\u529F\u3002",
        "log_id": 3594950898,
        "internal_status": 0,
        "query_refund_order": {
            "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": ""
                }
            },
            "refund_order_content": [{
                "out_refund_no": "sz010002cz11566825386",
                "refund_id": "50000301352019082611769933385",
                "trade_type": 1,
                "out_trade_no": "sz010002cz11566803216",
                "nonce_str": "E94C00688C3F429CA2B0B396BF823548",
                "create_time": 1566825387,
                "last_update_time": 1566825394,
                "is_transforming": false,
                "refund_success_time": 0,
                "refund_reason": "test\n\u64CD\u4F5C\u8005\uFF1A1206\n\u6388\u6743\u8005\uFF1Ahaha",
                "total_fee": 1,
                "refund_fee": 1,
                "refund_fee_type": "CNY",
                "exchange_rate": 100000000,
                "client_refund_flow_id": "",
                "settlement_refund_fee": 1,
                "trade_state": 4,
                "wxpay_refund_order_content_ext": {
                    "state": 2,
                    "cash_refund_fee": 1,
                    "coupon_refund_fee": 0,
                    "coupon_refund_count": 0,
                    "refund_account": "REFUND_SOURCE_UNSETTLED_FUNDS",
                    "refund_channel": "ORIGINAL",
                    "refund_recv_account": "\u652F\u4ED8\u7528\u6237\u7684\u96F6\u94B1"
                }
            }],
            "nonce_str": "BrHluqCW9T5GHiaOJqwnTprbatoCrlIF",
            "order_client": [{
                "shop_id": "432",
                "device_id": "824",
                "staff_id": "1206",
                "machine_no": "1111",
                "terminal_type": 1,
                "sdk_version": "1.0",
                "spbill_create_ip": "90.0.00.0",
                "sub_terminal_type": 0
            }]
        }
    }",
    "authen_info": {
        "a": {
            "authen_type": 1,
            "authen_code": "18C23A91D494E809EB34C392B2EC5B9CAD4D5B9BD716FB0E14F805278B0BD36F"
        }
    }
}