退款查询API

业务功能
提交退款申请后，通过调用该接口查询退款状态。
测试url：
http://47.95.131.62:8080/api/v1/pay/ali/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": "AL200325115447124394374306",
    "sign": "99583A2FF9DED1690EFCC93D191570F1"
}

返回参数:

参数 参数名称 类型 参数说明 样例 可空
refund_amount 退款金额 String 退款金额，以元为单位 100 M
total_amount 订单金额 String 订单总金额，以元为单位 100 M
rate 费率 String M
fee 手续费 String M
refund_status 退款状态 int 退款结果:

1：成功（退款申请接收成功，退款的到账时间以实际为准）；

2：失败（退款申请失败，错误原因参考status_msg）；

3：结果未知（退款申请处理结果未知,请调用退款查询接口获取退款结果状态）

 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
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
参数 参数名称 类型 参数说明 样例 可空
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
code 网关返回码 String 40004 M
msg 网关返回码描述 String Business Failed M
sub_code 网关明细返回码 String isv.invalid-signature O
sub_msg 网关明细返回码描述 String 交易已被支付 O
sign 签名 String M
资金渠道: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

返回示例:

{
    "total_amount": "1.00",
    "refund_no": "AL200325115447124394374306",
    "out_refund_no": "200325362290000005021",
    "channel_trade_no": "010920032511541297596MC",
    "refund_amount": "-0.50",
    "refund_status": 1,
    "remanent_amount": "0.50",
    "refunded_amount": "0.50",
    "return_code": 10000,
    "sign": "DC93053B654463D87F0CB75D86E45A02"
}
文档更新时间: 2025-02-11 11:05   作者：admin