向个人收银 (C2B 支付)
接口列表
授权订单完成

授权订单完成

用户使用服务完成后,业务方调用此接口将订单完成并免密扣款

接口说明

请求方式:
post
https://p.wecard.tencent.com/cloudpay/v1/pay/c2b/complete_authorize_order

请求参数

Request
Body 包体
OutOrderId选填
string

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


ChannelOrderId选填
string

微卡收付通平台订单号


TotalAmount必填
integer

订单金额,单位:分


OrderSubject选填
string

订单标题


FinishTime选填
string

订单完成时间,格式:2023-03-05 11:54:20


ExternalPaymentData选填
string

支付渠道扩展字段,第三方通道的扩展信息,根据具体对接的渠道情况传值;如:微信、支付宝下单时需要将用户的openid或userid,及应用id传入,结构如下

请求示例

{
  "ChannelSubMerchantId": "CM520553582492195176",
  "OutOrderId": "link202407040101",
  "TotalAmount": "1",
  "OrderSubject": "苹果14promax",
  "FinishTime": "2024-07-04 16:45:00",
  "ExternalPaymentData": "{\"WxAppId\":\"wx80000\",\"WxOpenId\":\"oHBg000000fcb2crhk8\",\"WxServiceId\":\"00003029000000166626030124548862\"}"
}

返回参数

Response
Response选填
object

返回示例

{
  "Response": {
    "RequestId": "A8E7B797ADD44C3AA57E87AD7420A725",
    "Result": {
      "OutOrderId": "poc202211200001",
      "ChannelOrderId": "679735736991281152",
      "ThirdPayOrderId": "WCB20201021200102012",
      "PayAmount": 1000,
      "OrderStatus": "PAYING"
    },
    "ErrCode": "SUCCESS",
    "ErrMessage": "成功"
  }
}

ExternalPaymentData 结构

变量类型是否必填描述
WxAppIdstring微信开放平台审核通过的应用 AppId.(如:公众号 AppId/小程序 AppId)
WxOpenIdstring微信用户在当前 WxAppId 下的 Openid,公众号及小程序场景下微信支付必填
WxServiceInfoWxServiceInfo微信订单服务信息,免密支付场景下微信支付必填
AliAppIdstring支付宝开放平台审核通过的应用 AppId.(如:生活号 AppId/小程序 AppId)
AliUserIdstring支付宝用户在当前 AppId 下的 Userid,公众号及小程序场景下支付宝支付必填

WxServiceInfo 结构

变量类型是否必填描述
ServiceIdstring微信开放平台审核通过的支付分服务ID,该服务ID有本接口对应产品的权限
ServiceStartTimestring服务开始时间,格式:2023-03-05 11:54:20
ServiceEndTimestring服务结束时间,格式:2023-03-05 11:54:20

ErrCode 码表

错误代码描述解决方案
SUCCESS请求成功请从 Result 中获取业务数据
ORDER.INVALID_PARAMETER参数有误请根据返回描述修正请求参数
ORDER.RECORD_NOT_EXIST订单不存在订单不存在,请检查订单号是否正确
FailedOperation.SystemError系统未知异常系统未知异常,请稍后重试

腾讯微卡收付通接口文档