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

账单下载

按天提供账单文件，接入平台在 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

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

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

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

账单类型，PAYMENT：收单账单、WITHDRAW：提现账单，默认PAYMENT

请求示例

{
  "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 位

明细数据

参数名描述
交易日期格式:yyyy-MM-dd
渠道编码下方支付渠道的通道，如：wechat、icbc、huifu
二级渠道下方渠道实际的支付渠道，如 wechat、alipay、unionpay
业务线ID微卡平台业务线 ID
商户名称微卡平台商户名称
商户ID微卡平台商户 ID
外部订单号外部商户订单号
系统订单号微卡平台订单号
第三方订单号渠道订单号
外部退款单号外部商户退款单号
系统退款单号微卡平台退款单号
第三方退款单号渠道退款单号
收付类型PAYMENT:付款，INCOME:收款
业务类型PAY:支付，REFUND:退款，TRANSFER:转账
交易申请时间格式:yyyy-MM-dd HH:mm:ss
交易完成时间格式:yyyy-MM-dd HH:mm:ss
交易金额（元）该笔订单的下单金额，单位元，保留到小数点后 2 位
退款金额（元）该笔订单的申请退款金额，单位元，保留到小数点后 2 位
服务费（元）该笔订单的服务费金额，单位元，保留到小数点后 2 位
收款人账号该笔订单的下单的收款人账号
收款人名称该笔订单的下单的收款人名称
付款人账号该笔订单的下单的用户账号
付款人名称该笔订单的下单的用户名称
订单附加信息订单备注，使用JSON格式字符串存储订单额外信息
扩展字段 1扩展字段，备用
扩展字段 2扩展字段，备用
实际支付渠道订单号用户所选支付方式的实际订单号

ErrCode 码表

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

账单样例.csv

腾讯微卡收付通接口文档