余额支付退款接口¶

本API为后台版接口，用于支持余额支付成功交易的全额或部分退款。

请求参数¶

请求地址

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

公共请求参数

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

请求参数(data)

参数	中文名	类型	必填	最大长度	说明
req_seq_id	请求流水号	String	Y	128	请求流水号
req_date	请求时间	String	Y	8	请求时间YYYYMMDD
huifu_id	商户号	String	Y	32	商户号
mer_priv	商户私有域	String	N	1024	商户私有域
org_req_seq_id	原交易请求流水号	String	Y	128	原交易请求流水号
org_req_date	原交易请求时间	String	Y	8	原交易请求时间
ord_amt	退款金额	String	Y	14	单位元，需保留小数点后两位，例如：1.00,最低传入0.01
acct_split_bunch	退账信息	JSON	N	1024
risk_check_info	风控信息	String	N	32	风控信息例如: “{“subProduct”:”“,”transferType”:”“}”

退账信息¶

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

退账明细¶

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

风控信息¶

参数	中文名	类型	必填	最大长度	说明
subProduct	产品子类	String	N		产品子类
transferType	转账原因	String	Y		转账原因

响应参数¶

响应参数（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
org_req_seq_id	原交易请求流水号	String	Y	128	原交易请求流水号
org_req_date	原交易请求时间	String	Y	8	原交易请求时间
trans_stat	交易状态	String	N	1	S：成功；F：失败；P：处理中
mer_priv	商户私有域	String	N	1024
acct_split_bunch	退账信息	JSON	N		返回分账串

请求示例¶

{
    "data": "{\"huifu_id\":\"6666000103423237\",\"ord_amt\":\"5.00\",\"org_req_date\":\"20201228\",\"org_req_seq_id\":\"483f419389044e50818c252e8311dbcf\",\"req_date\":\"20210202\",\"req_seq_id\":\"fda52290a1ec415d8a3b7d63233a1d5f\",\"risk_check_info\":\"{\\\"sub_product\\\":\\\"一卡通\\\",\\\"transfer_type\\\":\\\"01\\\"}\",\"sys_id\":\"TOP\"}",
    "sign": "ipccrpxGsIFEtpXUwBZcd2g0PzgXlXbahoULuMXS0R9HMuPvj0zDbj5WZ9zgWe5L32+5wFKJfBBcODGC2fsgvorKm4vNkBNf0AhdXhrhVflcbmal6tI0n+d2JH1j0TbCj5ZVqSKWA+l2Y3vZ0hvei8oVtfUswY9Ip0KtqvKBEXMTl4DGcFluIa9JYL8prciEcyKKzl603qRrdKI2u3AknFjSr69EWcUld5C10ILGeeNB18XlS3zKMaIgrlNtz8gIO1bTKEtNf66jbtdbeAji8861z3rOIZnlXnqYq8O6LPtJaFWaUrhsbtCzv3biu+KlZio/vjDhpGimHFtCARjxwQ==",
    "sign_type": "RSA2",
    "sys_id": "MYPAY"
}

响应示例¶

{
    "data": "{\"huifu_id\":\"6666000103423237\",\"ord_amt\":\"5.00\",\"org_req_date\":\"20201228\",\"org_req_seq_id\":\"483f419389044e50818c252e8311dbcf\",\"req_date\":\"20210202\",\"req_seq_id\":\"fda52290a1ec415d8a3b7d63233a1d5f\",\"sub_resp_code\":\"10000002\",\"sub_resp_desc\":\"退款金额大于可退金额\"}",
    "resp_code": "10000",
    "resp_desc": "成功调用",
    "sign": "GT0lf+02YjYkDVUaU8PNE5N3d34l1Nm/OX7mVEazvspA37JdHtRldTTotS7GKAVVhXIGHE7FhC+1tLTTjem5CvGc5jn2sVvSQ5cIdEYNEcY9B8OM5fhAHqr0CiapwWEEKedb/wu5rQxraAPX6x+cMsoSXMCFtN0VDhmDRKWId2v6dmYdoRsZFFz1B5N9CQIAihIKtq7p3I+h6+Q50acq5ozbWsxBb06Xfp4LfKcc5sP1BEEIy48ck5ntxbWI8MmxTeq/3b8EnsGwmN9JtaEy5SAmK5iivAKlF2M0XrV0apKnDctYCt2vODB8Z8+i4wuONYg9M7+HgF0cWAUpqKS5qQ==",
}

接口调用示例¶

Demo参考