手机网站支付接口

更新时间：2017/07/11 访问次数：132114

请求参数说明
商户APP的WebView处理alipays协议
页面跳转同步参数说明
页面跳转同步通知页面特性
服务器异步通知参数说明
服务器异步通知页面特性
通知触发条件
交易状态
退款状态
业务错误码

请求参数说明

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

参数	参数名称	类型（字节长度）	参数说明	是否可为空	样例
基本参数
service	接口名称	String	接口名称。	不可空	alipay.wap.create.direct.pay.by.user
partner	合作者身份ID	String(16)	签约的支付宝账号对应的支付宝唯一用户号。以2088开头的16位纯数字组成。	不可空	2088111111111194
_input_charset	参数编码字符集	String	商户网站使用的编码格式，仅支持UTF-8。	不可空	UTF-8
sign_type	签名方式	String	DSA、RSA、MD5三个值可选，必须大写。	不可空	RSA
sign	签名	String	请参见本文档“附录：签名与验签”。	不可空	AqDeHSqY%2BwcYy0bTSAaVoyTGTYOOkXm6KEKlJ6LIaefDOdX%2F3adfalkdfjaldkfjaldlGrkVJNqcL5Lf2%2BX2SGH4jPl9E5PbsAgFq0LQGT4kvhTdcOGqaOcjYRt3TScJnoFn%2B3biV3P2%2FiBuRTdVuOgivkkjG%2BNDLKTDAgTxDNM%3D
notify_url	服务器异步通知页面路径	String(190)	支付宝服务器主动通知商户网站里指定的页面http路径。	可空	http://hlcb.uz.com/notify-web/TradePayNotify
return_url	页面跳转同步通知页面路径	String(200)	支付宝处理完请求后，当前页面自动跳转到商户网站里指定页面的http路径。	可空	alipays://platformapi/startApp?appId=10000011
业务参数
out_trade_no	商户网站唯一订单号	String(64)	支付宝合作商户网站唯一订单号。	不可空	70501111111S001111119
subject	商品名称	String(256)	商品的标题/交易标题/订单标题/订单关键字等。该参数最长为128个汉字。	不可空	大乐透
total_fee	交易金额	String	该笔订单的资金总额，单位为RMB-Yuan。取值范围为[0.01，100000000.00]，精确到小数点后两位。	不可空	9.00
seller_id	卖家支付宝用户号	String(16)	卖家支付宝账号对应的支付宝唯一用户号。以2088开头的纯16位数字。	不可空	2088111111116894
payment_type	支付类型	String(4)	支付类型。仅支持：1（商品购买）。	不可空	1
show_url	商品展示网址	String(400)	用户付款中途退出返回商户网站的地址。	不可空	http://www.taobao.com/product/113714.html
body	商品描述	String(1000)	对一笔交易的具体描述信息。如果是多种商品，请将商品描述字符串累加传给body。	可空	测试
it_b_pay	超时时间	String	设置未付款交易的超时时间，一旦超时，该笔交易就会自动被关闭。取值范围：1m～15d。 m-分钟，h-小时，d-天，1c-当天（1c-当天的情况下，无论交易何时创建，都在0点关闭）。该参数数值不接受小数点，如1.5h，可转换为90m。当用户输入支付密码、点击确认付款后（即创建支付宝交易后）开始计时。支持绝对超时时间，格式为yyyy-MM-dd HH:mm。	可空	3837m
extern_token	钱包token	String	接入极简版wap收银台时支持。当商户请求是来自支付宝钱包，在支付宝钱包登录后，有生成登录信息token时，使用该参数传入token将可以实现信任登录收银台，不需要再次登录。注意：登录后用户还是有入口可以切换账户，不能使用该参数锁定用户。	可空	appopenBb64d181d0146481ab6a762c00714cC27
otherfee	航旅订单其它费用	Number	航旅订单中除去票面价之外的费用，单位为RMB-Yuan。取值范围为[0.01,100000000.00]，精确到小数点后两位。	可空	200
airticket	航旅订单金额	String(1,64)	航旅订单金额描述，由四项或两项构成，各项之间由“\|”分隔，每项包含金额与描述，金额与描述间用“^”分隔，票面价之外的价格之和必须与otherfee相等。	可空	800^票面价\|50^机建费\|120^燃油费\|30^航意险
airticket	航旅订单金额	String(1,64)		可空	800^票面价\|50^其他
rn_check	是否发起实名校验	String(1)	T：发起实名校验； F：不发起实名校验。	可空	T
buyer_cert_no	买家证件号码	String	买家证件号码（需要与支付宝实名认证时所填写的证件号码一致）。说明：当scene=ZJCZTJF的情况下，才会校验buyer_cert_no字段。	可空	329829197809290921
buyer_real_name	买家真实姓名	String	买家真实姓名。说明：当scene=ZJCZTJF的情况下，才会校验buyer_real_name字段。	可空	张三
scene	收单场景	String	收单场景。如需使用该字段，需向支付宝申请开通，否则传入无效。	可空	ZJCZTJF
hb_fq_param	花呗分期参数	String	Json格式。 hb_fq_num：花呗分期数，比如分3期支付； hb_fq_seller_percent：卖家承担收费比例，比如100代表卖家承担100%。两个参数必须一起传入。具体花呗分期期数和卖家承担收费比例可传入的数值请咨询支付宝。	可空	{"hb_fq_num":"3","hb_fq_seller_percent":"100"}
goods_type	商品类型	String	商品类型。 1：实物类商品 0：虚拟类商品不传默认为实物类商品。	可空	1
app_pay	是否使用支付宝客户端支付	String	app_pay=Y：尝试唤起支付宝客户端进行支付，若用户未安装支付宝，则继续使用wap收银台进行支付。商户若为APP，则需在APP的webview中增加alipays协议处理逻辑。	可空	Y
promo_params	商户优惠活动参数	String(128)	商户与支付宝约定的营销参数，为Key:Value键值对，如需使用，请联系支付宝技术人员。	可空	{"Customer2016":"Y","Goods201606":"Y"}
enable_paymethod	可用渠道	String	可用渠道，用户只能在指定渠道范围内支付。当有多个渠道时，用“,”分隔。	可空	pcredit,moneyFund,debitCardExpress
extend_params	业务扩展参数	String	业务扩展参数，详见下面的“业务扩展参数说明”。	可空	{"TRANS_MEMO":"促销"}

