余额支付退款查询接口

本API为后台版接口,用于查询商户单笔余额支付退款状态及明细。

请求参数

  • 请求地址

https://spin.cloudpnr.com/topat/acctPaymentRefundQuery

  • 公共请求参数

请求报文头HEADER - 「接口规则-参数规定-报文头」 ,请求报文体BODY - 「接口规则-参数规定-报文体」

  • 请求参数(data)
参数 中文名 类型 必填 最大长度 说明
req_seq_id 退款请求流水号 String Y 128 退款请求流水号
req_date 退款请求时间 String Y 8 退款请求时间
huifu_id 商户号 String Y 32 商户号

响应参数

  • 同步响应参数(data)
参数 中文名 类型 必填 最大长度 说明
sub_resp_code 业务返回码 String Y 8 业务返回码
sub_resp_desc 业务返回描述 String Y 512 业务返回描述
req_seq_id 业务请求流水号 String Y 128 请求流水号
req_date 业务请求时间 String Y 8 YYYYMMDD
huifu_id 商户号 String Y 32  
product_id 产品号 String N 32  
hf_seq_id 汇付流水号 String N 40  
ord_amt 退款金额 String Y 14 需保留小数点后两位,例如:1.00,最低传入0.01
mer_priv 商户私有域 String N 1024  
acct_split_bunch 退账信息 JSON N   余额支付给一个商户或者同时给多个商户, 当退款时也支持给一个商户 或多个商户同时退款,每个商户退款金额不能超过原入账金额。
org_acct_payment_req_seq_id 原账户支付请求流水号 String N 128  
org_acct_payment_req_date 原账户支付请求日期 String N 8  
org_acct_payment_ord_amt 原账户支付订单金额 String N 14  
org_acct_payment_fee_amt 原账户支付手续费金额 String N 14  
org_acct_payment_total_ref_amt 原账户支付累计退款金额 String N 14  
org_acct_payment_total_ref_fee_amt 原账户支付累计退款手续费金额 String N 14  
org_acct_payment_total_ref_cnt 原账户支付累计退款次数 String N 14  

分账串

参数 中文名 类型 必填 最大长度 说明
acct_infos 退账明细 jsonArray Y   退账明细参见 分账明细

分账明细

huifu_id 退账商户号 String Y 16 退账方商户号
div_amt 退账金额 String Y 12 每个退账商户号需要的退款金额,单位元,需保留小数点后两位,例如:1.00,最低传入0.01
wallet_type 退账账户类型 String N 2 04:钱包户

请求示例

{
    "data": "{\"huifuId\":\"6666000003100616\",\"reqDate\":\"20201216\",\"reqSeqId\":\"9de0da3f4a33438195c51d21fadec46e\"}",
    "sign": "oGPLrLjHxDTWlQRfKM54mSnomwmEcp8yX5NCMDMW066nJEFH1rAzo1XQHnw2zcK9k193Gtgomd5GfbI1/FXSkrIy5yNI7Cpu8R5zGo74K9iW9IvvpyWdvQHEiqoR5px4P/tr4FycGdUhvfgu1CFkEM9sdRr9ga5i1Q5xy2rcKfZjaT4Z6xQ1oKl+Z/Vs8ibEpFZ9m/4YNVgXFkFcjaSSNa/8PLyP2B5oesVks0KR9BbQAynilI983yzUfbcif8PaVHqRU5zoe+XJA6XNr1PusXH6nAm102AbtidBsRLJGF4ZeaqYcuqCUG4XEvcqMox5HnGOfDRbBlBQDitx7YOJ2A==",
    "sign_type": "RSA2",
    "sys_id": "MYPAY"
}

响应示例

{
    "data": "{\"acct_payment_split_bunch\":{\"acct_infos\":[{\"div_amt\":\"2.00\",\"huifu_id\":\"6666000003100618\"}],\"fee_amt\":\"0.01\",\"fee_huifu_id\":\"6666000003100618\"},\"hf_seq_id\":\"0035default201216103033Pa8aea74410ce0e88\",\"huifu_id\":\"6666000003100616\",\"mer_name\":\"盈盈超市\",\"mer_priv\":\"\",\"ord_amt\":\"2.00\",\"org_acct_payment_fee_amt\":\"0.01\",\"org_acct_payment_ord_amt\":\"5.00\",\"org_acct_payment_ord_id\":\"20201215141256defaultL1920808833\",\"org_acct_payment_req_date\":\"20201215\",\"org_acct_payment_req_seq_id\":\"0035default201215141258Pe324a7ed0c93ab83\",\"org_acct_payment_total_ref_amt\":\"5.00\",\"org_acct_payment_total_ref_cnt\":\"com.huifu.topat.dal.entity.AcctTransferDO@553fe912\",\"org_acct_payment_total_ref_fee_amt\":\"0.01\",\"req_date\":\"20201216\",\"req_seq_id\":\"9de0da3f4a33438195c51d21fadec46e\",\"sub_resp_code\":\"00000000\",\"sub_resp_desc\":\"交易成功\",\"trans_stat\":\"S\"}",
    "resp_code": "10000",
    "resp_desc": "成功调用",
    "sign": "e5zxOb+ZnN030oMuxXN1OMzs0obOFun+VNxtEYsUKJxKOk+oLotoGqj2xjkZCE06HiJAraQvcXB8/zQe1Rj8KYD6VAhJGYm1LPrM4aYJb4LJqZ27MABr3FLzlhbn2UD6Gjpim1m/BdmfH98j5qQDT62HtD9sOcfDMnmsDkfvpgKfkxGrvDTla3MFb+kwkPv/yXywu85YeIk5lsnqMy/zZoUW4XcpmblWhkg7q1XofXHNXESm4kDZFLxloEdnpr121367Pb1pfjqJe/p6xI26oouhxweh7p2gSq5BEXXZBV3tsP/Jr7NiFLX5IT1k6V8gkfJ2ruVkPomgBQh9S1fWwA==",
}

接口调用示例

Demo参考