概要描述:

提交退款申请后，通过调用该接口查询退款状态。退款有一定延时，用零钱支付的退款20分钟内到账，银行卡支付的退款3个工作日后重新查询退款状态。

请求URL:

  • 测试环境：/refund-query

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

参数 参数名称 类型 参数说明 样例 可空
agent_no 服务商编号 String M
store_no 海科门店编号 String 海科平台门店编号 M
out_refund_no 服务商退款订单号 String refund_no、out_refund_no二选一上送,优选顺序：refund_no、out_refund_no C
refund_no 海科退款订单号 String refund_no、out_refund_no二选一上送,优选顺序：refund_no、out_refund_no C
sign 签名 String 签名 M

请求示例:

{
    "agent_no": "IS88888888",
    "store_no": "83388888888",
    "out_refund_no": "R123456789",
    "sign": "5F154E14FDC459ED5DF628B56F61A609"
}

返回参数说明:

参数 参数名称 类型 参数说明 样例 可空
return_code 响应码 String 10000代表成功 M
return_msg 响应信息 String M
agent_no 服务商编号 String M
store_no 海科门店编号 String 海科平台门店编号 M
out_refund_no 服务商退款订单号 String M
refund_no 海科退款订单号 String M
refund_amount 退款金额 String 退款金额（单位：元） M
trade_status 交易状态 String M
sign 签名 String 签名 M

pay_type=WX时返回:

参数 参数名称 类型 参数说明 样例 可空
cash_refund_fee 现金退款金额 String 现金退款金额，单位为分，只能为整数 O
settlement_refund_fee 退款金额 String 去掉非充值代金券退款金额后的退款金额，退款金额=申请退款金额-非充值代金券退款金额，退款金额<=申请退款金额 O
coupon_refund_fee 代金券退款总金额 String 代金券退款金额<=退款金额，退款金额-代金券或立减优惠退款金额为现金 O
refund_detail 优惠退款详情 JSON 优惠退款功能信息 O

微信优惠功能refund_detail:

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

pay_type=ALI时返回:

参数 参数名称 类型 参数说明 样例 可空
send_back_fee 本次商户实际退回金额 String 本次商户实际退回金额 M
buyer_user_id 买家在支付宝的用户id String 买家在支付宝的用户 id M
refund_detail_item_list 退款使用的资金渠道 JSONARRAY 交易支付使用的资金渠道 M
present_refund_buyer_amount 本次退款金额中买家退款金额 String 本次退款金额中买家退款金额 O
present_refund_discount_amount 本次退款金额中平台优惠退款金额 String 本次退款金额中平台优惠退款金额 O
present_refund_mdiscount_amount 本次退款金额中商家优惠退款金额 String 本次退款金额中商家优惠退款金额 O
支付宝交易支付使用的资金渠道:refund_detail_item_list
参数 参数名称 类型 参数说明 样例 可空
fund_channel 交易使用的资金渠道 String(32) 交易使用的资金渠道 M
bank_code 银行卡支付时的银行代码 String(10) 银行卡支付时的银行代码 O
amount 该支付工具类型所使用的金额 Double 该支付工具类型所使用的金额 M
real_amount 渠道实际付款金额 Double 渠道实际付款金额 M
fund_type 渠道所使用的资金类型 String(32) 目前只在资金渠道 (fund_channel) 是 银 行 卡 渠 道(BANKCARD)的情况下才返回该信息:
DEBIT_CARD:借记卡
CREDIT_CARD:信用卡
MIXED_CARD:借贷合一卡		 O

pay_type=UNIQR时返回:

参数 参数名称 类型 参数说明 样例 可空
couponInfo 优惠信息 JSONARRAY 优惠信息 O

云闪付优惠信息couponInfo

参数 参数名称 类型 参数说明 样例 可空
spnsrId 出资方 String 银联作为出资方：固定填写00010000；付款方作为出资方：填写 8 位付款方机构代码商户作为出资方：填写 15 位商户代码(银联商户号)。 M
offstAmt 优惠金额 String 以分为单位 M

返回示例:

{
    "agent_no": "IS88888888",
    "store_no": "83388888888",
    "out_refund_no": "123456789",
    "refund_no": "AL88888888",
    "trade_status": "1",
    "return_code": "10000",
    "return_msg": "成功",
    "send_back_fee": "88.88",
    "refund_detail_item_list": [
        {
                "fund_channel": "ALIPAYACCOUNT",
                "amount": 10,
                "real_amount": 11.21
        }
    ],
    "buyer_user_id": "2088101117955611",
    "sign": "1032A57E96E4048B27EC2A5C3CE5E663"
}
文档更新时间: 2024-01-12 16:04   作者：陈文