快接支付支付宝接口文档.DOC

1、快接支付支付宝接口文档功能描述 商户可以根据此文档进行业务功能技术接口对接。阅读对象 面向具有一定的网站开发能力，了解 ASP、PHP、JAVA、ASP.NET 等开发语言中的一种开发、维护和管理等人员。更新说明2017/11/22 关盾 初始文档的编写2017/11/22 关盾 新增扫码支付、jsapi 支付以及异步通知描述修改2018/01/08 赖小妹 新增应用编号(用于区分不同应用订单)2018/01/30 关盾 新增支付宝线上扫码，新增请求参数的字符串长度，业务扩展参数，详情如下签名算法 目前只支持 MD5 签名请求/响应数据签名1、原始请求/响应数据（sign 字段除外） ,所有参

2、数按照字段名的 ascii 码从小到大排序后使用 QueryString 的格式(即 key1=value1while (list ($key, $val) = each ($para) if($key = “sign“ | $val = “)continue;else $para_filter$key = $para$key;return $para_filter;/* 对数组排序* param $para 排序前的数组* return 排序后的数组*/function argSorts($para) ksort($para);reset($para);return $para;/* 签名验

3、证-快接支付* $datas 数据数组* $key 密钥*/function sign($datas = array(), $key = “)$str = urldecode(http_build_query(argSorts(paraFilters($datas);$sign = md5($str.“return $sign; 1、支付宝1-1 支付宝即时到账方式 POST 是否登录 否地址 http:/商户后台查看/alipay/direct_pay描述序号 请求参数 是否必填 类型 最大长度 描述 示例值1 merchant_no 是 String 10 商户号 20170920122

4、merchant_order_no是 String 35 商户订单号 2017091310451055254223 notify_url 是 String 100 商户通知地址 http:/4 return_url 否 String 100 商户跳转地址 http:/5 start_time 是 String 14 订单开始时间(格式为yyyyMMddHHmmss) 201709221721216 trade_amount 是 String 11交易金额 单位为元，精确到小数点后两位，取值范围0.01,1000000000.017 goods_name 是 String 50 商品名称 测试商

5、品8 goods_desc 是 String 100 商品描述 Test9 app_no 否 String 18应用编号（可在商户中心-应用管理-应用信息 处选择该订单所属应用编号）20171023145234221910 attach 否 String 255业务扩展参数，该参数异步通知时原样返回，不填则不返回111 sign_type 是 String 1 签名类型(1-md5) 112 sign 是 String 32 签名 88772a091467bc0fa4790bcad0b1ee69响应参数序号 返回参数 字段类型 描述1 data string json 数据2 trade_no

6、 string 快接平台订单号3 pay_url string 支付链接4 sign string 签名5 info string 描述6 status string 返回码 1-2 支付宝即时到账-线上扫码方式 POST 是否登录 否地址 http:/商户后台查看/alipay/direct_code描述序号 请求参数 是否必填 类型 最大长度 描述 示例值1 merchant_no 是 String 10 商户号 20170920122 merchant_order_no 是 String 35 商户订单号 2017091310451055254223 notify_url 是 Strin

7、g 100 商户通知地址 http:/4 return_url 否 String 100 商户跳转地址 http:/5 start_time 是 String 14 订单开始时间(格式为yyyyMMddHHmmss) 201709221721216 trade_amount 是 String 11交易金额 单位为元，精确到小数点后两位，取值范围0.01,1000000000.017 goods_name 是 String 50 商品名称 测试商品8 goods_desc 是 String 100 商品描述 Test9 app_no 否 String 18 应用编号（可在商户中心-应用管理-应用

8、信息 20171023145234221910 attach 否 String 255业务扩展参数，该参数异步通知时原样返回，不填则不返回111 qrcode_width 否 String 3 二维码的宽度 23012 sign_type 是 String 1 签名类型(1-md5) 113 sign 是 String 32 签名 88772a091467bc0fa4790bcad0b1ee69响应参数序号 返回参数 字段类型 描述1 data string json 数据2 trade_no string 快接平台订单号3 pay_url string 二维码链接地址4 sign strin

9、g 签名5 info string 描述6 status string 返回码 1-3 支付宝 WAP 支付（H5 支付）方式 POST 是否登录 否地址 http:/商户后台查看/alipay/wap_pay描述序号 请求参数 是否必填 类型 最大长度 描述 示例值1 merchant_no 是 String 10 商户号 20170920122 merchant_order_no 是 String 35 商户订单号 2017091310451055254223 notify_url 是 String 100 商户通知地址 http:/4 return_url 否 String 100 商户

10、跳转地址 http:/5 start_time 是 String 14 订单开始时间(格式为yyyyMMddHHmmss) 201709221721216 trade_amount 是 String 11交易金额 单位为元，精确到小数点后两位，取值范围0.01,1000000000.017 goods_name 是 String 50 商品名称 测试商品8 goods_desc 是 String 100 商品描述 Test9 app_no 否 String 18应用编号（可在商户中心-应用管理-应用信息 处选择该订单所属应用编号） 20171023145234221910 attach 否 S

11、tring 255业务扩展参数，该参数异步通知时原样返回，不填则不返回111 sign_type 是 String 1 签名类型(1md5) 112 sign 是 String 32 签名 88772a091467bc0fa4790bcad0b1ee69响应参数序号 返回参数 字段类型 描述1 data string json 数据2 trade_no string 快接平台订单号3 pay_url string 支付链接4 sign string 签名5 info string 描述6 status string 返回码 1-4 支付宝 APP 支付方式 POST 是否登录 否地址 http

12、:/商户后台查看/alipay/app_pay描述序号 请求参数 是否必填 类型 最大长度 描述 示例值1 merchant_no 是 String 10 商户号 20170920122 merchant_order_no 是 String 35 商户订单号 2017091310451055254223 notify_url 是 String 100 商户通知地址 http:/4 start_time 是 String 14 订单开始时间(格式为yyyyMMddHHmmss) 201709221721215 trade_amount 是 String 11交易金额 单位为元，精确到小数点后两位

13、，取值范围0.01,1000000000.016 goods_name 是 String 50 商品名称 测试商品7 goods_desc 是 String 100 商品描述 Test8 app_no 否 String 18应用编号（可在商户中心-应用管理-应用信息 处选择该订单所属应用编号）2017102314523422199 attach 否 String 255业务扩展参数，该参数异步通知时原样返回，不填则不返回110 sign_type 是 String 1 签名类型(1-md5) 111 sign 是 String 32 签名 88772a091467bc0fa4790bcad0b

14、1ee69响应参数序号 返回参数 字段类型 描述1 data string json 数据2 trade_no string 快接平台订单号3 pay_url string 支付链接4 sign string 签名5 info string 描述6 status string 返回码1-5 支付宝 JS 支付方式 POST 是否登录 否地址 http:/商户后台查看/alipay/js_pay描述序号 请求参数 是否必填 类型 最大长度 描述 示例值1 merchant_no 是 String 10 商户号 20170920122 merchant_order_no 是 String 35 商

15、户订单号 2017091310451055254223 notify_url 是 String 100 商户通知地址 http:/4 start_time 是 String 14 订单开始时间(格式为yyyyMMddHHmmss) 201709221721215 alipay_uid 否 String 16支付宝唯一用户号（2088开头的 16 位纯数字,和alipay_no 不能同时空）2088xxxxxxxxxxxx6 alipay_no 否 String 50支付宝账号（和alipay_uid 不能同时为空） 135095474827 trade_amount 是 String 11交易

16、金额 单位为元，精确到小数点后两位，取值范围0.01,1000000000.018 goods_name 是 String 50 商品名称 测试商品9 goods_desc 是 String 100 商品描述 Test10 app_no 否 String 18应用编号（可在商户中心-应用管理-应用信息 处选择该订单所属应用编号） 20171023145234221911 attach 否 String 255业务扩展参数，该参数异步通知时原样返回，不填则不返回112 sign_type 是 String 1 签名类型(1-md5) 113 sign 是 String 32 签名 88772a0

17、91467bc0fa4790bcad0b1ee69响应参数序号 返回参数 字段类型 描述1 data string json 数据2 trade_no string 快接平台订单号3 pay_url string 支付链接4 sign string 签名5 info string 描述6 status string 返回码1-6 支付宝-线下扫码支付方式 POST 是否登录 否地址 http:/商户后台查看/alipay/scan_pay描述序号 请求参数 是否必填 类型 最大长度 描述 示例值1 merchant_no 是 String 10 商户号 20170920122 merchant

18、_order_no 是 String 35 商户订单号 2017091310451055254223 notify_url 是 String 100 商户通知地址 http:/4 start_time 是 String 14 订单开始时间(格式为yyyyMMddHHmmss) 201709221721215 trade_amount 是 String 11交易金额 单位为元，精确到小数点后两位，取值范围0.01,1000000000.016 goods_name 是 String 50 商品名称 测试商品7 goods_desc 是 String 100 商品描述 Test8 app_no 否

19、 String 18应用编号（可在商户中心-应用管理-应用信息 处选择该订单所属应用编号） 2017102314523422199 attach 否 String 255业务扩展参数，该参数异步通知时原样返回，不填则不返回110 sign_type 是 String 1 签名类型(1-md5) 111 sign 是 String 32 签名 88772a091467bc0fa4790bcad0b1ee69响应参数序号 返回参数 字段类型 描述1 data string json 数据2 trade_no string 快接平台订单号3 image string 二维码图片数据串4 sign s

20、tring 签名5 info string 描述6 status string 返回码1-7 支付宝查询方式 POST 是否登录 否地址 http:/商户后台查看/alipay/query_pay描述序号 请求参数 是否必填 描述 示例值1 merchant_no 是 商户号 2017092011040288962 trade_no 是 快接平台订单号 K201709231639053308743 sign_type 是 签名类型(1md5) 14 sign 是 签名 88772a091467bc0fa4790bcad0b1ee69响应参数序号 返回参数 字段类型 描述1 data strin

21、g -2 status string 交易状态3 trade_no string 交易订单号4 amount string 交易金额5 merchant_no string 商户号6 pay_channel string 交易类型7 payment_time string 支付业务结束时间8 sign string 签名9 info string 描述10 status string 返回码1-8 支付宝退款接口方式 POST 是否登录 否地址 http:/商户后台查看/alipay/trade_refund描述序号 请求参数 是否必填 描述 示例值1 merchant_no 是 商户号 20

22、17092011040288962 trade_no 是 快接平台订单号 K201709231639053308743 refund_reason 是 退款原因 不想买了4 sign_type 是 签名类型(1md5) 15 sign 是 签名 88772a091467bc0fa4790bcad0b1ee69响应参数序号 返回参数 字段类型 描述1 data string 数据2 merchant_no string 商户号3 trade_no string 交易订单号4 refund_no string 退款订单号5 order_refund_reason string 退款原因6 sign

23、 string 签名7 info string 描述8 status string 返回码1-9 支付宝异步通知（支付完成的回调请求）方式 POST 是否登录 否地址 支付完成后服务器会请求 notify_url 将响应参数（详情如下）传给请求服务器描述标注：程序执行完后必须打印输出“success”（不包含引号，注意是小写）。如果商户反馈的字符不是 success 这 7 个字符，服务器会不断重发通知，一般情况下，24 小时以内完成 8 次通知。程序执行完成后，该页面不能执行页面跳转。如果执行页面跳转，服务器会收不到success 字符，会被服务器判定为该页面程序运行出现异常，而重发处理结果

24、通知。 序号 请求参数 是否必填 描述 示例值响应参数序号 返回参数 字段类型 是否必填 描述1 status string 是 订单状态 Success|Fail 成功|失败2 msg string 是 订单状态描述3 amount string 是 订单金额4 merchant_order_no string 是 商户订单号5 trade_no string 是 交易订单号6 payment_time string 是 支付业务结束时间7 pay_channel string 是 支付类型状态码8 pay_channel_name string 是 支付类型状态名称9 attach str

25、ing 否业务扩展参数 请求支付接口时上传该参数且不为空时返回10 sign string 是 签名2-0 支付宝页面同步跳转（支付完成的跳转）方式 GET 是否登录 否地址描述 标注： 页面同步跳转只用来做页面跳转，真正交易结果以异步通知为准序号 请求参数 是否必填 描述 示例值响应参数序号 返回参数 字段类型 是否必填 描述1 status string 是 订单状态 Success|Fail 成功|失败2 amount string 是 订单金额3 merchant_order_no string 是 商户订单号4 trade_no string 是 交易订单号请求状态返回码列表返回码 描述-100 字段（如:商户号）不能为空21 商户号不存在29 验证签名失败20 您尚未开通该支付通道，请联系管理员！23 商户订单已存在1 接口请求成功30 响应验签失败99 接口请求失败-1 操作失败19 应用场景格式有误39 今日交易总额已超出限额40 支付金额超出单笔交易限额