《统一预下单接口(alipay.acquire.precreate)》由会员分享，可在线阅读，更多相关《统一预下单接口(alipay.acquire.precreate)（34页珍藏版）》请在金锄头文库上搜索。
1、 统一预下单接口 服务名称 alipay acquire precreate 版本号 2 0 支付宝 中国 网络技术有限公司 版权所有 统一预下单接口 支付宝 中国 网络技术有限公司 版权所有 版本 2 0 第 2 页 目 录 1 文档说明 5 1 1 功能描述 5 1 2 阅读对象 5 1 3 业务术语 5 2 功能演示 6 3 数据交互 6 4 请求参数说明 7 4 1 含义 7 4 2 列表 7 4 3 商品明细说明 11 4 4 分账明细说明 12 4 5 渠道明细说明 13 4 6 业务扩展参数说明 14 4 7 业务透传参数说明 16 4 8 样例 17 5 xml同步返回参数说明
2、 18 5 1 含义 18 统一预下单接口 支付宝 中国 网络技术有限公司 版权所有 版本 2 0 第 3 页 5 2 列表 18 5 3 样例 19 6 服务器异步通知参数说明 22 6 1 含义 22 6 2 列表 22 6 3 支付金额信息说明 25 6 4 样例 26 7 通知返回数据处理 26 7 1 xml同步返回特性 26 7 2 服务器异步通知页面特性 27 7 3 商户业务处理注意事项 28 8 签名机制 28 8 1 生成待签名的字符串 28 8 1 1 需要参与签名的参数 28 8 1 2 生成待签名字符串 29 8 2 签名 30 8 2 1 MD5 签名 30 8 2
3、 2 DSA RSA签名 30 9 如何验证是否支付宝请求 31 10 附录 31 10 1 业务错误码 31 统一预下单接口 支付宝 中国 网络技术有限公司 版权所有 版本 2 0 第 4 页 10 2 接入错误码 32 10 3 系统错误码 33 10 4 交易状态 34 统一预下单接口 支付宝 中国 网络技术有限公司 版权所有 版本 2 0 第 5 页 1 文档说明 1 1 功能描述 商户通过该接口进行交易的预创建下单 后续需要客户端确认下单完成真正的交易 创建和支付 1 2 阅读对象 支付宝统一预下单接口文档是面向具有一定的网站开发能力 了解 ASP PHP JAVA ASP NET
4、等开发语言中的一种及 SQL 数据库语言的网站开发 维护和管 理人员 1 3 业务术语 表1 1 业务术语 术语术语 解释解释 二维码码串 根据预下单信息生成的二维码信息 可以用二维码工具根据码串生成一个二维码的图片 二维码图片 根据二维码码串 由支付宝生成的二维码图片 长 512px 宽 512px 二维码小图片 根据二维码码串 由支付宝生成的二维码小图片 长 256px 宽 256px 返回 支付宝根据得到的数据处理完成后 以 XML 数据形式将处理完成的结果信息反馈给商户 网站 分账 将交易的某一部分费用分给其它账户 请求 通过 HTTP 协议把需要传输的数据发送给接收方的过程 通知 服
5、务器异步通知 支付宝根据得到的数据处理完成后 支付宝的服务器主动发起通知给 商户的网站 同时携带处理完成的结果信息反馈给商户网站 统一预下单接口 支付宝 中国 网络技术有限公司 版权所有 版本 2 0 第 6 页 2 功能演示 图2 1 统一预下单流程 3 数据交互 图3 1 商户系统请求 支付宝响应交互模式 1 构造请求数据 商户根据支付宝提供的接口规则 通过程序生成得到签名结果及要传输给支付宝的 数据集合 2 发送请求数据 把构造完成的数据集合 通过页面链接跳转或表单提交的方式传递给支付宝 统一预下单接口 支付宝 中国 网络技术有限公司 版权所有 版本 2 0 第 7 页 3 支付宝对请求
6、数据进行处理 支付宝得到这些集合后 会先进行安全校验等验证 一系列验证通过后便会处理完 成这次发送过来的数据请求 4 返回处理的结果数据 对于处理完成的交易 支付宝会以两种方式把数据反馈给商户网站 把处理完成的结果数据以 XML 的形式返回给商户 支付宝服务器主动发起通知 调用商户在请求时设定好的页面路径 参数 notify url 如果商户没设定 则不会进行该操作 5 对获取的返回结果数据进行处理 商户利用编程方法来模拟 http 请求远程解析 XML 或服务器异步通知页面 参数 notify url 指定页面文件 获取支付宝返回的结果数据后 可以结合自身网站的业 务逻辑进行数据处理 4 请
7、求参数说明 4 1 含义 请求参数是商户在与支付宝进行数据交互时 提供给支付宝的请求数据 以便支付 宝根据这些数据进一步处理 4 2 列表 表4 1 请求参数说明 参数参数 参数名称参数名称 类型 长类型 长 度范围 度范围 参数说明参数说明 是否可是否可 为空为空 样例样例 基本参数基本参数 service 接口名称 String 接口名称 不可空alipay acquire precreate partner 合作者身份 ID String 1 6 签约的支付宝账号对应的支 付宝唯一用户号 以 2088 开头的 16 位纯数字 组成 不可空2088101106499364 input ch
8、arset 参数编码字 符集 String 商户网站使用的编码格式 如 utf 8 gbk gb2312 等 不可空utf 8 统一预下单接口 支付宝 中国 网络技术有限公司 版权所有 版本 2 0 第 8 页 参数参数 参数名称参数名称 类型 长类型 长 度范围 度范围 参数说明参数说明 是否可是否可 为空为空 样例样例 sign ty pe 签名方式 String DSA RSA MD5 三个值可 选 必须大写 不可空MD5 sign 签名 String 请参见 8 签名机制 不可空 9aae99502a8dd70e67d 3d3575f7176cd notify url 服务器异步 通知
9、页面路 径 String 1 90 支付宝服务器主动通知商户 网站里指定的页面http路径 可空 atinterface receive notif y htm alipay ca req uest 签名类型 String 签名类型 1 证书签名 2 其他密钥签名 如果为空 默认为 2 可空 2 业务参数业务参数 out tra de no 商户网站唯 一订单号 String 6 4 支付宝合作商户网站唯一订 单号 不可空205211376305670 subject 订单标题 String 2 56 商品的标题 交易标题 订单 标题 订单关键字等 该参数最长为 128 个汉字 不可空分账测试
10、 sky produc t code 订单业务类 型 String 1 0 用来区分是哪种业务类型的 下单 目前支持 QR CODE OFFLINE 二维码支付 TCOMPANY QR OFFL INE 出租车企业码 不可空QR CODE OFFLINE total fe e 订单金额 number 9 2 该笔订单的资金总额 取值 范围 0 01 100000000 精确 到小数点后 2 位 不可空0 01 seller i d 卖家支付宝 用户号 String 2 8 卖家支付宝账号对应的支付 宝唯一用户号 以2088开头的纯16位数字 如果和 seller email 同时为 空 则本参
11、数默认填充 partner 的值 可空 2088101106499364 统一预下单接口 支付宝 中国 网络技术有限公司 版权所有 版本 2 0 第 9 页 参数参数 参数名称参数名称 类型 长类型 长 度范围 度范围 参数说明参数说明 是否可是否可 为空为空 样例样例 seller email 卖家支付宝 账号 String 1 00 卖家支付宝账号 可以为 email 或者手机号 如果 seller id 不为空 则以 seller id 的值作为卖家账号 忽略本参数 可空 test operat or cod e 操作员类型 String 1 操作员的类型 0 支付宝操作员 1 商户的操
12、作员 如果传入其它值或者为空 则默认设置为 1 可空 1 operat or id 操作员号 String 2 8 卖家的操作员 ID 可空 sky body 订单描述 String 4 00 对一笔交易的具体描述信 息 如果是多种商品 请将 商品描述字符串累加传给 body 可空 商品 x1 show url 商品展示网 址 String 4 00 收银台页面上 商品展示的 超链接 可空 curren cy 订单金额币 种 String 1 0 订单金额币种 目前只支持传入 156 人民 币 如果为空 则默认设置为 156 可空 156 price 商品单价 number 9 2 订单中商品
13、的单价 如果请求时传入本参数 则 必须满足 total fee price quantity 的条件 可空 0 01 quantit y 商品数量 String 1 00 订单中商品的数量 如果请求时传入本参数 则 必须满足 total fee price quantity 的条件 可空 1 goods detail 商品明细 String 5 12 描述商品明细信息 json格 式 具体请参见 4 3 商品 明细说明 可空 goodsName ipad p rice 2000 00 quantity 1 goodsCategory 7 788230 统一预下单接口 支付宝 中国 网络技术有限
14、公司 版权所有 版本 2 0 第 10 页 参数参数 参数名称参数名称 类型 长类型 长 度范围 度范围 参数说明参数说明 是否可是否可 为空为空 样例样例 extend para ms 公用业务扩 展信息 String 1 28 用于商户的特定业务信息的 传递 只有商户与支付宝约 定了传递此参数且约定了参 数含义 此参数才有效 比如可传递二维码支付场景 下的门店ID等信息 出租车 行业的区域标示等信息 以 json格式传输 具体请参见 4 6 业务扩展参数说明 可空 TERMINAL ID BJ 0 01 AGENT ID A800 01 STORE ID BJ Z Z 001 STORE
15、TYPE 0 it b pa y 订单支付超 时时间 String 2 00 设置未付款交易的超时时 间 一旦超时 该笔交易就 会自动被关闭 取值范围 1m 15d m 分钟 h 小时 d 天 1c 当天 无论交易何时创建 都在 0 点关闭 该参数数值不接受小数点 如 1 5h 可转换为 90m 该功能需要联系支付宝配置 关闭时间 可空 1d royalty type 分账类型 String 1 50 卖家的分账类型 目前只支 持传入 ROYALTY 普通分账 类型 如果商户使用分账模式 该 参数不可空 可空 ROYALTY royalty para meters 分账信息 String 2
16、000 描述分账明细信息 json格 式 具体请参见 4 4 分账 明细说明 可空 serialNo 1 transOu t 2088101126765726 transIn 20881011267 08402 amount 0 10 desc 分账测试 1 serialNo 2 trans Out 20881011267657 26 transIn 20881011 26707869 amount 0 10 desc 分账测试2 channe l para meters 渠道参数 String 2 56 描述多渠道收单的渠道明细 信息 json格式 具体请参见 4 5 渠道明细说明 可空 equipment no E001 termId 12233 term Type pos termOsTyp e ios clientVersion 2 1 payeeEquipmentN o F001 payeeTermId X001 payeeTermTy pe phone payeeTer mOsType ios payee ClientVersion 2 0 统一预下单接口 支付宝 中国 网
