文档中心 > 即时到账有密退款

请求参数说明

更新时间:2016/08/05 访问次数:77423

请求参数是商户在与支付宝进行数据交互时,提供给支付宝的请求数据,以便支付宝根据这些数据进一步处理。

参数 参数名称 类型(长度范围) 参数说明 是否可为空 样例
service 接口名称 String 接口名称。 不可空 refund_fastpay_by_platform_pwd
partner 合作者身份ID String(16) 签约的支付宝账号对应的支付宝唯一用户号。以2088开头的16位纯数字组成。 不可空 2088101008267254
_input_charset 参数编码字符集 String 商户网站使用的编码格式,如UTF-8、GBK、GB2312等。 不可空 GBK
sign_type 签名方式 String DSA、RSA、MD5三个值可选,必须大写。 不可空 MD5
sign 签名 String 请参见签名 不可空 tphoyf4aoio5e6zxoaydjevem2c1s1zo
notify_url 服务器异步通知页面路径 String(200) 支付宝服务器主动通知商户网站里指定的页面http路径。 可空 http://api.test.alipay.net/atinterface/receive_notify.htm
seller_email 卖家支付宝账号 String 如果卖家Id已填,则此字段可为空。 不可空 Jier1105@alitest.com
seller_user_id 卖家用户ID String 卖家支付宝账号对应的支付宝唯一用户号。以2088开头的纯16位数字。登录时,seller_email和seller_user_id两者必填一个。如果两者都填,以seller_user_id为准。 不可空 2088101008267254
refund_date 退款请求时间 String 退款请求的当前时间。格式为:yyyy-MM-dd HH:mm:ss。 不可空 2011-01-12 11:21:00
batch_no 退款批次号 String 每进行一次即时到账批量退款,都需要提供一个批次号,通过该批次号可以查询这一批次的退款交易记录,对于每一个合作伙伴,传递的每一个批次号都必须保证唯一性。格式为:退款日期(8位)+流水号(3~24位)。不可重复,且退款日期必须是当天日期。流水号可以接受数字或英文字符,建议使用数字,但不可接受“000”。 不可空 201101120001
batch_num 总笔数 String 即参数detail_data的值中,“#”字符出现的数量加1,最大支持1000笔(即“#”字符出现的最大数量为999个)。 不可空 1
detail_data 单笔数据集 String 退款请求的明细数据。格式详情参见下面的“单笔数据集参数说明”。 不可空 2011011201037066^5.00^协商退款
  1. 单笔数据集参数说明
    • 单笔数据集格式为:第一笔交易退款数据集#第二笔交易退款数据集#第三笔交易退款数据集…#第N笔交易退款数据集;
    • 交易退款数据集的格式为:原付款支付宝交易号^退款总金额^退款理由;
    • 不支持退分润功能。
  2. 单笔数据集(detail_data)注意事项
    • detail_data中的退款笔数总和要等于参数batch_num的值;
    • “退款理由”长度不能大于256字节,“退款理由”中不能有“^”、“|”、“$”、“#”等影响detail_data格式的特殊字符;
    • detail_data中退款总金额不能大于交易总金额;
    • 一笔交易可以多次退款,退款次数最多不能超过99次,需要遵守多次退款的总金额不超过该笔交易付款金额的原则。
https://mapi.alipay.com/gateway.do?seller_email=Jier1105%40alitest.com&batch_num=1&refund_date=2011-01-12+11%3A21%3A00&notify_url=http%3A%2F%2Fapi.test.alipay.net%2Fatinterface%2Freceive_notify.htm&sign=9b3426cac65d36f64bffbfbc6ce50549&service=refund_fastpay_by_platform_pwd&partner=2088101008267254&detail_data=2011011201037066%5E5.00%5E%D0%AD%C9%CC%CD%CB%BF%EE&sign_type=MD5&batch_no=201101120001

说明:
本样例仅供参考,支付宝网关为https://mapi.alipay.com/gateway.do

FAQ

关于此文档暂时还没有FAQ
返回
顶部