渠道说明

渠道名称	说明
balance	余额
moneyFund	余额宝
coupon	红包
pcredit	花呗
pcreditpayInstallment	花呗分期
creditCard	信用卡
creditCardExpress	信用卡快捷
creditCardCartoon	信用卡卡通
credit_group	信用支付类型（包含信用卡卡通、信用卡快捷、花呗、花呗分期）
debitCardExpress	借记卡快捷
mcard	商户预存卡
pcard	个人预存卡
promotion	优惠（包含实时优惠+商户优惠）

说明：

部分参数类型为String，未指明长度范围，表明系统不校验该参数的长度。
以下样例仅供参考，支付宝网关为https://mapi.alipay.com/gateway.do。

https://mapi.alipay.com/gateway.do?_input_charset=utf-8&airticket=800%5E%E7%A5%A8%E9%9D%A2%E4%BB%B7%7C50%5E%E6%9C%BA%E5%BB%BA%E8%B4%B9%7C120%5E%E7%87%83%E6%B2%B9%E8%B4%B9%7C30%5E%E8%88%AA%E6%84%8F%E9%99%A9&extern_token=appopenBb64d181d0146481ab6a762c00714cC27&it_b_pay=3837m&notify_url=http%3A%2F%2Fhlcb.uz.com%2Fnotify-web%2FTradePayNotify&otherfee=200&out_trade_no=70501111111S001111119&partner=2088111111111194&payment_type=1&return_url=alipays%3A%2F%2Fplatformapi%2FstartApp%3FappId%3D10000011&seller_id=2088111111116894&service=alipay.wap.create.direct.pay.by.user&sign=AqDeHSqY%2BwcYy0bTSAaVoyTGTYOOkXm6KEKlJ6LIaefDOdX%2F3adfalkdfjaldkfjaldlGrkVJNqcL5Lf2%2BX2SGH4jPl9E5PbsAgFq0LQGT4kvhTdcOGqaOcjYRt3TScJnoFn%2B3biV3P2%2FiBuRTdVuOgivkkjG%2BNDLKTDAgTxDNM%3D&sign_type=RSA&subject=%e5%a4%a7%e4%b9%90%e9%80%8f&total_fee=9.00&show_url=http%3A%2F%2Fwww.taobao.com%2Fproduct%2F113714.html

