文档中心 > 担保交易(已下线)

xml返回参数说明

更新时间:2016/01/11 访问次数:16219

支付宝对商户提供的请求数据进行处理后,返回给商户结果数据,以便商户根据这些数据进一步处理。

参数 参数名称 类型(长度范围) 参数说明 是否可为空 样例
is_success 请求是否成功 String 请求是否成功。请求成功不代表业务处理成功。 T代表成功,F代表失败。 不可空 T
error 错误代码 String 只有当处理失败时,才返回错误代码。 参见“确认发货业务错误码”。 可空 TRADE_NOT_EXIST
out_order_no 商户网站唯一订单号 String 支付宝合作商户网站唯一订单号(确保在商户系统中唯一)。 不可空 2031904794754153
trade_no 支付宝交易号 String(64) 支付宝根据商户请求,创建订单生成的支付宝交易号。 最短16位,最长64位。 不可空 2009062404090569
buyer_login_email 买家登录支付宝账号 String(100) 买家登录支付宝账号。 不可空 maaimin0577@yahoo.com.cn
seller_user_id 卖家支付宝账号对应的支付宝唯一用户号 String(30) 卖家支付宝账号对应的支付宝唯一用户号。 以2088开头的纯16位数字。 不可空 2088002007301410
seller_login_email 卖家登录支付宝账号 String(100) 卖家登录的支付宝账号。 不可空 ong_xianqun@yahoo.com.cn
seller_account 卖家支付宝账号 String 卖家支付宝账号。 不可空 20880020073014100156
seller_type 卖家类型 String 取值范围请参见“账户类型枚举”。 不可空 PRIVATE_ACCOUNT
seller_actions 卖家的后续动作列表 String 取值范围请参见“操作动作枚举”。 不可空 [REFUSE_TRADE]
buyer_user_id 买家支付宝账号对应的支付宝唯一用户号 String(30) 买家支付宝账号对应的支付宝唯一用户号。 以2088开头的纯16位数字。 不可空 2008010733333715
buyer_account 买家支付宝账号 String(30) 买家支付宝账号。 不可空 20080107333337150156
buyer_type 买家类型 String 取值范围请参见“账户类型枚举”。 不可空 PRIVATE_ACCOUNT
buyer_actions 买家的后续动作列表 String 取值范围请参见“操作动作枚举”。 不可空 [REFUND,CONFIRM_GOODS]
total_fee 交易总金额 Number 单位为RMB Yuan,0.01~1000000000.00。 不可空 4.05
trade_status 交易状态 String 取值范围请参见“交易状态”。 不可空 WAIT_BUYER_CONFIRM_GOODS
trade_type 交易类型 String 取值范围请参见“交易类型枚举”。 不可空 S
operator_role 交易角色 String 买家-B;
卖家-S。
不可空 B
partner_id 合作者身份ID String 签约的支付宝账号对应的支付宝唯一用户号。 以2088开头的16位纯数字组成。 不可空 2088002002537399
create_time 交易创建时间 Date 该笔交易创建的时间。 格式为yyyy-MM-dd HH:mm:ss。 不可空 2008-04-09 16:10:25
channel 渠道信息 String 渠道信息。 不可空 interface/digital
currency 货币代码 String 货币代码。 不可空 156
gathering_type 收款类型 String 取值范围请参见“收款类型枚举”。 不可空 1
last_modified_time 交易最后修改时间 Date 交易最后修改时间。 格式为yyyy-MM-dd HH:mm:ss。 不可空 2008-04-10 14:35:25
service_fee 服务费 Number 单位为RMB Yuan,0.01~1000000000.00。 不可空 0.00
service_fee_ratio 服务费率 Double 服务费率。 不可空 0.0
stop_timeout 是否停止超时机制 String 停止超时机制-T;
不停止超时机制-F。
不可空 F
trade_from 交易来源 String 取值范围请参见“交易来源枚举”。 不可空 INST_PARTNER
  • 正常输出:
