预下单
该接口需要配合微卡收付通提供的 SDK 一起使用，业务方调用该接口获取下单信息 PayInfo 后调用 SDK 进入收银台
接口说明
请求方式：
posthttps://p.wecard.tencent.com/cloudpay/v1/pay/c2b/pre_order
请求参数
Request
Body 包体
ChannelSubMerchantId必填
string
微卡收付通平台商户编号（管理控制台→商户管理→商户ID）
最小长度：1 最大长度：50
TotalAmount必填
integer
订单金额,单位：分
OutOrderId必填
string
外部订单号，即业务系统侧订单；
只能是数字、大小写字母、下划线；且在同一个主体下唯一。
最小长度：6 最大长度：60
OrderSubject必填
string
订单标题
最小长度：1 最大长度：200
GoodsDetail选填
string
商品信息
最小长度：1 最大长度：200
Attachment选填
string
附加信息，查询时原样透传
最小长度：1 最大长度：255
NotifyUrl选填
string
支付成功后的回调地址
最小长度：1 最大长度：255
ExpireTime选填
string
订单过期时间，格式：2023-03-05 11:54:20
最小长度：1 最大长度：18
ProfitShareInfoList选填
array
分账信息列表
数组子类型：object
FundAllocateList选填
array
资金划拨信息。支付通道耦合银行账户体系时必填，否则不用。
数组子类型：object
{
"ChannelSubMerchantId": "CM6756531983210274560",
"TotalAmount": 1000,
"OrderSubject": "杂粮煎饼",
"OutOrderId": "otto202211200001",
"NotifyUrl": "https://business.com/pay/notify",
"FundAllocateList": [
{
"ChannelSubMerchantId": "CM-B",
"AllocateAmount": 200
},
{
"ChannelSubMerchantId": "CM-C",
"AllocateAmount": 100,
"Freeze": true
}
]
}
返回参数
Response
200 OK
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 | 订单已存在 | 订单已存在，并且状态不为预下单状态，请调用查单接口确认订单状态 |