业务扩展参数说明

参数	参数名称	类型（长度范围）	参数说明	是否可为空	样例
TRANS_MEMO	账务备注	String(128)	账务备注。注：该字段显示在离线账单的账务备注中。	可空	促销

商户APP的WebView处理alipays协议

iOS

- (BOOL)webView:(UIWebView *)webView shouldStartLoadWithRequest:(NSURLRequest *)request navigationType:(UIWebViewNavigationType)navigationType
{
    // NOTE: ------  对alipays:相关的scheme处理 -------
    // NOTE: 若遇到支付宝相关scheme，则跳转到本地支付宝App
    NSString* reqUrl = request.URL.absoluteString;
    if ([reqUrl hasPrefix:@"alipays://"] || [reqUrl hasPrefix:@"alipay://"]) {
        // NOTE: 跳转支付宝App
        BOOL bSucc = [[UIApplication sharedApplication]openURL:request.URL];
 
        // NOTE: 如果跳转失败，则跳转itune下载支付宝App
        if (!bSucc) {
            UIAlertView *alert = [[UIAlertView alloc]initWithTitle:@"提示"
                                                           message:@"未检测到支付宝客户端，请安装后重试。"
                                                          delegate:self
                                                 cancelButtonTitle:@"立即安装"
                                                 otherButtonTitles:nil];
            [alert show];
        }
        return NO;
    }
    return YES;
}
 
- (void)alertView:(UIAlertView *)alertView clickedButtonAtIndex:(NSInteger)buttonIndex
{
    // NOTE: 跳转itune下载支付宝App
    NSString* urlStr = @"https://itunes.apple.com/cn/app/zhi-fu-bao-qian-bao-yu-e-bao/id333206289?mt=8";
    NSURL *downloadUrl = [NSURL URLWithString:urlStr];
    [[UIApplication sharedApplication]openURL:downloadUrl];
}

Android

public boolean shouldOverrideUrlLoading(final WebView view, String url) {
   // 获取上下文, H5PayDemoActivity为当前页面
   final Activity context = H5PayDemoActivity.this;
 
   // ------  对alipays:相关的scheme处理 -------
   if(url.startsWith("alipays:") || url.startsWith("alipay")) {
    try {
     context.startActivity(new Intent("android.intent.action.VIEW", Uri.parse(url)));
    } catch (Exception e) {
     new AlertDialog.Builder(context)
     .setMessage("未检测到支付宝客户端，请安装后重试。")
     .setPositiveButton("立即安装", new DialogInterface.OnClickListener() {
 
      @Override
      public void onClick(DialogInterface dialog, int which) {
       Uri alipayUrl = Uri.parse("https://d.alipay.com");
       context.startActivity(new Intent("android.intent.action.VIEW", alipayUrl));
      }
     }).setNegativeButton("取消", null).show();
    }
    return true;
   }
   // ------- 处理结束 -------
 
   if (!(url.startsWith("http") || url.startsWith("https"))) {
    return true;
   }
 
   view.loadUrl(url);
   return true;
  }

页面跳转同步参数说明

支付宝对商户的请求数据处理完成后，会将处理的结果数据通过系统程序控制客户端页面自动跳转的方式通知给商户网站。这些处理结果数据就是页面跳转同步通知参数。

