请求参数是商户在与支付宝进行数据交互时,提供给支付宝的请求数据,以便支付宝根据这些数据进一步处理。
参数 | 参数名称 | 类型(长度范围) | 参数说明 | 是否可为空 | 样例 |
---|---|---|---|---|---|
service | 接口名称 | String | 接口名称。 | 不可空 | create_partner_trade_by_buyer |
partner | 合作者身份ID | String(16) | 签约的支付宝账号对应的支付宝唯一用户号。以2088开头的16位纯数字组成。 | 不可空 | 2088002007018916 |
_input_charset | 参数编码字符集 | String | 商户网站使用的编码格式,如UTF-8、GBK、GB2312等。 | 不可空 | UTF-8 |
sign_type | 签名方式 | String | DSA、RSA、MD5三个值可选,必须大写。 | 不可空 | MD5 |
sign | 签名 | String | 请参见签名 | 不可空 | 241de399131dd6723ce3acbdd820ab44 |
notify_url | 服务器异步通知页面路径 | String(190) | 支付宝服务器主动通知商户网站里指定的页面http路径。 | 可空 | http://api.test.alipay.net/atinterface/receive_notify.htm |
return_url | 页面跳转同步通知页面路径 | String(200) | 支付宝处理完请求后,当前页面自动跳转到商户网站里指定页面的http路径。 | 可空 | http://api.test.alipay.net/atinterface/receive_return.htm |
out_trade_no | 商户网站唯一订单号 | String(64) | 支付宝合作商户网站唯一订单号(确保在合作伙伴系统中唯一)。 | 不可空 | 9400234539532526 |
subject | 商品名称 | String(256) | 商品的标题/交易标题/订单标题/订单关键字等。该参数最长为128个汉字。 | 不可空 | good+subject |
payment_type | 收款类型 | String | 收款类型,只支持1:商品购买。 | 不可空 | 1 |
logistics_type | 物流类型 | String | 第一组物流类型。取值范围请参见“物流类型”。 | 不可空 | EMS |
logistics_fee | 物流费用 | String | 第一组物流运费。单位为:RMB Yuan。精确到小数点后两位。缺省值为0元。 | 不可空 | 23 |
logistics_payment | 物流支付类型 | String | 第一组物流支付类型。取值范围请参见“物流支付类型”。 | 不可空 | BUYER_PAY |
price | 商品单价 | Number | 单位为:RMB Yuan。取值范围为[0.01,1000000.00],精确到小数点后两位。 | 不可空 | 6 |
quantity | 商品数量 | Number | 商品的数量。 | 不可空 | 3 |
seller_email | 卖家支付宝账号 | String(100) | 登录时,seller_email和seller_id两者必填一个。 | 不可空 | zhoubo_seller@alitest.com |
buyer_email | 买家支付宝账号 | String(100) | 买家支付宝账号。 | 可空 | zhoubo_buyer@alitest.com |
seller_id | 卖家支付宝账号对应的支付宝唯一用户号 | String(30) | 卖家支付宝账号对应的支付宝唯一用户号。以2088开头的纯16位数字。登录时,seller_email和seller_id两者必填一个。 | 可空 | 2088102010217433 |
buyer_id | 买家支付宝账号对应的支付宝唯一用户号 | String(30) | 买家支付宝账号对应的支付宝唯一用户号。以2088开头的纯16位数字。 | 可空 | 2088102008416044 |
seller_account_name | 卖家别名支付宝账号 | String(100) | 如果seller_email和seller_id均为空,则以此别名账号作为卖家账号。 | 可空 | zhoubo_seller@alitest.com |
buyer_account_name | 买家别名支付宝账号 | String(100) | 如果buyer_email和buyer_id均为空,则以此别名账号作为买家账号。 | 可空 | zhoubo_buyer@alitest.com |
body | 商品描述 | String(400) | 对一笔交易的具体描述信息。如果是多种商品,请将商品描述字符串累加传给body。 | 可空 | good+body |
show_url | 商品展示URL | String(400) | 收银台页面上,商品展示的超链接。 | 可空 | http://www.007suma.com/?product-9.html |
total_fee | 总额 | Number | 单笔交易金总额,单位为RMB-Yuan。取值范围为[0.01,1000000.00],精确到小数点后两位。 | 可空 | 338 |
discount | 折扣 | Number | 支付宝系统会把discount的值加到交易金额上,如果需要折扣,本参数为负数。单位为:RMB Yuan,精确到小数点后两位。缺省值为0元。 | 可空 | -5.8 |
receive_name | 收货人姓名 | String(128) | 收货人姓名。 | 可空 | 张三 |
receive_address | 收货人地址 | String(256) | 收货人地址。 | 可空 | 上海普陀区XX路 |
receive_zip | 收货人邮编 | String(20) | 收货人邮编。 | 可空 | 123456 |
receive_phone | 收货人电话 | String(30) | 收货人电话。 | 可空 | 02161686888 |
receive_mobile | 收货人手机 | String | 收货人手机。 | 可空 | 13800000000 |
logistics_type_1 | 物流类型1 | String | 第二组物流类型。取值范围请参见“物流类型”。 | 可空 | EMS |
logistics_fee_1 | 物流运费1 | String | 第二组物流运费。单位为:RMB Yuan。精确到小数点后两位。 | 可空 | 12 |
logistics_payment_1 | 物流支付类型1 | String | 第二组物流支付类型。取值范围请参见“物流支付类型”。 | 可空 | BUYER_PAY |
logistics_type_2 | 物流类型2 | String | 第三组物流类型。取值范围请参见“物流类型”。 | 可空 | POST |
logistics_fee_2 | 物流运费2 | String | 第三组物流运费。单位为:RMB Yuan。精确到小数点后两位。 | 可空 | 12 |
logistics_payment_2 | 物流支付类型2 | String | 第三组物流支付类型。取值范围请参见“物流支付类型”。 | 可空 | BUYER_PAY |
t_s_send_1 | 卖家逾期不发货,允许买家退款 | String | 卖家逾期不发货,允许买家退款的期限。单位为天(d)。如果商户未设置支持自定义超时,该参数应该为空,否则会报错。 | 可空 | 7d |
t_s_send_2 | 卖家逾期不发货,建议买家退款 | String | 卖家逾期不发货,建议买家退款。单位为天(d)。如果商户未设置支持自定义超时,该参数应该为空,否则会报错。 | 可空 | 7d |
t_b_rec_post | 买家逾期不确认收货,自动完成交易(平邮) | String | 买家逾期不确认收货,自动完成交易(平邮)的期限。单位为天(d)。如果商户未设置支持自定义超时,该参数应该为空,否则会报错。 | 可空 | 7d |
it_b_pay | 买家逾期不付款,自动关闭交易 | String | 设置未付款交易的超时时间,一旦超时,该笔交易就会自动被关闭。取值范围:1m~15d。m-分钟,h-小时,d-天,1c-当天(1c-当天的情况下,无论交易何时创建,都在0点关闭)。该参数数值不接受小数点,如1.5h,可转换为90m。该功能需要联系支付宝配置关闭时间。 | 可空 | 7d |
token | 快捷登录授权令牌 | String(40) | 如果开通了快捷登录产品,则需要填写;如果没有开通,则为空。 | 可空 | 201103290c9f9f2c03db4267a4c8e1bfe3adfd52 |
注意:
https://mapi.alipay.com/gateway.do?body=good%2bbody&logistics_type=EMS&out_trade_no=9400234539532526&logistics_fee=23&logistics_fee_1=12&logistics_fee_2=12&quantity=3&partner=2088002007018916&discount=-5.8&return_url=http%3A%2F%2Fapi.test.alipay.net%2Fatinterface%2Freceive_return.htm&sign=241de399131dd6723ce3acbdd820ab44&_input_charset=UTF-8&price=6&subject=good%2bsubject&sign_type=MD5&logistics_type_1=EMS&logistics_type_2=POST¬ify_url=http%3A%2F%2Fapi.test.alipay.net%2Fatinterface%2Freceive_notify.htm&service=create_partner_trade_by_buyer&logistics_payment_1=BUYER_PAY&logistics_payment_2=BUYER_PAY&logistics_payment=BUYER_PAY&payment_type=1&seller_email=zhoubo_seller%40alitest.com
说明:
本样例仅供参考,支付宝网关为https://mapi.alipay.com/gateway.do
。