请求参数

请求参数是商户在与支付宝进行数据交互时，提供给支付宝的请求数据，以便支付宝根据这些数据进一步处理。 

特殊说明（很重要）： 

1、商户在请求参数中，自己附属的一些额外参数，不要和支付宝系统中约定的key（下表中）重名，否则将可能导致未知的异常。 

比如请求参数格式 out_trade_no="1234566"&total_fee="123.5"&rn_check="TRE" 其中out_trade_no、total_fee、rn_check都是支付业务处理关键key，这个里面商户自己将out_trade_no、total_fee认为是支付宝必须传输的参数，rn_check=“TRE”是商户自己的业务数据，但是由于rn_check也是支付宝关键key，支付宝将会认为这个rn_check是支付宝业务的参数，将导致误解析，导致支付出现不可预料的异常。 

2、支付宝建议，商户不要在请求参数中添加除了支付宝指定的关键key外，还有其他的key用&连接。 

比如 out_trade_no="1234566"&total_fee="123.5"&homepage="http://www.xxx.com" ，其中homepage是商户自己的业务key，支付宝建议不要在请求参数中附带和支付无关的业务系统自身的key相关数据。 

3、商户的请求参数中，所有的key（支付宝关键key或者商户自己的key），其对应的value中都不应该出现支付宝关键key，比如out_trade_no、total_fee等，否则该类交易将可能被支付宝拦截，禁止支付。 

比如如下的请求 out_trade_no="1234566"&total_fee="123.5"&homepage="http://www.xxx.com"&body="这个辣条不错 out_trade_no=123 total_fee=123.5"&memo="备忘seller_id=2088123213", 这个请求里面的body对应的value值中有支付宝关键key“out_trade_no”以及“total_fee”，请求中对于memo字段中含有seller_id，这样的业务请求参数支付宝将会拦截。

partner="2088101568358171"&out_trade_no="0819145412-6177"&subject="测试"&body="测试测试"&total_fee="0.01"&notify_url="http://notify.msp.hk/notify.htm"&service="mobile.securitypay.pay"&payment_type="1"&_input_charset="utf-8"&it_b_pay="30m"&sign="lBBK%2F0w5LOajrMrji7DUgEqNjIhQbidR13GovA5r3TgIbNqv231yC1NksLdw%2Ba3JnfHXoXuet6XNNHtn7VE%2BeCoRO1O%2BR1KugLrQEZMtG5jmJIe2pbjm%2F3kb%2FuGkpG%2BwYQYI51%2BhA3YBbvZHVQBYveBqK%2Bh8mUyb7GM1HxWs9k4%3D"&sign_type="RSA"

4、外币金额和人民币金额的值（如total_fee和rmb_fee的值）必须精确到小数点后两位。如100.00 USD。 其它格式将导致报错，如100.999 USD. 但当外币金额单位是JPY时，金额必须是整数，如100 JPY。

trade_information

同步通知参数说明

支付宝对商户的请求数据处理完成后，会将处理的结果数据直接通知给商户。这些处理结果数据就是同步通知参数。 

同步返回的数据，对于商户在服务端没有收到异步通知的时候，可以依赖服务端对同步返回的结果来进行判断是否支付成功。同步返回的结果中，sign字段描述了请求的原始数据和服务端支付的状态一起拼接的签名信息。验证这个过程包括两个部分：1、原始数据是否跟商户请求支付的原始数据一致（必须验证这个）；2、验证这个签名是否能通过。上述1、2通过后，在result字段中success=true才是可信的。【特别注意，同步结果校验的逻辑，必须放在服务端处理，切记不要放在客户端】【强烈建议商户直接依赖服务端的异步通知，忽略同步返回】 

说明： 

这里的规则仅限于接入sdk支付模式，对于纯粹的WAP浏览器接入的模式不适用，也就是只针对签约mobile.securitypay.pay这个服务的业务适用，浏览器模式，建议走异步通知的方式。 

·     iOS

{ memo = ""; result = "partner=\"2088101568358171\"&out_trade_no=\"0819145412-6177\"&subject=\"测试\"&body=\"测试测试\"&total_fee=\"0.01\"&notify_url=\"http://notify.msp.hk/notify.htm\"&service=\"mobile.securitypay.pay\"&payment_type=\"1\"&_input_charset=\"utf-8\"&it_b_pay=\"30m\"&success=\"true\"&sign_type=\"RSA\"&sign=\"hkFZr+zE9499nuqDNLZEF7W75RFFPsly876QuRSeN8WMaUgcdR00IKy5ZyBJ4eldhoJ/2zghqrD4E2G2mNjs3aE+HCLiBXrPDNdLKCZgSOIqmv46TfPTEqopYfhs+o5fZzXxt34fwdrzN4mX6S13cr3UwmEV4L3Ffir/02RBVtU=\""; resultStatus = "9000"; }

·     Android

resultStatus={9000};memo={};result={partner="2088101568358171"&out_trade_no="0819145412-6177"&subject="测试"&body="测试测试"&total_fee="0.01"&notify_url="http://notify.msp.hk/notify.htm"&service="mobile.securitypay.pay"&payment_type="1"&_input_charset="utf-8"&it_b_pay="30m"&success="true"&sign_type="RSA"&sign="hkFZr+zE9499nuqDNLZEF7W75RFFPsly876QuRSeN8WMaUgcdR00IKy5ZyBJ4eldhoJ/2zghqrD4E2G2mNjs3aE+HCLiBXrPDNdLKCZgSOIqmv46TfPTEqopYfhs+o5fZzXxt34fwdrzN4mX6S13cr3UwmEV4L3Ffir/02RBVtU="}

