请求参数说明（隐藏） -凯发app官方网站

参数	类型	是否必填	最大长度	描述	示例值
app_id	string	是	32	支付宝分配给开发者的应用 appid。	2014072300007148
method	string	是	128	接口名称	alipay.trade.app.pay
format	string	否	40	仅支持 json	json
charset	string	是	10	请求使用的编码格式，app 支付建议使用 utf-8 格式，如使用gbk,gb2312 等格式会有“系统繁忙，请稍后再试”的报错	utf-8
sign_type	string	是	10	商户生成签名字符串所使用的签名算法类型，目前支持rsa2和rsa，推荐使用rsa2	rsa2
sign	string	是	256	商户请求参数的签名串，可查看签名。	详情可查看示例
timestamp	string	是	19	发送请求的时间，格式"yyyy-mm-dd hh:mm:ss"。	2014-07-24 03:07:50
version	string	是	3	调用的接口版本，固定为：1.0。	1.0
notify_url	string	是	256	支付宝服务器主动通知商户服务器里指定的页面 http/https 路径，建议商户使用 https。	https://api.xx.com/receive_notify.htm
biz_content	string	是	-	业务请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档	-

2 请求参数

参数	类型	是否必填	最大长度	描述	示例值
body	string	否	128	对一笔交易的具体描述信息。如果是多种商品，请将商品描述字符串累加传给body。	iphone6 16g
subject	string	是	256	商品的标题/交易标题/订单标题/订单关键字等。	大乐透
out_trade_no	string	是	64	商户网站唯一订单号	70501111111s001111119
timeout_express	string	否	6	该笔订单允许的最晚付款时间，逾期将关闭交易。取值范围：1m～15d。m-分钟，h-小时，d-天，1c-当天（1c-当天的情况下，无论交易何时创建，都在0点关闭）。该参数数值不接受小数点，如 1.5h，可转换为 90m。注意：若为空，则默认为15d。	90m
total_amount	string	是	9	订单总金额，单位为元，精确到小数点后两位，取值范围[0.01,100000000]	9.00
product_code	string	是	64	销售产品码，商家和支付宝签约的产品码，app支付功能中该值固定为： quick_msecurity_pay	quick_msecurity_pay
goods_type	string	否	2	商品主类型。 ●0：虚拟类商品。 ●1：实物类商品。注意：虚拟类商品不支持使用花呗渠道	0
goods_detail	goodsdetail[]	否		订单包含的商品列表信息，json 格式，其它说明可查看商品明细说明。详情可查看 alipay.trade.app.pay。
passback_params	string	否	512	公用回传参数，如果请求时传递了该参数，则返回给商户时会回传该参数。支付宝会在异步通知时将该参数原样返回。本参数必须进行 urlencode 之后才可以发送给支付宝。	merchantbiztype=3c&merchantbizno=2016010101111
promo_params	string	否	512	优惠参数。注意：仅与支付宝协商后可用。	{"storeidtype":"1"}
extend_params	string	否		业务扩展参数，可查看下表的业务扩展参数(extend_params)说明。	{"sys_service_provider_id":"2088511833207846"}
enable_pay_channels	string	否	128	可用渠道，用户只能在指定渠道范围内支付当有多个渠道时用“,”分隔。注意：与 disable_pay_channels 互斥，可用支付渠道可查看下方渠道说明。	pcredit,moneyfund,debitcardexpress
disable_pay_channels	string	否	128	禁用渠道，用户不可用指定渠道支付当有多个渠道时用“,”分隔。注意：与 enable_pay_channels 互斥，可用支付渠道可查看下方渠道说明。	pcredit,moneyfund,debitcardexpress
store_id	string	否	32	商户门店编号。该参数用于请求参数中以区分各门店，非必传项。	nj_001
ext_user_info	extuserinfo	否		外部指定买家，可查看外部指定买家(ext_user_info)参数说明。

2.1 业务扩展参数（extend_params）说明

