退款查询API

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

返回参数:

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

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
market_subsidy_info 营销补贴退款信息 JSONArray 此笔退款交易的营销补贴信息 O
attach 银联原生参数 JSON O
营销补贴信息:market_subsidy_info
参数 参数名称 类型 参数说明 样例 可空
party 营销补贴账户 String 在海科开通的营销补贴账户号 M
amt 营销补贴金额 String 营销补贴金额(单位:元) 20 M
银联原生参数: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": "UN200325150912612610564378",
    "out_refund_no": "2020032515091288888888",
    "refund_amount": "-0.01",
    "refund_status": 1,
    "remanent_amount": "0",
    "refunded_amount": "0.01",
    "return_code": 10000,
    "sign": "86A52258A3E1953F67D29E43F2F7F2E8"
}
文档更新时间: 2023-03-13 10:07   作者:admin