·     iOS同步通知参数获取：请参考“iOS->回调接口”。 

·     Android同步通知参数获取：在新线程实例化PayTask对象，调用pay方法，通过Handler对象通知主线程获取支付结果。可参考alipay_sdk_demo工程实现。

客户端返回码

异步通知

支付宝对商户的请求数据处理完成后，会将处理的结果数据通过服务器主动通知的方式通知给商户网站。这些处理结果数据就是服务器异步通知参数。

异步通知示例：

http://notify.java.jpxx.org/index.jsp?currency=USD&trade_no=2013082244524842&notify_type=trade_status_sync&out_trade_no=082215222612710&notify_time=2013-08-22 14:45:24 &trade_status=TRADE_FINISHED &total_fee=1.00&notify_id=64ce1b6ab92d00ede0ee56ade98fdf2f4c&sign_type=RSA&sign=1glihU9DPWee+UJ82u3+mw3Bdnr9u01at0M/xJnPsGuHh+JA5bk3zbWaoWhU6GmLab3dIM4JNdktTcEUI9/FBGhgfLO39BKX/eBCFQ3bXAmIZn4l26fiwoO613BptT44GTEtnPiQ6+tnLsGlVSrFZaLB9FVhrGfipH2SWJcnwYs=

通知触发条件

说明：true（触发通知）/false（不触发通知）具体值和签约配置时保持同步。

服务器异步通知参数获取

1.   必须保证服务器异步通知页面（notify_url）上无任何字符，如空格、HTML标签、开发系统自带抛出的异常提示信息等； 

2.   支付宝是用POST方式发送通知信息，因此该页面中获取参数的方式，如： 

request.Form(“out_trade_no”)、$_POST[‘out_trade_no’]； 

3.   支付宝主动发起通知，该方式才会被启用； 

4.   服务器间的交互，不像页面跳转同步通知可以在页面上显示出来，这种交互方式是不可见的； 

5.   程序执行完后必须打印输出“success”（不包含引号）。如果商户反馈给支付宝的字符不是success这7个字符，支付宝服务器会不断重发通知，直到超过24小时22分钟。 

一般情况下，25小时以内完成8次通知（通知的间隔频率一般是：2m,10m,10m,1h,2h,6h,15h）； 

6.   程序执行完成后，该页面不能执行页面跳转。如果执行页面跳转，支付宝会收不到success字符，会被支付宝服务器判定为该页面程序运行出现异常，而重发处理结果通知； 

7.   cookies、session等在此页面会失效，即无法获取这些数据； 

8.   该方式的调试与运行必须在服务器上，即互联网上能访问； 

9.   该方式的作用主要防止订单丢失，即页面跳转同步通知没有处理订单更新，它则去处理； 

10. 当商户收到服务器异步通知并打印出success时，服务器异步通知参数notify_id才会失效。也就是说在支付宝发送同一条异步通知时（包含商户并未成功打印出success导致支付宝重发数次通知），服务器异步通知参数notify_id是不变的。 

商户通知参数合法性验证

当支付宝处理完成后会把数据结果反馈给商户。 商户获得这些数据时，必须进行如下处理。

验证签名

首先必需验证签名，然后验证是否是支付宝发来的通知。 

验证是否是支付宝发来的通知 

请参见验证是否是支付宝发来的通知。 

业务数据处理注意事项

商户需要验证该通知数据中的out_trade_no是否为商户系统中创建的订单号。在上述验证通过后商户必须根据支付宝不同类型的业务通知，正确的进行不同的业务处理，并且过滤重复的通知结果数据。在支付宝的业务通知中，只有交易通知状态为TRADE_FINISHED时，支付宝才会认定为买家付款成功。 如果商户需要对同步返回的数据做验签，必须通过服务端的签名验签代码逻辑来实现。如果商户未正确处理业务通知，存在潜在的风险，商户自行承担因此而产生的所有损失。 

交易状态

验证是否是支付宝发来的通知

该处的验证是指，对支付宝通知回来的参数notify_id合法性验证。这个验证动作实际上是调用了支付宝的另一个接口“通知验证接口(notify_verify)”来完成的。这个接口请求时使用的是模拟远程HTTP提交，回调模式是“直接在当前页面输出结果”，返回的数据是纯文本格式。 

请求的完整链接如下：

https://intlmapi.alipay.com/gateway.do?service=notify_verify&partner=2088002396712354&notify_id=RqPnCoPT3K9%252Fvwbh3I%252BFioE227%252BPfNMl8jwyZqMIiXQWxhOCmQ5MQO%252FWd93rvCB%252BaiGg

得到的处理结果有两种：

• 成功时：true
• 不成功时：报对应错误

业务逻辑处理

1、商户的业务逻辑处理代码应该写在哪？

一般建议商户业务逻辑的重要处理代码需要写在------

验证签名及notify_id合法性校验都是true的判断逻辑里 

如果是“主动回调”（异步通知 notify_url）的页面文件中，那么必须在执行完业务逻辑处理代码且成功改动了业务逻辑的情况下才在当前页面打印success，且不能有页面重定向功能存在。

2、商户业务逻辑处理时要注意的事项

  1）务必要判断验证签名及notify_id合法性校验 

  2）务必要判断被重复调用的可能 

  3）根据实际的业务逻辑情况执行不同的代码。尤其是根据交易状态的不同而执行不同代码 

  4）主动回调模式的页面文件中，success是否有成功打印且没有其他信息 

  5）主动回调模式的页面文件中不能存在cookie、session

  6）主动回调模式且需要打印success的页面文件中不能进行页面重定向动作

注意事项

错误码