向企业收银 (B2B 支付)
接口列表
SDK 支付
预下单

预下单

该接口需要配合微卡收付通提供的 SDK 一起使用，业务方调用该接口获取下单信息 PayInfo 后调用 SDK 进入收银台

接口说明

请求方式：
post
https://p.wecard.tencent.com/cloudpay/v1/pay/b2b/pre_order

请求参数

Request
Body 包体
ChannelSubMerchantId必填
string

微卡收付通平台商户编号（管理控制台→商户管理→商户ID）

最小长度：1     最大长度：50
PayerId选填
string

微卡收付通用户id，调用新增用户创建。用户信息，转账支付、余额支付必填

最小长度：1     最大长度：50
TotalAmount必填
integer

订单金额,单位：分

OutOrderId必填
string

外部订单号，即业务系统侧订单；
只能是数字、大小写字母、下划线；且在同一个主体下唯一。

最小长度：6     最大长度：60
OrderSubject必填
string

订单标题

最小长度：1     最大长度：200
GoodsDetail选填
string

商品信息

最小长度：1     最大长度：200
NotifyUrl选填
string

支付成功后的回调地址

最小长度：1     最大长度：25
ExpireTime选填
string

订单过期时间，格式：2023-03-05 11:54:20。
不传则默认30分钟，若在过期时间之前未完成支付，订单将会流转为失败，不可再进行支付。

最小长度：0     最大长度：18
ProfitShareFlag选填
string

是否允许分账标识：
API_PROFIT_SHARE:允许调用请求分账;
NO_PROFIT_SHARE:不允许调用请求分账;
额外说明：该字段用于标明当前订单是否允许调用请求分账；当接口传递了分账域或商户设置分账模板时，会忽略本字段；当本字段不传时，等同于传递:NO_PROFIT_SHARE

ProfitShareInfoList选填
array

分账信息列表

数组子类型：object

FundAllocateList选填
array

资金划拨信息。支付通道耦合银行账户体系时必填，否则不用。

数组子类型：object

请求示例

{
  "ChannelSubMerchantId": "CM6756531983210274560",
  "PayerId": "14652edcbda",
  "TotalAmount": 1000,
  "OrderSubject": "苹果14promax",
  "OutOrderId": "otto202211200001",
  "NotifyUrl": "https://business.com/pay/notify"
}

返回参数

Response
Response必填
object

返回示例

{
  "Response": {
    "RequestId": "cd7f1cccf6d7425c86ed52a44ebc7d55",
    "Result": {
      "OutOrderId": "demo202300511000001211",
      "OrderStatus": "BEFORE",
      "FailReason": "",
      "PayInfo": "{\"AppId\":\"1682021751\",\"ChannelSubMerchantId\":\"CM488565698239469775\",\"ChannelSubMerchantShortName\":\"微信支付商户-线上环境-腾讯科技有限公司\",\"OutOrderId\":\"demo202300511000001211\",\"PayerId\":\"\",\"Sign\":\"2600f9d9975c6c978a0c0f32b24bd877\",\"TotalAmount\":\"1\"}"
    },
    "ErrCode": "SUCCESS",
    "ErrMessage": "成功"
  }
}

ErrCode 码表

错误代码描述解决方案
SUCCESS请求成功请从 Result 中获取订单数据
FailedOperation.SystemError系统未知异常系统未知异常，请稍后重试
ORDER.INVALID_PARAMETER参数有误请根据返回描述修正请求参数
ORDER.OPERATE_IS_PROCESSING订单存在并发操作当前支付订单同时存在别的请求操作 (如下单、退款、关单等)，请稍后重试
ORDER.ORDER_RECORD_ALREADY_EXIST订单已存在订单已存在，并且状态不为预下单状态，请调用查单接口确认订单状态
腾讯微卡收付通接口文档