向个人收银 (C2B 支付)
接口列表
订单码生成

订单码生成

业务方调用该接口生成订单，并获取订单码内容（内容为一个链接）。 通过将订单码内容渲染成二维码给用户扫码，或直接跳转到该连接上完成支付流程。 该场景微卡收付通负责支付的流程闭环，业务方只需要调用此接口获取订单码内容，提供给用户扫码或跳转即可。

接口说明

请求方式：
post
https://p.wecard.tencent.com/cloudpay/v1/qrpay/create_qrcode_pre_order

请求参数

Request
Body 包体
ChannelSubMerchantId必填
string

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

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

订单金额,单位：分

OutOrderId必填
string

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

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

支付渠道；实际支付渠道，根据具体接入的通道传值：如：
ALIPAY: 支付宝；
WXPAY:微信支付；
UNIONPAY：银联支付

最小长度：1     最大长度：30
OrderSubject必填
string

订单标题

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

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

最小长度：1     最大长度：19
ProfitShareFlag选填
string

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

ProfitShareInfoList选填
object

分账信息列表

Attachment选填
string

附加信息，在查询API和支付通知中原样返回，可作为自定义参数使用，实际情况下只有支付完成状态才会返回该字段

最小长度：1     最大长度：128
Remark选填
string

付款备注

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

支付成功后的回调地址

最小长度：1     最大长度：255
FrontUrl选填
string

用户支付成功后，前端跳转URL

最小长度：1     最大长度：255

请求示例

{
  "ChannelSubMerchantId": "CM675653152590274560",
  "OrderSubject": "iphone14promax",
  "ExternalPaymentData": "{\"WxAppId\":\"wx422bf31b9ffbc08c\"}",
  "NotifyUrl": "https://business.com/aggrpay/pay/notify",
  "OutOrderId": "OUT2022111900000004",
  "Remark": "ottotest",
  "TotalAmount": 11
}

返回参数

Response
Response必填
object

返回示例

{
  "Response": {
    "RequestId": "A8E7B797ADD44C3AA57E87AD7420A725",
    "Result": {
      "OutOrderId": "OUT2022111900000004",
      "ChannelOrderId": "679735736991281152",
      "TotalAmount": "11",
      "RedirectInfo": {
        "QRCodeUrl": "https://p.wecard.tencent.com/cloudpay/v1/qrpay/scan_qrcode_order?qr=QR20221125681878591621115904"
      }
    },
    "ErrCode": "SUCCESS",
    "ErrMessage": "成功"
  }
}

ErrCode 码表

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