参数	参数名称	类型（长度范围）	参数说明	是否可为空	样例
基本参数
is_success	成功标识	String(1)	表示接口调用是否成功，并不表明业务处理结果。	不可空	T
sign_type	签名方式	String	DSA、RSA、MD5三个值可选，必须大写。	不可空	RSA
sign	签名	String(32)	请参见本文档“附录：签名与验签”。	不可空	AqDeHSqY%2BwcYy0bTSAaVoyTGTYOOkXm6KEKlJ6LIaefDOdX%2F3adfalkdfjaldkfjaldlGrkVJNqcL5Lf2%2BX2SGH4jPl9E5PbsAgFq0LQGT4kvhTdcOGqaOcjYRt3TScJnoFn%2B3biV3P2%2FiBuRTdVuOgivkkjG%2BNDLKTDAgTxDNM%3D
service	接口名称	String	标志调用哪个接口返回的链接。	可空	alipay.wap.create.direct.pay.by.user
notify_id	通知校验ID	String	支付宝通知校验ID，商户可以用这个流水号询问支付宝该条通知的合法性。	可空	RqPnCoPT3K9%252Fvwbh3InQ8DTlBqQF2KlM0p08vXXXXXXXXXXMK3zQ4hsFX%252F3tstP
notify_time	通知时间	Date	通知时间（支付宝时间）。格式为yyyy-MM-dd HH:mm:ss。	可空	2014-11-24 00:22:12
notify_type	通知类型	String	返回通知类型。	可空	trade_status_sync
业务参数
out_trade_no	商户网站唯一订单号	String(64)	对应商户网站的订单系统中的唯一订单号，非支付宝交易号。需保证在商户网站中的唯一性。是请求时对应的参数，原样返回。	可空	11111111111
trade_no	支付宝交易号	String(64)	该交易在支付宝系统中的交易流水号。最长64位。	可空	2014112400001000340011111118
subject	商品名称	String(256)	商品的标题/交易标题/订单标题/订单关键字等。	可空	C03-31111113-7427250
payment_type	支付类型	String(4)	对应请求时的payment_type参数，原样返回。	可空	1
trade_status	交易状态	String	交易目前所处的状态。成功状态的值只有两个： TRADE_FINISHED（普通即时到账的交易成功状态） TRADE_SUCCESS（开通了高级即时到账或机票分销产品后的交易成功状态）	可空	TRADE_SUCCESS
seller_id	卖家支付宝账户号	String(30)	卖家支付宝账号对应的支付宝唯一用户号。以2088开头的纯16位数字。	可空	2088111111111112
total_fee	交易金额	Number	该笔订单的资金总额，单位为RMB-Yuan。取值范围为[0.01，100000000.00]，精确到小数点后两位。	可空	173.36
body	商品描述	String(400)	对一笔交易的具体描述信息。请求参数原样返回。	可空	Amazon

http://商户自定义地址/alipay/return_url.php?body=Amazon&is_success=T&notify_id=RqPnCoPT3K9%252Fvwbh3InQ8DTlBqQF2KlM0p08vXXXXXXXXXXMK3zQ4hsFX%252F3tstP&notify_time=2014-11-24+00%3A22%3A12&notify_type=trade_status_sync&out_trade_no=11111111111&payment_type=1&seller_id=2088111111111112&service=alipay.wap.create.direct.pay.by.user&subject=C03-31111113-7427250&total_fee=173.36&trade_no=2014112400001000340011111118&trade_status=TRADE_SUCCESS&sign=AqDeHSqY%2BwcYy0bTSAaVoyTGTYOOkXm6KEKlJ6LIaefDOdX%2F3adfalkdfjaldkfjaldlGrkVJNqcL5Lf2%2BX2SGH4jPl9E5PbsAgFq0LQGT4kvhTdcOGqaOcjYRt3TScJnoFn%2B3biV3P2%2FiBuRTdVuOgivkkjG%2BNDLKTDAgTxDNM%3D&sign_type=RSA

说明：
本样例仅供参考，实际网关为商户域名。

页面跳转同步通知页面特性

1. 用户在登录成功后会看到一个支付宝提示登录的页面，该页面会停留几秒，然后会自动跳转回商户指定的同步通知页面（参数return_url）。

2. 该页面中获得参数的方式，需要使用GET方式获取，如request.QueryString(“out_trade_no”)、$_GET[‘out_trade_no’]。后续商户可根据获取的信息作处理，譬如，可以把获取到的token放入session中，以便于后续需要使用到token访问支付宝相应服务时，可以便捷地重用。

