支付宝支付接口开发文档

交易接口服务器异步通知参数说明

含义

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

基本参数

service

接口名称 String 不可空

alipay.wap.trade.create.direct

v

接口版本号 String 不可空

接口版本号。固定取值 1.0。

1.0

sec_id

签名方式 String 不可空

对参数签名的方式。 取值范围:

  • 0001:RSA 签名算法
  • MD5:MD5 签名算法

0001

sign

签名 String 不可空

对请求或响应中参数签名后的值。

Rw/y4ROnNicXhaj287Fiw5pvP6viSyg53H3iNiJ61D3YVi7zGniG2680pZv6rakMCeXX++q9XRLw8Rj6I1//qHrwMAHS1hViNW6hQYsh2TqemuL/xjXRCY3vjm1HCoZOUa5zF2jU09yG23MsMIUx2FAWCL/rgbcQcOjLe5FugTc=

notify_data

通知业务参数 String 不可空

<notify>
  <payment_type>1</payment_type>
  <subject>收银台{1283134629741}</subject>
  <trade_no>2014040311001004370000361525</trade_no>
  <buyer_email>[email protected]</buyer_email>
  <gmt_create>2010-08-3010:17:24</gmt_create>
  <notify_type>trade_status_sync</notify_type>
  <quantity>1</quantity>
  <out_trade_no>1283134629741</out_trade_no>
  <notify_time>2010-08-3010:18:15</notify_time>
  <seller_id>2088101000137799</seller_id>
  <trade_status>TRADE_FINISHED</trade_status>
  <is_total_fee_adjust>N</is_total_fee_adjust>
  <total_fee>1.00</total_fee>
  <gmt_payment>2010-08-3010:18:26</gmt_payment>
  <seller_email>[email protected]</seller_email>
  <gmt_close>2010-08-3010:18:26</gmt_close>
  <price>1.00</price>
  <buyer_id>2088102001172352</buyer_id>
  <notify_id>509ad84678759176212c247c46bec05303</notify_id>
  <use_coupon>N</use_coupon>
  <refund_status>REFUND_SUCCESS</refund_status>
  <gmt_refund>2008-10-2919:38:25</gmt_refund>
</notify>

notify_data 通知业务参数

payment_type

支付方式 String 不可空

用户的支付方式:

  • 1:商品购买
  • 4:捐赠

1

subject

商品名称 String(256) 不可空

商品的标题/交易标题/订单标题/订单关键字等它在支付宝的交易明细中排在第一列,对于财务对账尤为重要。是请求时对应的参数,原样通知回来。

收银台{1283134629741}

trade_no

支付宝交易号 String(32) 不可空

该交易在支付宝系统中的交易流水号。最长 64 位。

2014040311001004370000361525

buyer_email

买家支付宝账号 String(100) 不可空

买家支付宝账号,可以是email或手机号码。

[email protected]

gmt_create

交易创建时间 String 不可空

格式为 yyyy-MM-ddHH:mm:ss。

2010-08-30 10:17:24

notify_type

通知类型 String 不可空

通知的类型。固定值。

trade_status_sync

quantity

购买数量 String 不可空

购买商品的数量。

1

out_trade_no

商户网站唯一订单号 String(64) 不可空

对应商户网站的订单系统中的唯一订单号,非支付宝交易号。需保证在商户网站中的唯一性。是请求时对应的参数,原样返回。

1283134629741

notify_time

通知时间 String 不可空

通知的发送时间。格式为 yyyy-MM-ddHH:mm:ss。

2010-08-30 10:18:15

seller_id 卖家支付

宝用户号 String 不可空

卖家支付宝账号对应的支付宝唯一用户号。以2088开头的纯 16 位数字。

2088101000137799

trade_status

交易状态 String 不可空

交易的状态,取值范围参见“8.2 交易状态”。

TRADE_FINISHED

is_total_fee_adjust

是否调整总价 String 不可空

该交易是否调整过价格。本接口创建的交易不会被修改总价,固定值为 N。

N

total_fee

交易金额 String(15) 不可空

该笔订单的总金额。请求时对应的参数,原样通知回来。

1.00

gmt_payment

交易付款时间 String 可空

该笔交易的买家付款时间。格式为yyyy-MM-ddHH:mm:ss。如果交易未付款,则不返回该参数。

2010-08-30 10:18:26

seller_email

卖家支付宝账号 String(100) 不可空

卖家支付宝账号,可以是email和手机号码。

[email protected]

gmt_close

交易关闭时间 String 不可空

格式为 yyyy-MM-ddHH:mm:ss。

2010-08-30 10:18:26

price

商品单价 String 不可空

目前和 total_fee 值相同。单位:元。不应低于 0.01 元。*

1.00

buyer_id

买家支付宝用户号 String 不可空

买家支付宝账号对应的支付宝唯一用户号。以 2088 开头的纯 16 位数字。

2088102001172352

notify_id

通知校验ID String 不可空

通知校验ID。唯一识别通知内容。重发相同内容的通知时,该值不变。

509ad84678759176212c247c46bec05303

use_coupon

是否使用红包买家 String 不可空

是否在交易过程中使用了红包。

N

refund_status

退款状态 String 可空

取值范围请参见“8.3 退款状态”。

REFUND_SUCCESS

gmt_refund

退款时间 Date 可空

卖家退款的时间,退款通知时会发送。格式为yyyy-MM-dd HH:mm:ss。

2008-10-29 19:38:25

样例

说明: 以下样例仅供参考,实际网关为商户域名。