向个人收银 (C2B 支付)
接口列表
账单下载

账单下载

按天提供账单文件，接入平台在 D 日当天有成功的交易或退款，则可以在 D+1 日下午 2 点后通过该接口获取账单文件的下载地址。文件内包含交易相关的金额、时间、营销等信息，供接入平台的商户核对订单、退款、银行到账等情况。

接口说明

用途：账单下载
请求方式：
post
https://p.wecard.tencent.com/cloudpay/v1/reconciliation/download_bill

请求参数

Request
Body 包体
ChannelName选填
string

渠道名，CMBPAY:招商银行

最小长度：1     最大长度：32
ChannelMerchantId选填
string

腾讯云商付平台业务线ID，与ChannelSubMerchantId二选一

最小长度：0     最大长度：50
ChannelSubMerchantId选填
string

腾讯云商付平台商户编号（管理控制台→商户管理→商户ID），与ChannelMerchantId二选一

最小长度：0     最大长度：50
BillDate必填
string

账单日期，格式:yyyy-MM-dd

最小长度：1     最大长度：10
BillType必填
string

账单类型，PAYMENT_V2：收单账单、WITHDRAW：提现账单

请求示例

{
  "ChannelName": "CMBPAY",
  "ChannelMerchantId": "CM675649647158980608",
  "BillDate": "2006-01-02"
}

返回参数

Response
Response必填
object

返回示例

{
  "Response": {
    "RequestId": "A8E7B797ADD44C3AA57E87AD7420A725",
    "Result": {
      "BillId": "CM6756496471589806082006010201232",
      "DownloadUrl": "https://xxx.cloud.xxx.com/finance/api/billdownload/file?token=xxx",
      "HashType": "SHA256",
      "HashValue": "79bb0f45fc4c42234a918000b2668d689e2bde04"
    },
    "ErrCode": "SUCCESS",
    "ErrMessage": "成功"
  }
}

账单文件下载

请求方式： GET

账单文件包括明细数据和汇总数据两部分，每一部分都包含一行表头和若干行具体数据。明细数据每一行对应所下载账单的一条具体数据，同时明细数据中每一个字段前都加入了`字符，以避免数据被 Excel 按科学计数法处理。如需汇总金额等数据，可以批量替换掉该字符。具体示例如下：

汇总数据

参数名描述
账单ID当前账单的唯一标识
交易总金额支付订单总金额，单位元，保留到小数点后 2 位
交易总笔数支付订单总笔数
手续费金额支付订单手续费总金额，单位元，保留到小数点后 2 位
退款总金额退款订单总金额，单位元，保留到小数点后 2 位
退款总笔数退款订单总笔数
退手续费金额退款订单手续费总金额，单位元，保留到小数点后 2 位

明细数据

参数名描述
交易时间发起交易订单请求的时间，格式:yyyy-MM-dd HH:mm:ss
交易完成时间交易订单完成的时间，格式:yyyy-MM-dd HH:mm:ss
外部订单号接入方业务系统的订单号
业务线名称腾讯云商付平台业务线名称
业务线简称腾讯云商付平台业务线简称
业务线ID腾讯云商付平台业务线ID
收付类型PAYMENT:付款，INCOME:收款
业务类型PAY:支付，REFUND:退款
平台订单号腾讯云商付平台订单号
合作通道订单号合作通道的订单号
实际支付渠道订单号用户所选支付方式的实际订单号
合单支付订单号合单支付场景下腾讯云商付平台合单支付订单号
商户名称腾讯云商付平台商户名称
商户简称腾讯云商付平台商户简称
商户ID腾讯云商付平台商户ID
付款方腾讯云商付平台付款方ID
订单金额该笔订单的下单金额，单位元，保留到小数点后 2 位
交易状态交易订单的状态，只有SUCCESS
支付方式支付方式，如：微信支付、支付宝等
支付场景支付场景，如：公众号、小程序等
合作通道合作通道，如：微信支付、支付宝等
实付金额该笔订单的实际支付金额，单位元，保留到小数点后 2 位
充值券优惠金额充值型代金券的优惠金额，单位元，保留到小数点后 2 位
免充值券优惠金额免充值型代金券的优惠金额，单位元，保留到小数点后 2 位
渠道手续费合作通道手续费，单位元，保留到小数点后 2 位。根据合作通道数据规则，一般在D+1更新
门店名称门店名称
外部设备ID外部设备ID
备注备注
退款金额退款金额，单位元，保留到小数点后 2 位
外部退款订单号接入方业务系统的退款订单号
平台退款订单号腾讯云商付平台退款订单号
合作通道退款订单号合作通道的退款订单号
退款原因退款原因

ErrCode 码表

错误代码描述解决方案
SUCCESS请求成功请从 Result 中获取数据
FailedOperation.IsEmpty账单记录未生成当天无数据，或账单暂未生成，请稍后重试
FailedOperation.InvalidParameter参数错误请检查传参是否正确
MERCHANT.DATA_NOT_EXIST商户号有误请检查请求的商户号

账单样例.csv

腾讯云商付接口文档