3. 该方式仅仅在用户登录完成以后进行自动跳转，因此只会进行一次。

4. 该方式不是支付宝主动去调用商户页面，而是支付宝的程序利用页面自动跳转的函数，使用户的当前页面自动跳转。

5. 该方式可在本机而不是只能在服务器上进行调试。

6. 返回URL只有一分钟的有效期，超过一分钟该链接地址会失效，验证则会失败。

7. 设置页面跳转同步通知页面（return_url）的路径时，不要在页面文件的后面再加上自定义参数。例如：

错误的写法：http://www.alipay.com/alipay/return_url.php?xx=11
正确的写法：http://www.alipay.com/alipay/return_url.php

8. 由于支付宝会对页面跳转同步通知页面（return_url）的域名进行合法有效性校验，因此设置页面跳转同步通知页面（return_url）的路径时，不要设置成本机域名，也不能带有特殊字符（如“!”），如：

错误的写法：
http://localhost/alipay/return_url.php
http://localhost:80/alipay/return_url.php
http://商户自定义地址/alipay/return!url.do
正确的写法：
能够正常访问的域名地址：http://商户自定义地址/alipay/return_url.php能够正常访问的IP地址：http://121.1.1.255/alipay/return_url.php

服务器异步通知参数说明

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

参数	参数名称	类型（长度范围）	参数说明	是否可为空	样例
基本参数
notify_time	通知时间	Date	通知的发送时间。格式为yyyy-MM-dd HH:mm:ss。	不可空	2014-11-24 00:22:07
notify_type	通知类型	String	通知的类型。	不可空	trade_status_sync
notify_id	通知校验ID	String	通知校验ID。	不可空	bb7620a82f057fadfadfa1d05d05be77fc3w
sign_type	签名方式	String	DSA、RSA、MD5三个值可选，必须大写。	不可空	RSA
sign	签名	String(32)	请参见本文档“附录：签名与验签”。	不可空	AqDeHSqY%2BwcYy0bTSAaVoyTGTYOOkXm6KEKlJ6LIaefDOdX%2F3adfalkdfjaldkfjaldlGrkVJNqcL5Lf2%2BX2SGH4jPl9E5PbsAgFq0LQGT4kvhTdcOGqaOcjYRt3TScJnoFn%2B3biV3P2%2FiBuRTdVuOgivkkjG%2BNDLKTDAgTxDNM%3D
业务参数
out_trade_no	商户网站唯一订单号	String(64)	对应商户网站的订单系统中的唯一订单号，非支付宝交易号。需保证在商户网站中的唯一性。是请求时对应的参数，原样返回。	可空	1511111180
subject	商品名称	String(256)	商品的标题/交易标题/订单标题/订单关键字等。	可空	C03-3721111-7421110
payment_type	支付类型	String(4)	对应请求时的payment_type参数，原样返回。	可空	1
trade_no	支付宝交易号	String(64)	该交易在支付宝系统中的交易流水号。最长64位。	可空	2014112400001000340011111111
trade_status	交易状态	String	取值范围请参见交易状态。	可空	TRADE_SUCCESS
gmt_create	交易创建时间	Date	该笔交易创建的时间。格式为yyyy-MM-dd HH:mm:ss。	可空	2014-11-24 00:21:52
gmt_payment	交易付款时间	Date	该笔交易的买家付款时间。格式为yyyy-MM-dd HH:mm:ss。	可空	2014-11-24 00:22:07
gmt_close	交易关闭时间	Date	交易关闭时间。格式为yyyy-MM-dd HH:mm:ss。	可空	2008-10-22 20:49:46
seller_email	卖家支付宝账号	String(100)	卖家支付宝账号，可以是email和手机号码。	可空	payadad@aadfad.com
buyer_email	买家支付宝账号	String(100)	买家支付宝账号，可以是Email或手机号码。	可空	she***@aa.com
seller_id	卖家支付宝账户号	String(30)	卖家支付宝账号对应的支付宝唯一用户号。以2088开头的纯16位数字。	可空	2088001111111152
buyer_id	买家支付宝账户号	String(30)	买家支付宝账号对应的支付宝唯一用户号。以2088开头的纯16位数字。	可空	20880024011111110
price	商品单价	Number	如果请求时使用的是total_fee，那么price等于total_fee；如果请求时传了price，那么对应请求时的price参数，原样通知回来。	可空	173.36
total_fee	交易金额	Number	该笔订单的总金额。请求时对应的参数，原样通知回来。	可空	173.36
quantity	购买数量	Number	如果请求时使用的是total_fee，那么quantity等于1；如果请求时有传quantity，那么对应请求时的quantity参数，原样通知回来。	可空	1
body	商品描述	String(400)	该笔订单的备注、描述、明细等。对应请求时的body参数，原样通知回来。	可空	Amazon
discount	折扣	Number	支付宝系统会把discount的值加到交易金额上，如果需要折扣，本参数为负数。	可空	-5
is_total_fee_adjust	是否调整总价	String(1)	该交易是否调整过价格。	可空	N
use_coupon	是否使用红包买家	String(1)	是否在交易过程中使用了红包。	可空	N
refund_status	退款状态	String	取值范围请参见退款状态。	可空	REFUND_SUCCESS
gmt_refund	退款时间	Date	卖家退款的时间，退款通知时会发送。格式为yyyy-MM-dd HH:mm:ss。	可空	2008-10-29 19:38:25

