## **统一下单** ## - **请求地址**：cgi-bin/\_pay\.cgi - 请联系我们获取测试商户信息、请求密钥和回调密钥。 - 在生产环境走完协议流程并完成联调提交测试报告后，我们运营同事会将参数提供给贵司 - 支持微信、支付宝、银联二维码交易 - 支持支付宝拉码支付、公众号支付、服务窗支付、银联JS支付、微信小程序支付**参数：**- 请求参数| 参数名| 变量名| 必填| 限制| 类型| 说明|| :------------------- | :--------------- | :--- | ---- | ------ | -------------------------------------------------------- || 接口名称| | M | 无| | （这个是固定值）|| 支付类型| | M | 16 | | 详情见下方支付类型|| 商户编号| | M | 10 || 分配|| 商户订单号| | M | 64 | | 商户内部订单号，可包含字母：保证同一商户下唯一|| 订单金额| | M | 10 | | 总金额|| 支付类型| | M | 1 | | 0-支付宝扫码支付；1-微信公众号、支付宝服务窗口支付；2-微信公众号、支付宝服务窗口支付；3-微信小程序支付、支付宝小程序支付|| 公众号| | O | 32 | | 微信公众号ID；微信公众号支付的公众号ID。

选填，若传递则用于下单，若不传递则使用商户提交申请时的最新配置。|| 用户子id| | C | 32 | | 微信公众号、小程序、支付宝服务窗口、支付宝小程序、银联JS支付必选|| 业务开发参数| ms|O|None|JSON| 目前支付宝扫码下单可以透传的参数，，，，，具体格式请看下面文档：业务开发参数示例|| 前端跳转地址| | C | 128 | | 简单支付必选：支付完成后会跳转到此页面，需要处理|| 通知地址| | O | 128 | | 接收通知的URL，需要处理，要求是绝对路径才能保证能正确访问，若不需要回调请忽略|| 用户IP地址| | O | 16 | |发起交易的商户IP地址|| 商品描述| body| O | 256 | | 商品描述，不能包含回车换行等特殊字符|| 商户门店编号| | O | 16 | | 只能为汉字、英文字母、数字|| 商户终端编号| | O | 16 | | 只能为汉字、英文字母、数字|| 附加数据| | O | 96 | | 原样返回|| 指定支付方式| | O | 1 | | 1：禁止信用卡；0或空：无限制|| 订单折扣标签| | O | 32 | | 订单折扣标签，透传给微信|| 商品详情| | O | 6000 | | 以微信单品优惠券格式传递，透传给微信，请做好|| 订单有效期| | O | 无| | 单位：秒（支付宝最小超时粒度为分钟，建议发送60的整数倍）||花呗分期号| | O | 无| | 支付宝花呗分期号，支持3期、6期、12期|| 前端跳转地址| | C | 无| | 银联JS支付可选，支付成功时跳转。

、需要同时出现|| 支付失败时前端跳转地址| | C | 无| | 银联JS支付可选，支付失败时跳转。 、需要同时出现|| 随机串| | M | 32 | | 随机串|| 签名| sign| M | 32 | | MD5签名结果|- 返回参数| 参数名| 变量名| 必填| 限制| 类型| 说明|| ------------ | --------------- | ---- | ---- | ------ | ------------------------------------------------------------ || 返回状态码| | M | 无| | 0-成功，非0-失败。说明：该字段为通讯标识，是否获取二维码取决于|| 返回错误信息| | C | 无| | 错误描述：非0时返回|| 业务结果| | M | 1 | | 0-成功，非0-失败|| 错误码| | O | 无| | 参考错误码|| 错误码说明| | O | 无|错误信息描述|| 商户号| | M | 10 | | 分配||渠道商户号||M|无||微信、支付宝、QRC商户号|| 商户订单号| | M | 64 | | 商户内部订单号|| 随机串| | M | 32 | | 随机串|| 签名| sign| M | 32 | | MD5签名结果|| 二维码链接| | C | 无| | 非公众号支付返回，您可以通过此链接直接生成二维码扫描支付|| 支付信息| | C | 无| | 原生公众号、服务窗、小程序、h5支付，json格式字符串时返回|| 支付跳转地址| | C | 无| | 简易支付时返回。

跳转至该URL即可完成后续支付流程。 || 订单号| | M | 32 | | 订单号|| 支付类型| | M | 无| | 支付类型详情见下方| **备注** - 获取微信用户``````- 获取支付宝用户``````- 商户拓展参数示例```"ms":"{ "":{ "":"", "":"//main?suid=10" },"":[{"":"5544","":"爽口青笋丝", "":"0.50", "":2,"\":"888","\":"888", "body":"爽口青笋丝", "show\_url":"//main?suid=10" }], "":{ "_id":"2551", "":""} }",```#### **支付类型**| 类型| 说明|状态|| ------ | ---------- | ---- || WXZF | 微信| 支持|| | 支付宝| 支持|| | 银联二维码| 支持|**注意事项**- 所有金额单位为分，币种为人民币，最小为1分，不允许小数- 文档中标记为必填的参数必须提交（若缺失会报错），非必填的参数可不提交- 标记为必填的参数一定会返回，标记为否的参数可能不会返回。由于升级或配置，实际返回的参数可能与文档不完全相同，请以实际收到的参数为准