创建渠道同步支付订单
描述
用于 BSC 等不走收银台直接发起收款场景。
路径
/optimus/core/open/cashier/proxyCreatedPay
入参说明(JSON 格式)
入参整体结构
| 参数 |
参数名称 |
类型 |
是否必传 |
描述 |
示例 |
| appid |
应用id |
String |
Y |
固定值 |
见测试参数 |
| orderID |
订单信息 |
Object |
Y |
前置操作后拿到 |
|
| usingPayTool |
支付工具 |
Object |
Y |
|
|
| paymentEnv |
支付环境 |
Object |
N |
建议上报 C 端支付 IP 和经纬度 |
BSC 必传 |
入参字段结构
orderID 字段明细
| 参数 |
参数名称 |
类型 |
是否必传 |
描述 |
| sn |
订单编号 |
String |
Y |
前置操作后拿到 |
| signature |
订单密码 |
String |
Y |
前置操作后拿到 |
usingPayTool 字段明细
| 参数 |
参数名称 |
类型 |
是否必传 |
描述 |
示例 |
| id |
支付工具ID |
Long |
Y |
BSC 填 -1,支付宝 2,微信 3 |
|
| payTool |
支付工具代码 |
Integer |
Y |
BSC 填 -1,支付宝 2,微信 3 |
|
| payMode |
支付模式 |
Integer |
Y |
BSC 填 1,支付宝 4,微信 4 |
|
| amount |
支付金额 |
Long |
Y |
|
|
| identity |
用户身份信息 |
String |
Y |
BSC 填 barCode,微信/支付宝填 openId |
|
| channelExt |
通道扩展参数 |
Map\ |
N |
{"channelExt":{"sub_appid":"wx36e68952a60af089"}} |
微信小程序支付需要填 |
paymentEnv 字段明细
| 参数 |
参数名称 |
类型 |
是否必传 |
描述 |
| clientIp |
付款终端ip |
String |
Y |
上报 C 端支付 IP |
| clientPoi |
付款经纬度 |
Object |
Y |
上报支付经纬度 |
paymentEnv.clientPoi 字段明细
| 参数 |
参数名称 |
类型 |
是否必传 |
| longitude |
经度信息 |
String |
Y |
| latitude |
纬度信息 |
String |
Y |
出参说明(JSON 格式)
出参整体结构
| 参数 |
参数名称 |
类型 |
描述 |
示例 |
| success |
请求状态 |
Boolean |
true:成功;false:失败 |
TRUE |
| code |
状态码 |
String |
0000:成功;其他为异常码 |
"0000" |
| msg |
状态描述 |
String |
请求结果的描述信息 |
"处理成功" |
| data |
订单数据 |
Object |
支付下单数据 |
错误码
| code |
msg |
描述 |
| 6998 |
外部调用超时 |
需要查询 |
| 6999 |
外部调用失败 |
不需要查询 |
| 9999 |
系统错误 |
不需要查询 |
| 6048 |
订单不存在 |
不需要查询 |
出参字段结构
data 字段明细
| 参数 |
参数名称 |
类型 |
描述 |
示例 |
| acquiringDetailsState |
收单状态 |
Byte |
0:待处理,1:处理中,2:处理成功,3:处理失败,4:已关闭,5:临时处理失败 |
0/1 BSC 需要轮询结果 超时60秒,其他可等支付回调;2 成功;3/4/5/6 可以直接失败 |
| orderAmount |
支付金额 |
Object |
|
|
| paymentVoucher |
支付凭证 |
Object |
支付宝/微信 拉起收银台需要 |
|
| channelInfo |
通道信息 |
Object |
|
|
| printShortUrl |
订单短链 |
String |
支付成功才返回 |
amount 字段明细
| 参数 |
参数名称 |
类型 |
描述 |
| totalAmount |
收单总金额 |
Long |
|
| paidAmount |
实际支付金额 |
Long |
可能渠道有优惠 |
channelInfo 字段明细
| 参数 |
参数名称 |
类型 |
描述 |
| payWay |
支付方式 |
String |
2 支付宝 3 微信 17 云闪付 |
| payWayDesc |
支付方式 |
String |
支付宝/微信/云闪付 |
| tsn |
收钱吧单号 |
String |
|
| channelFinishTime |
渠道完成时间 |
String |
时间戳,毫秒 |
| channelErrMsg |
渠道错误文案 |
String |
示例
{
"appid": "2025082700005615",
"orderID": {
"sn": "2026032016412219191",
"signature": "b4BFXQ06jrRkDCSKNgGt",
},
"usingPayTool": {
"id": -1,
"payTool": -1,
"amount": 1,
"identity": "oAgds7T0nw06RtwQ-08qoLyU8SGs",
"payMode": 1,
"channelExt": {
"sub_appid": "wx36e68952a60af089"
}
},
"paymentEnv": {
"clientIp": "10.12.134.48",
"clientPoi": {
"longitude": "120.710893",
"latitude": "31.345654"
}
}
}