Powered by GitBook

支付宝即时到账交易接口

页面跳转同步通知参数说明

基本参数

service

接口名称 String 不可空

create_direct_pay_by_user

partner

合作者身份ID String(16) 不可空

签约的支付宝账号对应的支付宝唯一用户号。以2088开头的16位纯数字组成。

2088101011913539|

_input_cha rset

参数编码字符集 String 不可空

商户网站使用的编码格式

  1. utf-8
  2. gbk
  3. gb2312
  4. ......

gbk

sign_type

签名方式 String 不可空

可选三个值, 必须大写。

  1. DSA
  2. RSA
  3. MD5

MD5

sign

签名 String 不可空

*请参见“9 签名机制”。

7d314d22efba4f336fb187697793b9d2

notify_url

服务器异步通知页面路径 String(190) 可空

支付宝服务器主动通知商户网站 里指定的页面http路径

http://api.test.alipay.net/atinterface/receive_return.htm

return_url

页面跳转同步通知页面路径 String(200) 可空

支付宝处理完请求后,当前页面自动跳转到商户网站里指定页面的http路径。

http://api.test.alipay.net/atinterface/receive_return.htm

error_notify _url

请求出错时的通知页面路径 String(200) 可空

当商户通过该接口发起请求时,如果出现提示报错,支付宝会根据 “11.7 item_orders_info出错时的通知错误码”和“11.8 请求出错时的通知错误码”通过异步的方 式发送通知给商户。该功能需要联系支付宝开通。

http://api.test.alipay.net/atinterface/receive_return.htm

业务参数

out_trade_no

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

支付宝合作商户网站唯一订单号。

6843192280647118

subject

商品名称 String(256) 不可空

商品的标题/交易标题/订单标题/订单关键字等。该参数最长为128个汉字。

贝尔金护腕式

payment_type

支付类型 String(4) 不可空

取值范围请参见附录“11.6 收款类型”。默认值为:1(商品购买)。 注意:支付类型为“47”时,公共业务扩展参数(extend_param)中必须包含凭证号 (evoucheprod_evouche_id)参数名和参数值。

1

total_fee

交易金额 Number 不可空

该笔订单的资金总额,单位为RMB-Yuan。取值范围为[0.01,100000000.00],精确到小数点后 两位。

100

seller_id

卖家支付宝用户号 String(1 6) 不可空

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

2088002007018966

buyer_id

买家支付宝用户号 String(1 6) 可空

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

2088002007018955

seller_email

卖家支付宝账号 String(1 00) 可空

卖家支付宝账号,格式为邮箱或手 机号。

[email protected]

buyer_email

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

买家支付宝账号,格式为邮箱或手机号。

[email protected]

seller_account_name

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

  1. 卖家别名支付宝账号。
  2. 卖家信息优先级:seller_id>seller_account_name>seller_email。

[email protected]

buyer_account_name

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

买家信息优先级:buyer_id>buyer_account_name>buyer_email。

[email protected]

price

商品单价 Number 可空

  1. 单位为:RMB Yuan。
  2. 取值范围为 [0.01,100000000.00],精确到小数点后两位。
  3. 此参数为单价规则:price、quantity能代替total_fee。
  4. 即存在total_fee,就不 能存在 price 和quantity;
  5. 存在price、quantity,就不能存在 total_fee。

10.00

quantity

购买数量 Number 可空

  1. price、quantity能代替total_fee
  2. 存在total_fee,就不能存在price和quantity
  3. 存在price、quantity, 就不能存在total_fee

1

body

商品描述 String(1000) 可空

对一笔交易的具体描述信息。如果是多种商品,请将商品描述字符串累加传给body。

美国专业护腕 鼠标垫,舒缓式 凝胶软垫模拟 手腕的自然曲 线和运动,创造 和缓的 GelFlex 舒适地带!

show_url

商品展示网址 String(400) 可空

收银台页面上,商品展示的超链接。

http://www.360buy.com/product/113714.html

paymethod

默认支付方式 String 可空

  1. 取值范围,必须注意区分大小写。
  2. creditPay(信用支付)
  3. directPay(余额支付)如果不设置,默认识别为余额支付。

directPay

enable_paymethod

支付渠道 String 可空

用于控制收银台支付渠道显示，该值的取值范围请参见“11.3 支付渠道”。 可支持多种支付渠道显示，以“^”分隔。

directPay^bankPay^cartoon^cash

need_ctu_check

网银支付时是否做CTU校验 String 可空

商户在配置了支持CTU（支付宝风险稽查系统）校验权限的前提下，可以选择本次交易是否需要经过CTU校验。

  • Y: 做CTU校验；
  • N: 不做CTU校验。

Y

royalty_type

提成类型 String(2) 可空

