退款查询API

业务功能
提交退款申请后，通过调用该接口查询退款状态。
测试url：
http://47.95.131.62:8080/api/v1/pay/polymeric/refundquery

请求参数(O-非必传 ,M-必传):

参数	参数名称	类型	参数说明	样例	可空
refund_no	退款订单号	String	refund_no和 out_refund_no和channel_trade_no必传其中一个，三个都传则以refund_no为准，推荐使用refund_no		O
out_refund_no	服务商退款订单号	String	服务商退款订单号	161018121614000624679888	O
channel_trade_no	凭证条码订单号	String	凭证条码订单号(v1.24增加)	161018121614000624679888	O

请求示例:

{
    "accessid": "cpostest",
    "refund_no": "AL190506165352286000440521",
    "sign": "360E31C56BA570DA7782791D3D26E6AE"
}

返回参数:

参数	参数名称	类型	参数说明	样例	可空
refund_amount	退款金额	String	退款金额，以元为单位	100	M
total_amount	订单金额	String	订单总金额，以元为单位	100	M
rate	费率	String			M
fee	手续费	String			M
refund_status	退款状态	int	退款结果: 1：成功（退款申请接收成功，退款的到账时间以实际为准）； 2：失败（退款申请失败，错误原因参考status_msg）； 3：结果未知（退款申请处理结果未知,请调用退款查询接口获取退款结果状态） 4：交易超时		M
refund_no	退款订单号	String	SaaS平台的退款订单编号		M
out_refund_no	服务商退款订单号	String	服务商退款订单号	161018121614000624679888	M
channel_trade_no	凭证条码订单号	String	凭证条码订单号(v1.24增加)	161018121614000624679888	M
error_code	错误码	String			O
error_msg	错误消息	String			O
trade_end_time	SaaS平台交易完成时间	String	SaaS平台交易完成时间，交易完成以后会返回	2019-11-18 14:11:23	O
refunded_amount	已退款金额	String	已退款金额(v1.30增加)		M
remanent_amount	剩余可退款金额	String	剩余可退款金额(v1.30增加)		M
fee_subsidy_party	手续费原补贴方	String	手续费原补贴方		O
orig_fee_subsidy_amount	原交易手续费补贴金额	String	原交易手续费补贴金额	原交易手续费补贴金额	C
refunded_subsidy_amount	已退手续费补贴金额	String	已退手续费补贴金额	已退手续费补贴金额	C
remanent_subsidy_amount	剩余未退手续费补贴金额	String	剩余未退手续费补贴金额	剩余未退手续费补贴金额	C
real_fee_subsidy_amount	本次手续费实际退补金额	String	本次手续费实际退补金额		C
attach	支付宝/微信/银联原生参数	JSON			O

微信原生参数:attach

参数	参数名称	类型	参数说明	样例	可空
sub_appid	子商户公众账号id	String	调用接口提交的子商户公众账号ID	wx8888888888888888	O
sub_mch_id	子商户号	String	调用接口提交的子商户号	1900000109	M
out_refund_no	商户退款单号	String	商户系统内部的退款单号，商户系统内部唯一，只能是数字、大小写字母同一退款单号多次请求只退一笔		M
refund_id	微信退款单号	String			M
refund_fee	退款金额	String	退款总金额,单位为分,可以做部分退款		M
refund_fee_type	退款货币种类	String		CNY	M
cash_refund_fee	现金退款金额	String	现金退款金额，单位为分，只能为整数		M
coupon_refund_fee	代金券退款总金额	String			O
refund_detail	优惠退款详情	JSONArray		[{“amount”:100,”promotion_id”:”21796722069”,”type”:”COUPON”,”scope”:”GLOBAL”,”refund_amount”:100}]	O

优惠退款详情:refund_detail

参数	参数名称	类型	参数说明	样例	可空
promotion_id	券ID	String	券或者立减优惠id	109519	M
scope	优惠范围	String	GLOBAL-全场代金券 SINGLE-单品优惠	SINGLE	O
type	优惠类型	String	COUPON-代金券，需要走结算资金的充值型代金券,（境外商户券币种与支付币种一致） DISCOUNT-优惠券，不走结算资金的免充值型优惠券，（境外商户券币种与标价币种一致)	DISCOUNT	O
amount	优惠券面额	String	用户享受优惠的金额	5	O

支付宝原生参数:attach

参数	参数名称	类型	参数说明	样例	可空
trade_no	银联/网联交易号	String		2013112011001000000121536	M
out_trade_no	原支付订单的商户订单号	String	原支付订单的商户订单号，32个字符以内、可包含字母、数字、下划线；需保证在商户端不重复	20150320010101000121223452324110	M
open_id	买家支付宝用户号	String	买家支付宝用户号,该参数已废弃，请不要使用	2088102122524330	M
buyer_logon_id	用户的登录id	String	用户的登录id	159****5620	M
fund_change	本次退款是否发生了资金变化	String		Y	M
refund_fee	退款总金额	String	单位：元		M
refund_currency	退款币种信息	String		CNY	O
gmt_refund_pay	退款支付时间	Date		2014/11/27 15:45:57	M
refund_detail_item_list	退款使用的资金渠道	JSONArray			O
store_name	交易在支付时候的门店名称	String		望湘园联洋店	O
buyer_user_id	买家在支付宝的用户id	String		2088101117955611	M
send_back_fee	本次商户实际退回金额	String			O
present_refund_buyer_amount	本次退款金额中买家退款金额	String			O
present_refund_discount_amount	本次退款金额中平台优惠退款金额	String			O
present_refund_mdiscount_amount	本次退款金额中商家优惠退款金额	String			O

资金渠道:refund_detail_item_list

参数	参数名称	类型	参数说明	样例	可空
amount	该支付工具类型所使用的金额	String			M
bank_code	银行卡支付时的银行代码	String		CEB	O
fund_channel	交易使用的资金渠道	String		ALIPAYACCOUNT	M
real_amount	渠道实际付款金额	String			O
fund_type	渠道所使用的资金类型	String	目前只在资金渠道(fund_channel)是银行卡渠道(BANKCARD)的情况下才返回该信息(DEBIT_CARD:借记卡,CREDIT_CARD:信用卡,MIXED_CARD:借贷合一卡)		O

银联原生参数:attach

参数	参数名称	类型	参数说明	可空
acqAddnData	收款方附加数据	String	BASE64加密后的字符串	M
issAddnData	付款方附加数据	String	BASE64加密后的字符串	M
couponInfo	优惠类信息(银联单品券时使用)	String	BASE64加密后的字符串，解码后为JSONArray	M

银联二维码优惠信息:couponInfo

参数	参数名称	类型	参数说明	可空
spnsrId	出资方	String	银联作为出资方：固定填写00010000；付款方作为出资方：填写 8 位付款方机构代码商户作为出资方：填写 15 位商户代码(银联商户号)。	M
offstAmt	优惠金额	String	以分为单位	M
currencyCode	货币类型	String	固定：156代表人民币	O
id	项目编号	String	用于票券编号等，格式自定义	O
desc	优惠活动简称	String	可用于展示、打单等	O
addnInfo	附加信息	String		O

返回示例:

{
    "total_amount": 0.01,
    "refund_no": "AL190506165352286000440521",
    "out_refund_no": "201905060000001",
    "channel_trade_no": "201905060000001",
    "refund_amount": -0.01,
    "refund_status": 1,
    "return_code": 10000,
    "sign": "6FD78920B1D89959103ED8A5615ADC06"
}

文档更新时间: 2025-02-11 11:18 作者：admin