参数	类型	是否必填	最大长度	描述	示例值
sys_service_provider_id	string	否	64	系统商编号，该参数作为系统商返佣数据提取的依据，请填写系统商签约协议的pid	2088511833207846
needbuyerrealnamed	string	否	1	是否发起实名校验。 ●t：发起。 ●f：不发起。	t
trans_memo	string	否	128	账务备注。注意：该字段显示在离线账单的账务备注中	促销
hb_fq_num	string	否	5	花呗分期数（目前仅支持 3、6、12）。注意：使用该参数需要仔细阅读。	3
hb_fq_seller_percent	string	否	3	卖家承担收费比例，商家承担手续费传入 100，用户承担手续费传入 0，仅支持传入100、0 两种，其它比例暂不支持。注意：使用该参数需要仔细阅读。	100

2.2 渠道说明

渠道名称	说明
balance	余额
moneyfund	余额宝
coupon	红包
pcredit	花呗
pcreditpayinstallment	花呗分期
creditcard	信用卡
creditcardexpress	信用卡快捷
creditcardcartoon	信用卡卡通
credit_group	信用支付类型（包含信用卡卡通、信用卡快捷、花呗、花呗分期）
debitcardexpress	借记卡快捷
mcard	商户预存卡
pcard	个人预存卡
promotion	优惠（包含实时优惠商户优惠）
voucher	营销券
point	积分
mdiscount	商户优惠
bankpay	网银

2.2.1 外部指定买家(ext_user_info)参数说明

参数	类型	是否必填	最大长度	描述	示例值
name	string	否	16	姓名注意： need_check_info=t时该参数才有效	李明
mobile	string	否	20	手机号注意：该参数暂不校验	16587658765
cert_type	string	否	32	身份证：identity_card、护照：passport、军官证：officer_card、士兵证：soldier_card、户口本：hokou等。如有其它类型需要支持，请与凯发app官方网站的技术支持联系。注意： need_check_info=t时该参数才有效	identity_card
cert_no	string	否	64	证件号。注意：need_check_info=t时该参数才有效	362334768769238881
min_age	string	否	3	允许的最小买家年龄，买家年龄必须大于等于所传数值。注意： ●need_check_info=t 时该参数才有效。 ●min_age为整数，必须大于等于 0。	18
fix_buyer	string	否	8	是否强制校验付款人身份信息 t:强制校验，f：不强制	f
need_check_info	string	否	1	是否强制校验身份信息 t:强制校验，f：不强制	f

3 请求示例

请求参数组装分下列 3 步，以最后第三步获取到的请求为准。

请求参数按照

key=value&key=value

方式拼接的未签名原始字符串：

再对原始字符串进行签名，可查看

签名规则

：

最后对请求字符串的所有一级 value（biz_content 作为一个 value）进行 encode，编码格式按请求串中的 charset 为准，没传 charset 按 utf-8 处理，获得最终的请求字符串：

4 特殊说明（很重要）

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

app_id=2014072300007148**&version=1.0&biz_content

的 key 是公共请求参数，业务方自己的扩展参数需要放在

biz_content

内部，例如示例中 tips 属性,很显然下面 total_amount 属性是商户按照自己的业务属性赋值的，但是由于 total_amount 也是支付宝关键 key，支付宝将会认为这个 total_amount 是支付宝业务的参数应该是金额，这个最终将导致误解析。下列请求串为了展示清晰，未进行 encode 并且做了格式化处理，下同。

商户的请求参数中，所有的 key（支付宝关键 key 或者商户自己的 key），其对应的 value 中都不应该出现支付宝关键 key，否则该类交易将可能被支付宝拦截禁止支付。例如以下的请求中"subject":“大乐透这个辣条不错 out_trade_no=123 total_fee=123.5”，其 value 值中有支付宝关键 key "

out_trade_no

"、"

total_fee

"，这样的业务请求参数支付宝将会拦截。

商户支付请求参数的安全注意点：

请求参数的 sign 字段请务必在服务端完成签名生成（

不要在客户端本地签名

）；

支付请求中的订单金额 total_amount，

请务必依赖服务端，不要轻信客户端上行的数据

（客户端本地上行数据在用户手机环境中无法确保一定安全）。

相关问题