请求地址

请求参数

商品明细参数

商品明细示例

业务需求：商品编号 apple-01，商品名称 ipad，商品类目 7788230，数量 1个，价格 2000 元
参数赋值：goods_detail=[{"goodsId":"apple-01","goodsName":"ipad","goodsCategory":"7788230","price":"2000.00","quantity":"1"}]

分账明细参数

分账明细示例

业务需求：按顺序执行 2 笔分账
参数赋值：royalty_parameters=[{"serialNo":"1","transOut":"2088101126765726","tran sIn":"2088101126708402","amount":"0.10","desc":" 分 账 测 试 1"},{"serialNo":"2","transOut":"2088101126765726","transIn":"2088101126707869","amount":"0.10","desc":"分账测试 2"}]

XML同步返回参数

同步返回示例

• 业务正常受理并下单成功：

  <?xml version="1.0" encoding="utf-8"?>
  <alipay>
  <is_success>T</is_success>
  <request>
  	<param name="body">声波支付-分账-sky</param>
  	<param name="operator_id">55</param>
  	<param name="subject">声波支付-分账-sky</param>
  	<param name="sign_type">MD5</param>
  	<param name="out_trade_no">7085502131376415</param>
  	<param name="dynamic_id">kfylrwezsbeqhh553e</param>
  	<param name="royalty_parameters">
  		[{"serialNo":"1","transOut":"2088101126765726","transIn":"208810112670840
  		2","amount":"1.00","desc":"分账测试 1"}]
  	</param>
  	<param name="royalty_type">ROYALTY</param>
  	<param name="total_fee">10</param>
  	<param name="partner">2088101106499364</param>
  	<param name="quantity">10</param>
  	<param name="dynamic_id_type">wave_code</param>
  	<param name="alipay_ca_request">2</param>
  	<param name="sign">a1cb41a4019351965d4418c9cb933f0f</param>
  	<param name="_input_charset">UTF-8</param>
  	<param name="price">1</param>
  	<param name="it_b_pay">1d</param>
  	<param name="product_code">SOUNDWAVE_PAY_OFFLINE</param>
  	<param name="service">alipay.acquire.createandpay</param>
  	<param name="seller_id">2088101106499364</param>
  </request>
  <response>
  	<alipay>
  		<buyer_logon_id>138****0011</buyer_logon_id>
  		<buyer_user_id>2088102105236945</buyer_user_id>
  		<out_trade_no>7085502131376415</out_trade_no>
  		<result_code>ORDER_SUCCESS_PAY_SUCCESS</result_code>
  		<trade_no>2013112311001004940000384027</trade_no>
  	</alipay>
  </response>
  <sign>ea489fc31da63253bab52ed77fb45eb7</sign>
  <sign_type>MD5</sign_type>
  </alipay>

• 请求成功，业务处理失败：

  <?xml version="1.0" encoding="utf-8"?>
  <alipay>
  <is_success>T</is_success>
  <request>
  	<param name="body">声波支付-分账-sky</param>
  	<param name="operator_id">55</param>
  	<param name="subject">声波支付-分账-sky</param>
  	<param name="sign_type">MD5</param>
  	<param name="out_trade_no">7085502131376415</param>
  	<param name="dynamic_id">kfylrwezsbeqhh553e</param>
  	<param name="royalty_parameters">
  		[{"serialNo":"1","transOut":"2088101126765726","transIn":"208810112670840
  		2", "amount":"1.00", "desc":"分账测试 1"}]
  	</param>
  	<param name="royalty_type">ROYALTY</param>
  	<param name="total_fee">10</param>
  	<param name="partner">2088101106499364</param>
  	<param name="quantity">10</param>
  	<param name="dynamic_id_type">wave_code</param>
  	<param name="alipay_ca_request">2</param>
  	<param name="sign">a1cb41a4019351965d4418c9cb933f0f</param>
  	<param name="_input_charset">UTF-8</param>
  	<param name="price">1</param>
  	<param name="it_b_pay">1d</param>
  	<param name="product_code">SOUNDWAVE_PAY_OFFLINE</param>
  	<param name="service">alipay.acquire.createandpay</param>
  	<param name="seller_id">2088101106499364</param>
  </request>
  <response>
  	<alipay>
  		<result_code>ORDER_FAIL</result_code>
  		<detail_error_code>TRADE_BUYER_NOT_MATCH</detail_error_code>
  		<detail_error_des>交易买家不匹配</detail_error_des>
  		<trade_no>2013112311001004940000384027</trade_no>
  	</alipay>
  </response>
  <sign>ea489fc31da63253bab52ed77fb45eb7</sign>
  <sign_type>MD5</sign_type>
  </alipay>

• 请求失败或者接入数据错误时输出：

  <?xml version="1.0" encoding="utf-8"?>
  <alipay>
  <is_success>F</is_success>
  <error>ILLEGAL_SIGN</error>
  </alipay>

  异步通知参数

  
  

  参数	参数名称	类型（字节长度）	参数说明	是否可为空	样例
  基本参数
  notify_time	通知时间	Date	通知的发送时间。格式为 yyyy-MM-ddHH:mm:ss。	不可空	2013-11-27 15:45:58
  notify_type	通知类型	String	通知的类型。	不可空	trade_status_sync
  notify_id	通知校验ID	String	通知校验 ID。	不可空	ac05099524730693a8b330c5ecf72da978
  sign_type	签名方式	String	DSA、RSA、MD5 三个值可选，必须大写。	不可空	MD5
  sign	签名	String	请参见“8 签名机制”。	不可空	601510b7970e52cc63db0f44997cf70e
  notify_action_type	通知动作类型	String	通知动作类型：创建：createDirectPayTradeByBuyerAction支付：payByAccountAction退款：refundFPAction撤销：reverseAction关闭：closeTradeAction交易完成：finishFPAction	可空	payByAccountAction
  业务参数
  out_trade_no	商户网站唯一订单号	String(64)	对应商户网站的订单系统中的唯一订单号，非支付宝交易号。需保证在商户网站中的唯一性。是请求时对应的参数，原样返回。	可空	5431395578198135
  subject	订单标题	String(256)	商品的标题/交易标题/订单标题/订单关键字等。它在支付宝的交易明细中排在第一列，对于财务对账尤为重要。是请求时对应的参数，原样通知回来。	可空	声波支付-分账-sky
  trade_no	支付宝交易号	String(64)	该交易在支付宝系统中的交易流水号。最短 16 位，最长 64 位。	可空	2013112711001004940000394507
  trade_status	交易状态	String	交易目前所处的状态，取值范围请参见“10.5 交易状态”。	可空	WAIT_BUYER_PAY
  gmt_create	交易创建时间	Date	该笔交易创建的时间。格式为 yyyy-MM-ddHH:mm:ss。	可空	2013-11-27 15:45:57
  gmt_payment	交易付款时间	Date	该笔交易的买家付款时间。格式为 yyyy-MM-ddHH:mm:ss。	可空	2013-11-27 15:45:57
  seller_email	卖家支付宝账号	String(100)	卖家支付宝账号，可以是email 和手机号码。	可空	zhuzhanghu@alitest.com
  buyer_email	买家支付宝账号	String(100)	买家支付宝账号，可以是Email 或手机号码。	可空	13882390011
  seller_id	卖家支付宝用户号	String(30)	卖家支付宝账号对应的支付宝唯一用户号。以 2088 开头的纯 16 位数字。	可空	2088101106499364
  buyer_id	买家支付宝用户号	String(30)	买家支付宝账号对应的支付宝唯一用户号。以 2088 开头的纯 16 位数字。	可空	2088102105236945
  price	商品单价	Number	对应请求时的 price 参数，原样通知回来。	可空	1.00
  quantity	购买数量	Number	对应请求时的 quantity 参数，原样通知回来。	可空	10
  total_fee	交易金额	Number	该笔订单的总金额。请求时对应的参数，原样通知回来。	可空	10.00
  body	商品描述	String(400)	该笔订单的备注、描述、明细等。对应请求时的 body 参数，原样通知回来。	可空	Hello
  refund_fee	退款金额	Number	退款通知中，返回退款金额，单位为元。	可空	1.00
  out_biz_no	商户业务号	String(64)	商户业务 ID，主要是退款通知中返回退款申请的流水号。	可空	HZRF001
  paytools_pay_amount	支付金额信息	String(512)	支付成功的各个渠道金额信息，具体请参见“6.3 支付金额信息说明”。	可空	[{"MCARD":"7.94"},{"TMPOINT":"1.69"},{"BANKCARD":"5.55"}]
  extra_common_param	业务透传参数	String(256)	原样返回商户请求下单时的passback_parameters 参数。	可空	你好，这是测试商户的广告。

  
  

  异步通知返回示例

  http://商户自定义地址/alipay/notify_url.php?notify_id=ac05099524730693a8b330c5ecf72da978&seller_email=zhuzhanghu%40alitest.com&notify_type=trade_status_sync&buyer_email=13882390011&sign=601510b7970e52cc63db0f44997cf70e&trade_no=2013112711001004940000394507&buyer_id=2088102105236945&quantity=10&total_fee=10.00&price=1.00&gmt_create=2013-11-27+15%3A45%3A57&out_trade_no=5431395578198135&seller_id=2088101106499364&notify_time=2013-11-27+15%3A45%3A58&subject=%E5%A3%B0%E6%B3%A2%E6%94%AF%E4%BB%98-%E5%88%86%E8%B4%A6-sky&trade_status=WAIT_BUYER_PAY&sign_type=MD5

FAQ