文档中心 > 担保交易(已下线)

请求参数说明

更新时间:2016/08/05 访问次数:28532

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

参数 参数名称 类型(长度范围) 参数说明 是否可为空 样例
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

注意:

  1. 请按照“签名及拿到签名结果”中的签名方法对输入参数进行签名,该接口请求才能够被支付宝系统接收;
  2. 物流信息中最多可以传三组物流信息,第一组的物流信息参数是不可缺少的必填参数,每组三个物流信息(logistics_type、logistics_fee、logistics_payment)不可缺少任一项,必须有第一组才能有第二组,有第二组才能有第三组,且不能与第一组物流方式中的物流类型相同,通过这种方式,合作伙伴可以传递多种物流选择方式供买家选择。
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&notify_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

FAQ

关于此文档暂时还没有FAQ
返回
顶部