http://商户自定义地址/alipay/notify_url.php?payment_type=1&subject=C03-3721111-7421110&trade_no=2014112400001000340011111111&buyer_email=she***%40aa.com&gmt_create=2014-11-24+00%3A21%3A52&notify_type=trade_status_sync&quantity=1&out_trade_no=1511111180&seller_id=2088001111111152&notify_time=2014-11-24+00%3A22%3A07&body=Amazon&trade_status=TRADE_SUCCESS&is_total_fee_adjust=N&total_fee=173.36&gmt_payment=2014-11-24+00%3A22%3A07&seller_email=payadad%40aadfad.com&price=173.36&buyer_id=20880024011111110&notify_id=bb7620a82f057fadfadfa1d05d05be77fc3w&use_coupon=N&sign_type=RSA&sign=AqDeHSqY%2BwcYy0bTSAaVoyTGTYOOkXm6KEKlJ6LIaefDOdX%2F3adfalkdfjaldkfjaldlGrkVJNqcL5Lf2%2BX2SGH4jPl9E5PbsAgFq0LQGT4kvhTdcOGqaOcjYRt3TScJnoFn%2B3biV3P2%2FiBuRTdVuOgivkkjG%2BNDLKTDAgTxDNM%3D

说明：
本样例仅供参考，实际网关为商户域名。

服务器异步通知页面特性

必须保证服务器异步通知页面（notify_url）上无任何字符，如空格、HTML标签、开发系统自带抛出的异常提示信息等；
支付宝是用POST方式发送通知信息，因此该页面中获取参数的方式，如：
request.Form("out_trade_no")、$_POST['out_trade_no']；
支付宝主动发起通知，该方式才会被启用；
只有在支付宝的交易管理中存在该笔交易，且发生了交易状态的改变，支付宝才会通过该方式发起服务器通知（即时到账中交易状态为“等待买家付款”的状态默认是不会发送通知的）；
服务器间的交互，不像页面跳转同步通知可以在页面上显示出来，这种交互方式是不可见的；
第一次交易状态改变（即时到账中此时交易状态是交易完成）时，不仅页面跳转同步通知页面会启用，而且服务器异步通知页面也会收到支付宝发来的处理结果通知；
程序执行完后必须打印输出“success”（不包含引号）。如果商户反馈给支付宝的字符不是success这7个字符，支付宝服务器会不断重发通知，直到超过24小时22分钟。
一般情况下，25小时以内完成8次通知（通知的间隔频率一般是：4m,10m,10m,1h,2h,6h,15h）；
程序执行完成后，该页面不能执行页面跳转。如果执行页面跳转，支付宝会收不到success字符，会被支付宝服务器判定为该页面程序运行出现异常，而重发处理结果通知；
cookies、session等在此页面会失效，即无法获取这些数据；
该方式的调试与运行必须在服务器上，即互联网上能访问；
该方式的作用主要防止订单丢失，即页面跳转同步通知没有处理订单更新，它则去处理；
当商户收到服务器异步通知并打印出success时，服务器异步通知参数notify_id才会失效。也就是说在支付宝发送同一条异步通知时（包含商户并未成功打印出success导致支付宝重发数次通知），服务器异步通知参数notify_id是不变的。

