即时到账批量无密退款接口(refund_fastpay_by_platform_nopwd).doc

接口名称：即时到账批量无密退款接口 Service：refund_fastpay_by_platform_nopwd 修订历史 版本号 作者 修订章节 修订原因 修订日期 审阅人 0.1 邹献武 全部 外部接口加固重新整理 2008-11-01 术语： 术语 解释 批次号 每进行一次即时到帐批量无密退款时需要使用的批次号， 通过批次号可以查询这一批次的交易记录，在系统里批次号是唯一的。 分润 分润指将某一部分费用分给其它帐户 外部传入总笔数 指商户传给支付宝的交易笔数 功能描述： 接收外部合作伙伴批量即时到账退款请求,同步返回结果告知合作伙伴请求是否被接受； 当请求被接受,注册定时任务异步处理该批退款请求,全部完成后已通知方式告知外部合作伙伴。在买家付完款后，交易未超时,且交易未关闭时可以调用该接口，同时支持多次调用,直至全部款项都退完,交易关闭。 2.访问形式： 系统调用 3.请求参数表 特别注意： 请采用https的方式请求，见样例 按照支付宝外部请求接口概述中要求的签名方式，对输入参数进行签名，该接口请求才能够被支付宝系统接收。 字段名 变量名 类型 说明 可空 参数样例 基本参数 接口名称 service String refund_fastpay_by_platform_nopwd N refund_fastpay_by_platform_nopwd 签名 sign String 见签名机制 N 签名方式 sign_type String 见签名方式 N 合作伙伴ID partner String(16) 合作伙伴在支付宝的用户ID N 2088001007244574 通知URL notify_url URL 针对该交易的交易状态异步通知接收URL。 N 业务参数 批次号 batch_no String(11)～String(32) 退款日期(8位)+流水号(3-24位)，如：20060702001，注意不可重复。 N 20060702001 退款请求日期 refund_date String(19) yyyy-MM-dd hh:mm:ss如：2007-10-01 13:13:13 hh为24小时制 N 2008-03-31 12:06:00 总笔数 batch_num String “单笔数据集”里面的交易总笔数 1 单笔数据集 detail_data String 包含退交易,退分润,退收费信息;最多支持1000条 N 2008032602676583^100^退交易 返回类型 return_type String response返回的返回类型:xml,html 默认xml Y xml 4.请求URL样例： /ateway.do?service=refund_fastpay_by_platform_nopwdsign_type=MD5partner=2088001007244574notify_url=batch_no=2008101512345refund_date=2008-03-3112:06:00batch_num=1detail_data=2008032602676583^100^_input_charset=utf-8return_type=falsesign=92e9d7858421ba9d75f51004a7132f1c 5. 请求输出参数 若return_type传为“HTML”，则页面上就直接显示执行结果。否则为xml方式返回 xml返回输出参数列表 字段名 变量名 类型 说明 可空 是否成功 is_success String T代表成功,F代表失败 N response参数 输出格式 正常输出: ?xml version=1.0 encoding=GBK ? alipay ? is_successT/is_success /alipay 发生错误时： ? ?xml version=1.0 encoding=GBK ? alipay ? is_successF/is_success ? error BATCH_NO_FORMAT_ERROR /error ? /alipay 异步通知处理结果 通知返回的参数列表 字段名 变量名 类型 说明 可空 基本参数 接口名称 service String refund_fastpay_by_platform_nopwd N 通知类型 notify_type String refund_fastpay_by_platform_notify N 通知ID notify_id String 支付宝通知流水号，合作伙伴可以用这个流水号询问