支付宝对商户提供的请求数据进行处理后,返回给商户结果数据,以便商户根据这些数据进一步处理。
参数 | 参数名称 | 类型(长度范围) | 参数说明 | 是否可为空 | 样例 |
---|---|---|---|---|---|
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同步返回数据的形式,把数据反馈给商户网站。商户可以利用编程方法来模拟http请求远程解析XML获得处理的结果数据,增加商户的业务逻辑处理程序。此时, 商户必须判断商户网站中是否已经对该次的结果数据做过同样处理。 如果不判断,存在潜在的风险,商户自行承担因此而产生的所有损失。
此接口通知由支付宝后台配置,当成功执行完该接口后,支付宝会主动发起通知,调用纯担保交易接口(create_partner_trade_by_buyer)、标准双接口(trade_create_by_buyer)、cod接口(create_cod_trade) 、即时到账交易接口(create_direct_pay_by_user)等接口所设置的服务器异步通知路径(notify_url)参数。这种通知需要在支付宝的后台中对这些接口配置后才启用。