通知触发条件

触发条件名	触发条件描述	触发条件默认值
TRADE_FINISHED	交易完成	true（触发通知）
TRADE_SUCCESS	支付成功	true（触发通知）
WAIT_BUYER_PAY	交易创建	false（不触发通知）
TRADE_CLOSED	交易关闭	false（不触发通知）

说明：
商户可以向支付宝申请配置，是否触发各交易状态下的异步通知。

交易状态

枚举名称	枚举说明
WAIT_BUYER_PAY	交易创建，等待买家付款。
TRADE_CLOSED	在指定时间段内未支付时关闭的交易；在交易完成全额退款成功时关闭的交易。
TRADE_SUCCESS	交易成功，且可对该交易做操作，如：多级分润、退款等。
TRADE_PENDING	等待卖家收款（买家付款后，如果卖家账号被冻结）。
TRADE_FINISHED	交易成功且结束，即不可再做任何操作。

退款状态

枚举名称	枚举说明
REFUND_SUCCESS	退款成功：全额退款情况：trade_status= TRADE_CLOSED，而refund_status=REFUND_SUCCESS 非全额退款情况：trade_status= TRADE_SUCCESS，而refund_status=REFUND_SUCCESS
REFUND_CLOSED	退款关闭

枚举名称

枚举说明

REFUND_SUCCESS

退款成功：

全额退款情况：trade_status= TRADE_CLOSED，而refund_status=REFUND_SUCCESS
非全额退款情况：trade_status= TRADE_SUCCESS，而refund_status=REFUND_SUCCESS

REFUND_CLOSED

退款关闭

业务错误码

错误代码（error_code）	含义
ILLEGAL_SIGN	签名不正确
ILLEGAL_DYN_MD5_KEY	动态密钥信息错误
ILLEGAL_ENCRYPT	加密不正确
ILLEGAL_ARGUMENT	参数不正确
ILLEGAL_SERVICE	参数不正确
ILLEGAL_PARTNER	合作伙伴ID不正确
ILLEGAL_EXTERFACE	接口配置不正确
ILLEGAL_PARTNER_EXTERFACE	合作伙伴接口信息不正确
ILLEGAL_SECURITY_PROFILE	未找到匹配的密钥配置
ILLEGAL_AGENT	代理ID不正确
ILLEGAL_SIGN_TYPE	签名类型不正确
ILLEGAL_CHARSET	字符集不合法
ILLEGAL_CLIENT_IP	客户端IP地址无权访问服务
ILLEGAL_DIGEST_TYPE	摘要类型不正确
ILLEGAL_DIGEST	文件摘要不正确
ILLEGAL_FILE_FORMAT	文件格式不正确
ILLEGAL_ENCODING	不支持该编码类型
ILLEGAL_REQUEST_REFERER	防钓鱼检查不支持该请求来源
ILLEGAL_ANTI_PHISHING_KEY	防钓鱼检查非法时间戳参数
ANTI_PHISHING_KEY_TIMEOUT	防钓鱼检查时间戳超时
ILLEGAL_EXTER_INVOKE_IP	防钓鱼检查非法调用IP
ILLEGAL_NUMBER_FORMAT	数字格式不合法
ILLEGAL_INTEGER_FORMAT	Int类型格式不合法
ILLEGAL_MONEY_FORMAT	金额格式不合法
ILLEGAL_DATA_FORMAT	日期格式错误
REGEXP_MATCH_FAIL	正则表达式匹配失败
ILLEGAL_LENGTH	参数值长度不合法
PARAMTER_IS_NULL	参数值为空

FAQ

关于此文档暂时还没有FAQ

有用(61) 我要提问

开放平台

手机网站支付