条码支付综合前置平台
业务功能
提交退款申请后， 通过调用该接口查询退款状态。 退款有一定延时， 请在 3 个工作日后
重新查询退款状态。
请求参数
请求url：https://qra.95516.com/pay/gateway
POST XML 内容体进行请求
字段名 | 变量名 | 必填 | 类型 | 说明 |
接口类型 | service | 是 | String(32) | 接口类型：unified.trade.refundquery |
版本号 | version | 否 | String(8) | 版本号，version默认值是2.0。 |
字符集 | charset | 否 | String(8) | 可选值 UTF-8 ，默认为 UTF-8。 |
签名方式 | sign_type | 否 | String(8) | 签名类型，取值范围： MD5（默认）； SM3； |
商户号 | mch_id | 是 | String(15) | 商户号，由平台分配 |
商户订单号 | out_trade_no | 否 | String(32) | 商户系统内部的订单号, out_trade_no和transaction_id至少一个必填，同时存在时transaction_id优先 |
平台订单号 | transaction_id | 否 | String(32) | 平台单号, out_trade_no和transaction_id至少一个必填，同时存在时transaction_id优先 |
商户退款单号 | out_refund_no | 否 | String(32) | 商户退款单号，32个字符内、可包含字母,确保在商户系统唯一。 |
平台退款单号 | refund_id | 否 | String(32) | 平台退款单号关于refund_id、out_refund_no、out_trade_no 、transaction_id 四个参数必填一个， 如果同时存在优先级为：refund_id>out_refund_no>transaction_id>out_trade_no特殊说明：如果是银联二维码、支付宝，refund_id、out_refund_no必填其中一个 |
随机字符串 | nonce_str | 是 | String(32) | 随机字符串，不长于 32 位 |
签名 | sign | 是 | String(32) | MD5签名结果，详见“安全规范” |
授权交易机构 | sign_agentno | 否 | String(12) | 授权交易的服务商机构代码，商户授权给服务商交易的情况下必填，签名使用服务商的密钥 |
连锁商户号 | groupno | 否 | String(15) | 连锁商户为其下门店发交易的情况必填，签名使用连锁商户的密钥 |
返回结果
数据按XML的格式实时返回
字段名 | 变量名 | 必填 | 类型 | 说明 | |
版本号 | version | 是 | String(8) | 版本号，version默认值是2.0。 | |
字符集 | charset | 是 | String(8) | 可选值 UTF-8 ，默认为 UTF-8。 | |
签名方式 | sign_type | 否 | String(8) | 签名类型，取值范围： MD5（默认）； SM3； | |
授权交易机构 | sign_agentno | 否 | String(12) | 授权交易的服务商机构代码，商户授权给服务商交易的情况下返回，签名使用服务商的密钥 | |
连锁商户号 | groupno | 否 | String(15) | 连锁商户为其下门店发交易的情况返回，签名使用连锁商户的密钥 | |
返回状态码 | status | 是 | String(16) | 0表示成功非0表示失败此字段是通信标识，非交易标识，交易是否成功需要查看 result_code 来判断 | |
返回信息 | message | 否 | String(128) | 返回信息，如非空，为错误原因签名失败参数格式校验错误 | |
网关返回码 | code | 否 | String(32) | 网关返回码 | |
以下字段在 status 为 0的时候有返回 | |||||
业务结果 | result_code | 是 | String(16) | 0表示成功，非0表示失败 | |
商户号 | mch_id | 是 | String(15) | 商户号，由平台分配 | |
设备号 | device_info | 否 | String(32) | 终端设备号 | |
随机字符串 | nonce_str | 是 | String(32) | 随机字符串，不长于 32 位 | |
错误代码 | err_code | 否 | String(32) | 具体错误码请看文档最后错误码列表 | |
签名 | sign | 是 | String(32) | MD5签名结果，详见“安全规范” | |
以下字段在 status 和 result_code 都为 0的时候有返回 | |||||
平台订单号 | transaction_id | 是 | String(32) | 平台交易号 | |
商户订单号 | out_trade_no | 是 | String(32) | 商户系统内部的订单号 | |
退款笔数 | refund_count | 是 | Int | 退款记录数 | |
商户退款单号 | out_refund_no_$n | 是 | String(32) | 商户退款单号 | |
平台退款单号 | refund_id_$n | 是 | String(32) | 平台退款单号 | |
退款渠道 | refund_channel_$n | 是 | String(16) | ORIGINAL—原路退款，默认 | |
退款金额 | refund_fee_$n | 是 | Int | 退款总金额,单位为分,可以做部分退款 | |
现金券退款金额 | coupon_refund_fee_$n | 否 | Int | 现金券退款金额 <= 退款金额， 退款金额-现金券退款金额为现金,单位为分 | |
免充值优惠金额 | mdiscount_$n | 否 | Int | 免充值优惠金额 + 充值优惠金额=现金劵退款金额（coupon_refund_fee_$n）,单位为分 | |
退款时间 | refund_time_$n | 否 | String(14) | yyyyMMddHHmmss | |
交易类型 | trade_type | 是 | String(32) | pay.weixin.micropay——微信被扫支付 pay.alipay.micropay——支付宝被扫支付 pay.unionpay.micropay――银联被扫支付 | |
退款状态 | refund_status_$n | 是 | String(16) | SUCCESS—退款成功 FAIL—退款失败 PROCESSING—退款处理中 NOTSURE—未确定， 需要商户原退款单号重新发起 CHANGE—转入代发，退款到银行发现用户的卡作废或者冻结了，导致原路退款银行卡失败，资金回流到商户的现金帐号，需要商户人工干预，通过线下或者平台转账的方式进行退款。 | |
银联交易主键 | settle_key_$n | 否 | String(38) | 仅银联二维码交易有该字段信息 | |
$n 表示记录的序号，取值为 0~($ refund_count -1)，例如 refund_count 指示返回的退款记录有 2 条。第一条序号为“0”，第二条序号为“1”。 | |||||