<?xml version="1.0" encoding="utf-8"?>
<alipay>
  <is_success>T</is_success>
   <request>
    <param   name="partner">2088002007018916</param>
    <param   name="logistics_name">天天</param>
    <param   name="create_transport_type">EMS</param>
    <param   name="trade_no">2008040902681748</param>
    <param   name="agent">2088002007018916</param>
    <param   name="notify_url">http://10.2.5.100/api/apireceive/returnSuccess.php</param>
    <param   name="invoice_no">3455333</param>
    <param       name="service">send_goods_confirm_by_platform</param>
    <param       name="_input_charset">utf-8</param>
    <param       name="transport_type">EMS</param>
    <param   name="return_url">http://10.2.5.100/api/returnResultList.php</param>
   </request>
   <response>
     <tradeBase>
      <buyer_account>20880020073014230156</buyer_account>
      <buyer_actions>[REFUND,CONFIRM_GOODS]</buyer_actions>
      <buyer_login_email>maaimin0577@yahoo.com.cn</buyer_login_email>
      <buyer_type>PRIVATE_ACCOUNT</buyer_type>
      <buyer_user_id>2088002007301423</buyer_user_id>
      <channel>interface/digital</channel>
      <create_time>2008-04-09       16:10:25</create_time>
      <currency>156</currency>
      <gathering_type>1</gathering_type>
      <last_modified_time>2008-04-10 14:35:25</last_modified_time>
      <operator_role>B</operator_role>
      <out_trade_no>12345566654585</out_trade_no>
      <partner_id>2088002007018916</partner_id>
      <seller_account>20880020073014100156</seller_account>
      <seller_actions>[EXTEND_TIMEOUT]</seller_actions>   
      <seller_login_email>song_xianqun@yahoo.com.cn</seller_login_email>
      <seller_type>PRIVATE_ACCOUNT</seller_type>
      <seller_user_id>2088002007301410</seller_user_id>
      <service_fee>0.00</service_fee>
      <service_fee_ratio>0.0</service_fee_ratio>
      <stop_timeout>F</stop_timeout>
      <total_fee>2.00</total_fee>
      <trade_from>INST_PARTNER</trade_from>
      <trade_no>2008040902681748</trade_no>   
      <trade_status>WAIT_BUYER_CONFIRM_GOODS</trade_status>
      <trade_type>S</trade_type>
     </tradeBase>
   </response>
  <sign>eb07c7407bafa62ec7c0804751a21c1e</sign>
  <sign_type>MD5</sign_type>
</alipay>
  • 发生错误时输出:
<?xml version="1.0" encoding="utf-8"?>
<alipay>
     <is_success>F</is_success>
     <error>TRADE_NOT_EXIST</error>
</alipay>

xml同步返回特性

  1. 支付宝处理完请求的数据后,当前界面会自动刷新,立刻显示处理结果;
  2. 处理一次请求,当前界面只跳转回来一次,即只返回一次处理结果;
  3. 由于没有参数return_url来设置页面跳转同步通知页面文件路径,因此显示处理结果的页面文件所在位置是在支付宝的服务器中,即当前页面路径地址是以支付宝的域名为开头;
  4. 该步骤可在本机电脑调试,无需到服务器上;
  5. 处理结果显示的格式是XML格式;
  6. 可对这个XML格式的处理结果进行XML远程解析,使之能在支付宝处理结果时获取到相关处理结果数据,并对这个结果界面进行商户的业务逻辑处理;
  7. 本地电脑或商户服务器的配置上需支持XML远程解析,如:需要支持SSL;
  8. 页面跳转后,浏览器地址栏中的链接仅在一分钟内有效,超过一分钟该链接地址会失效,导致该页面中商户编写的业务逻辑程序无法完成处理。

商户业务处理注意事项

当支付宝处理完成后,支付宝会以XML同步返回数据的形式,把数据反馈给商户网站。商户可以利用编程方法来模拟http请求远程解析XML获得处理的结果数据,增加商户的业务逻辑处理程序。此时, 商户必须判断商户网站中是否已经对该次的结果数据做过同样处理。 如果不判断,存在潜在的风险,商户自行承担因此而产生的所有损失。

此接口通知由支付宝后台配置,当成功执行完该接口后,支付宝会主动发起通知,调用纯担保交易接口(create_partner_trade_by_buyer)、标准双接口(trade_create_by_buyer)、cod接口(create_cod_trade) 、即时到账交易接口(create_direct_pay_by_user)等接口所设置的服务器异步通知路径(notify_url)参数。这种通知需要在支付宝的后台中对这些接口配置后才启用。

FAQ

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