创建渠道同步支付订单

描述

用于 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"
    }
  }
}

results matching ""

    No results matching ""