接口描述
项 | 值 |
url | https://pay.qcloud.com/cpay/query_refund_order |
输入参数
参数名 | 必填 | 类型 | 说明 |
request_content | 是 | String | 请求内容,该 string 可以转为 json 结构,json 格式见本节 RequestContent。 |
authen_info | 是 | AuthenInfo | 认证信息,详见接口调用说明。 |
RequestContent 结构
一级参数名 | 二级参数名 | 必填 | 类型 | 说明 |
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:iOS,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"}}}