业务功能
初始化扫码请求,通过该请求生成二维码来进行扫码支付。
交互模式
请求:后台请求交互模式
返回结果+通知:后台请求交互模式+后台通知交互模式
| 接口名称:/open/v2/preCreate |
|---|
请求参数:
| 字段 | 类型 | 必填项 | 描述 |
| sn | text | 是 | 设备号、虚拟设备号 |
| outTradeId | text | 是 | 第三方交易流水号,不长于50位,第三方全局唯一 |
| tradeAmount | int | 是 | 订单金额(单位分) |
| payTypeId | number | 是 | 支付方式0-自动判断、 1003微信、1004支付宝、1010银联扫码 |
| isSharing | bool | 否 | 是否可分账,可不传 |
| subject | string | 否 | 商品信息 |
| cashierType | int | 否 | 收银台类型:不填默认0 渠道主扫请求,1 渠道收银台请求,2 平台一码付请求 |
| isMiniProgram | bool | 否 | 是否小程序,默认否;当收银台类型为2时,传入值有效 |
| remark | text | 否 | 备注 |
| notifyUrl | text | 是 | 支付结果后台通知地址 |
| goodsTag | text | 否 | 微信订单优惠标记 |
| goodsDetail | json array | 否 | 商品对象数组 |
| clientIP | text | 否 | 收款客户端IP |
| appId | text | 否 | 可空,可选择填写服务商公众号AppID或子商户公众号appId,特定渠道有效 |
| openId | text | 否 | 可空,填写appId对应的openId,特定渠道有效 |
| isProcedureCustomer | number | 否 | 不传默认3,如不从交易商户扣除手续费传0,,isSharing为true时生效 |
| receivers | array对象 | 否 | 分账对象:[{merchantId:平台接收人商户ID,amount:分给金额,单位分,isProcedureCustomer: 不传默认为0,如需从该商户扣除手续费,传3}],isSharing为true时生效 |
| splitNotifyUrl | text | 否 | 分账结果后台通知地址 |
| enablePayChannels | text | 按条件 | 易票联渠道使用花呗分期时传pcreditpayInstallment |
| instalmentsNum | int | 按条件 | 仅支持分期3、6、12期 |
| splitRemarks | text | 否 | 分账备注,仅isSharing为true时有效 |
| promotionInfo | array对象 | 否 | 营销信息,示例:自定义支付立减:[{"amount":"1","type":"CUSTOM_REDUCTION"}],amount 单位分,仅易宝渠道支持 |
| jdExt | json对象 | 否 | 京东附加信息,示例:{"riskinfo":"","goodsInfo":"","receiverInfo":"","industryCategoryCode":""},仅京东白条渠道支持 |
| 字段 | 类型 | 必填项 | 描述 |
| goodsId | string | 是 | 商品编号 |
| goodsName | string | 是 | 商品名称 |
| quantity | int | 是 | 数量 |
| price | int | 是 | 单价(分) |
| body | string | 是 | 商品描述信息 |
| showUrl | string | 是 | 商品的展示地址 |
响应:
| status | text | 渠道交易状态:"00"-请求渠道成功 |
| error | text | 渠道错误信息 |
| tradeNO | text | 交易流水号 |
| payTypeId | int | 支付方式 |
| qrCode | text | 订单二维码内容 |