目前只支持一种类型：10（卖家给第三方提成）。当传递了参数royalty_parameters时，提成类型参数不能为空。

10

royalty_parameters

分润账号集 String(1000) 可空

参见“4.4 royalty_parameters参数说明”。

参见“4.4 royalty_parameters参数说明”

anti_phishing_key

防钓鱼时间戳 String 可空

通过时间戳查询接口获取的加密支付宝系统时间戳。如果已申请开通防钓鱼时间戳验证，则此字段必填。

587FE3D2858E6B01E30104656E7805E2

exter_invoke_ip

客户端IP String(15) 可空

用户在创建交易时，该用户当前所使用机器的IP。如果商户申请后台开通防钓鱼IP地址检查选项，此字段必填，校验用。

128.214.222.111

extra_common_param

公用回传参数 String(100) 可空

如果用户请求时传递了该参数，则返回给商户时会回传该参数。

你好，这是测试商户的广告。

extend_param

公用业务扩展参数 String 可空

*用于商户的特定业务信息的传递，只有商户与支付宝约定了传递此参数且约定了参数含义，此参数才有效。参数格式：参数名1^参数值1|参数名2^参数值2|……多条数据用“|”间隔。支付类型（payment_type）为47（电子卡券）时，需要包含凭证号（evoucheprod_evouche_id）参数名和参数值。

pnr^MFGXDW|start_ticket_no^123|end_ticket_no^234|b2b_login_name^abc

it_b_pay

超时时间 String 可空

设置未付款交易的超时时间，一旦超时，该笔交易就会自动被关闭。取值范围：1m～15d。 m-分钟，h-小时，d-天，1c-当天（无论交易何时创建，都在0点关闭）。该参数数值不接受小数点，如1.5h，可转换为90m。该功能需要联系支付宝配置关闭时间。

1h

default_login

自动登录标识 String 可空

用于标识商户是否使用自动登录的流程。如果和参数buyer_email一起使用时，就不会再让用户登录支付宝，即在收银台中不会出现登录页面。取值有以下情况：

  • Y代表使用
  • N代表不使用

该功能需要联系支付宝配置。

Y

product_type

商户申请的产品类型 String(50) 可空

用于针对不同的产品，采取不同的计费策略。如果开通了航旅垂直搜索平台产品，请填写CHANNEL_FAST_PAY；如果没有，则为空。

CHANNEL_FAST_PAY

token

快捷登录授权令牌 String(40) 可空

如果开通了快捷登录产品，则需要填写；如果没有开通，则为空。

201103290c9f9f2c03db4267a4c8e1bfe3adfd52

item_orders_info

商户回传业务参数 String(40000) 可空

买家通过etao购买的商品的详细清单。如果是etao商户则填写；如果不是，则为空。详细规则请参见“4.3.1 item_orders_info参数说明”。

参见“4.3.2 item_orders_info参数样例”

sign_id_ext

商户买家签约号 String(50) 可空

用于唯一标识商户买家。如果本参数不为空，则sign_name_ext不能为空。

ZHANGSAN

sign_name_ext

商户买家签约名 String(128) 可空

商户买家唯一标识对应的名字。

张三

qr_pay_mode

扫码支付方式 String(1) 可空

*扫码支付的方式，支持前置模式和跳转模式。前置模式是将二维码前置到商户的订单确认页的模式。需要商户在自己的页面中以iframe方式请求支付宝页面。具体分为以下3种：

  • 0：订单码-简约前置模式，对应iframe宽度不能小于600px，高度不能小于300px；
  • 1：订单码-前置模式，对应iframe宽度不能小于300px，高度不能小于600px；
  • 3：订单码-迷你前置模式，对应iframe宽度不能小于75px，高度不能小于75px。 跳转模式下，用户的扫码界面是由支付宝生成的，不在商户的域名下。 2：订单码-跳转模式

1

注意：此接口只支持https请求；���

参数body（商品描述）、subject（商品名称）、extra_common_param（公用回传参数）不能包含特殊字符（如：#、%、&、+）、敏感词汇，也不能使用外国文字（旺旺不支持的外文，如：韩文、泰语、藏文、蒙古文、阿拉伯语）；

  • 请按照“9 签名机制”中的签名方法对输入参数进行签名，该接口请求才能够被支付宝系统接收;
  • 此接口支持重复调用，前提是交易基本信息（买家、卖家、交易金额、超时时间等）在多次调用中保持一致，且交易尚未完成支付；
  • 配置qr_pay_mode为0或1或3（扫码支付方式为订单码-简约前置模式或订单码-前置模式或订码-迷你前置模式）的情况下，同步通知地址return_url需要传入商户中间跳转页面，即该页面需要实现让父页面自行跳转的功能，中间页面javascript代码：