业务功能
初始化扫码请求,通过该请求生成二维码来进行扫码支付。
交互模式
请求:后台请求交互模式
返回结果+通知:后台请求交互模式+后台通知交互模式
接口名称:/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时有效 |
字段 | 类型 | 必填项 | 描述 |
goodsId | string | 是 | 商品编号 |
goodsName | string | 是 | 商品名称 |
quantity | int | 是 | 数量 |
price | int | 是 | 单价(分) |
body | string | 是 | 商品描述信息 |
showUrl | string | 是 | 商品的展示地址 |
响应:
status | text | 渠道交易状态:"00"-请求渠道成功 |
error | text | 渠道错误信息 |
tradeNO | text | 交易流水号 |
payTypeId | int | 支付方式 |
qrCode | text | 订单二维码内容 |