接口名称:扫码支付(预下单)
1.3.1 业务功能
该接口用于JSAPI支付和动态二维码支付的预下单。
1.3.2 请求参数
接口地址:BASEURL+/online/payEntry.do
字段名 | 变量名 | 必填 | 类型 | 中文释义 |
商户订单号 | orderid | 是 | String(32) | 商户系统内部订单号,32个字符内,可包含字母,确保在商户系统唯一 |
商户号 | merid | 是 | String(18) | 商户号,由 小象支付 分配的18位商户号 |
订单金额 | totalfee | 是 | String(12) | 消费总金额,单位为:元 |
订单标题 | subject | 是 | String(20) | 订单标题 |
订单说明 | body | 是 | String(50) | 交易说明(一般为产品信息) |
支付方式 | paymethod | 是 | String(12) | 微信:wx支付宝:zfb百度钱包:bfbQQ钱包:qq京东钱包:jd |
支付方法 | funname | 是 | String(12) | 默认:prepay |
支付宝2.0支付方法 | payway | 否 | String(12) | 支付宝2.0必填,其他支付方式不填。默认:scancode |
支付宝2.0默认参数 | zfbtwo | 否 | String(5) | 支付宝2.0必填,其他支付方式不填。默认:zfbtwo |
二维码超时时间 | ordertime | 否 | String(4) | 未付款交易的超时时间,一旦超时,该笔交易就会自动被关闭。单位为分钟,纯数字,不接受小数;取值范围:1~30;若大于30,或者不传该参数则默认为2。 |
异步通知地址 | notifyurl | 否 | String(300) | 订单支付完成之后, 小象支付 会向此地址发送异步通知,详情参考1.9 |
交易类型 | tradetype | 否 | String(10) | 微信内H5支付必填,否则不用;默认:JSAPI |
微信用户openid | subopenid | 否 | String(32) | 微信内H5支付必填,否则不用;微信用户openid,获取方法参考:https://mp.weixin.qq.com/wiki/17/c0f37d5704f0b64713d5d2c37b468d75.html |
小象支付门店编号 | storecode | 否 | String(32) | 一个商户可以有多个门店,如果不传默认交易进入总店;如果传了门店号,交易则进入对应的门店下。 |
附加数据 | attach | 否 | String(128) | 附加数据,在查询API和支付通知中原样返回,该字段主要用于商户携带订单的自定义数据 |
终端IP | ip | 否 | String(16) | H5支付必传 |
场景信息 | sceneinfo | 否 | String(256) | H5支付必传{“h5_info”: //h5支付固定传”h5_info” {“type”: “”, //场景类型 “wap_url”: “”,//WAP网站URL地址 “wap_name”: “” //WAP 网站名 } } |
签名 | sign | 是 | String(32) | 生成方法见1.2 |
1.3.3 参数返回
字段名 | 变量名 | 必填 | 类型 | 中文释义 |
通用返回参数 | ||||
响应码 | flag | 是 | String(6) | 小象支付 接口响应码 |
响应内容 | msg | 是 | String(50) | 小象支付 接口对响应码的解释 |
以下参数只有当flag为00的时候有返回 | ||||
当支付方式为扫码支付返回参数 | ||||
二维码图片URL | codeurl | 是 | String(50) | 可直接使用,如:https://olservice-test.xiangfubao.com.cn/qrcode/201501260507251 |
小象支付 订单号 | outtradeno | 是 | String(32) | 小象支付 交易流水号 |
二维码短链接 | shorturl | 是 | String(100) | 可用此链接自行生成二维码,用来扫码支付 |
当支付方式为微信JSAPI支付返回参数 | ||||
预下单ID | prepayid | 是 | String(100) | 微信预下单订单号,1.4接口使用 |
微信公众号 | appid | 是 | String(18) | 微信公众号,1.4接口使用 |
时间戳 | timestamp | 是 | String(20) | 时间戳,1.4接口使用 |
随机字符串 | noncestr | 是 | String(20) | 随机字符串,1.4接口使用 |
签名方式 | signtype | 是 | String(10) | 签名方式,1.4接口使用 |
支付签名 | paysign | 是 | String(32) | 支付签名,1.4接口使用 |
当支付方式为浦发微信JSAPI支付返回参数 | ||||
订单号 | outtradeno | 是 | String(32) | 小象支付 交易流水号 |
JSAPI支付链接地址 | packjspayurl | 是 | String(1024) | 浦发微信JSAPI支付链接地址,在页面中直接打开,即可调起微信收银台进行支付。 |