标准支付宝交易服务（trade_create_by_buyer）_[V1.0]

外部接口名称：标准支付宝交易服务
服务名: trade_create_by_buyer
修订历史
版本号修订章节修订原因修订日期
1.0全部起草2009-09-17
1.1部分外部接口文档统一梳理2010-03-14
版权信息
本手册中所有的信息都是支付宝公司的财产并且受到严格的保密。

未经过支付宝公司书面同意，接收本手册的人不能复制，公开，泄露手册的部分或全部的内容。

1、术语
2、功能描述
此接口是双接口,用户可以选择担保交易或者即时到帐交易来创建交易
3、访问形式
页面调用
4、请求输入参数表
5、请求URL样例
https:///cooperate/gateway.do?service=trade_create_by_buyer&partner=2088002464631181&_inp ut_charset=utf-
8&notify_url=http%3A%2F%%2Fnotify%2Falipay%2Finterface.htm&sign_type=DSA&return_url =http%3A%2F%%2Fnotify%2Falipay%2Finterface.htm&sign=_p_w_l_h_j0b_gd_aejia7n_ko4_m %252Fu_w_jd3_nx_s_k_mxus9_hoxg_y_r_lunli_pmma29_t_q%253D%253D&agent=2088002007018916&subject =%E6%B0%B4%E6%9E%9C&body=%E5%BE%88%E5%A5%BD%E5%90%83%E7%9A%84&out_trade_no=20 5485121225&price=1.01&discount=10.00&show_url=http%3A%2F%&quantity=5&payme nt_type=1&logistics_type=VIRTUAL&logistics_fee=10.00&logistics_payment=SELLER_PAY&seller_email=maai min%&seller_id=25845544488&buyer_email=maaimin%&buyer_id=2584554448 8&buyer_msg=%E5%B0%BD%E5%BF%AB%E7%BB%99%E6%88%91%E5%8F%91%E8%B4%A7%E5%93%A6 &total_fee=10.01&buyer_account_name=maaimin%&seller_account_name=maaimin%40yahoo.c &it_b_pay=1d&t_s_send_1=7d&t_s_send_2=3d
6、请求输出参数
6.1 通知返回的参数列表
6.2 跳转URL样例
/api/apireceive/returnSuccess.php?notify_time=2009-08-
12+11%3A08%3A32&notify_type=%E4%BA%A4%E6%98%93%E7%8A%B6%E6%80%81%E5%90%8C%E6%A D%A5%E9%80%9A%E7%9F%A5%28trade_status_sync%29&notify_id=70fec0c2730b27528665af4517c27b95&sig n_type=DSA&sign=_p_w_l_h_j0b_gd_aejia7n_ko4_m%252Fu_w_jd3_nx_s_k_mxus9_hoxg_y_r_lunli_pmma29_ t_q%253D%253D&trade_no=54115411&out_trade_no=5415125121&price=11.00&discount=1.00&quantity=5&t otal_fee=50&payment_type=1&coupon_discount=1.00&is_total_fee_adjust=T&trade_status=WAIT_BUYER_PA Y&refund_status=WAIT_SELLER_AGREE&logistics_status=INITIAL_STATUS&logistics_type=VIRTUAL&logis tics_fee=10.00&logistics_payment=SELLER_PAY&seller_id=15464636&buyer_id=2088102000898383&buyer_ema il=gaaimin0577%&gmt_refund=2005-8-9%0D%0A12%3A21%3A41
6.3 页面跳转返回的参数列表
跳转URL样例
/api/apireceive/returnDisplay.php?exterface=trade_create_by_buyer&trade_no=2010031506 264359&payment_type=1&trade_status=WAIT_SELLER_SEND_GOODS&logistics_type=EMS&is_total_fee_adj ust=N&refund_status=WAIT_SELLER_AGREE&gmt_refund=2005-8-
9+12%3A21%3A41&notify_id=RqPnCoPT3K9%2Fvwbh3I%2BKCbcrP%2Blpdrmj0DhegcBsPx5dtyCeoWvQTtY bVkWXIwWcT8CI&notify_type=trade_status_sync&notify_time=2010-03-
15+11%3A43%3A07&is_success=T&sign=a4d12c8993c9210c2ac177b22cf3f8c4&sign_type=DSA
6.4 错误代码
7、接口属性配置
8、注意事项
1) 此接口只支持https请求，详见请求url样例。

2) 请按照《外部接口文档》中的签名方法对输入参数进行签名，该接口请求才能够被支付宝系统接收。

3) 合作伙伴通过“标准支付宝交易”接口创建交易时，如果在参数中传递了notify_url，那么当该交易的通知触发条件发生改变时，支付宝会向合作伙伴发送同步通知。

从集成后的系统健壮性考虑，收到支付宝发出的通知后，合作伙伴系统须判断接收到的交易状态、交易金额是否与自己系统中的参数对应。

如果不判断，存在潜在的风险，合作伙伴自行承担因此而产生的所有损失。

4) 物流信息中可以传递多个logistics_type、logistics_fee、logistics_payment参数，后面添加_index，如：第一组物流信息参数名为logistics_type_1、logistics_fee_1、logistics_payment_1，第二组物流信息参数为logistics_type_2、logistics_fee_2、logistics_payment_2，依次类推。

传递多种物流方式时，使用
logistics_type、logistics_fee、logistics_payment表示缺省物流方式（特别注意：使用多种物流的时候，缺省物流不可少，缺省物流必须是多组物流中的一组）。

通过这种方式合作伙伴可以传递多种物流选择方式供买家选择。

如果只有一种物流方式的话，就是用logistics_type、logistics_fee、logistics_payment作为参数名就可以了。

例如：
某交易支持EMS 与 平邮两种不同的物流，且EMS为默认物流，则传入的参数应该为：logistics_type=EMS&logistics_fee=25.00&logistics_payment=BUYER_PAY&
logistics_type_1=EMS&logistics_fee_1=25.00&logistics_payment_1=BUYER_PAY &logistics_type_2=POST&logistics_fee_2=5.00&logistics_payment_2= BUYER_PAY
9、通知触发条件
ILLEGAL_SIGN
签名不正确ILLEGAL_ARGUMEN T
输入参数有错误ILLEGAL_SERVICE Service参数不正确TRADE_BUYER_NOT _MATCH
买家不匹配
USER_NOT_EXIST 用户不存在
TRADE_SELLER_NO T_MATCH
卖家账户与交易中不一致SELLER_NOT_IN_SPE CIFIED_SELLERS
卖家不在指定的商户限制卖家中
TRADE_CLOSED交易关闭true WAIT_SELLER_AGREE买家申请退款true REFUND_SUCCESS退款成功true REFUND_CLOSED退款关闭true modify.tradeBase.totalFee修改交易价格true
10、附录
DAEMON_CONFIRM
超时程序因买家不付款关闭交易_CLOSE
ICBCKT工行卡通
WD网点支付CREDITCARD信用卡支付MCRDT MOTO信用卡支付GGC代金卡充值
GOODS_RECEIVED货物收到了
LOGISTICS_FAILURE物流失败（包括发送消息失败、取货失败）
第11页。