商户管理服务
接口列表
提现账单下载

账单下载

按天提供账单文件，接入平台在 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
外部提现单号外部商户提现单号
系统提现单号微卡平台提现单号
第三方提现单号渠道提现单号
系统退票单号微卡平台退票单号
第三方退票单号渠道退票单号
交易申请时间格式:yyyy-MM-dd HH:mm:ss
交易完成时间格式:yyyy-MM-dd HH:mm:ss
提现类型SUBMERCHANT-商户、PAYEE-分账接受方、PAYER-用户、SUBACCOUNT-账户
名称根据提现类型，显示对应的名称。比如提现类型为商户，则这里显示商户名称
ID展示名称对应的ID。商户、分账接收方、用户、账户的ID
合作通道下方提现渠道的通道，如：CMBPAY
提现卡开户名提现银行卡的开户名
提现卡银行账号提现银行卡的银行账号
提现金额（元）该笔提现单的提现金额，单位元，保留到小数点后 2 位
手续费（元）该笔提现单的手续费金额，单位元，保留到小数点后 2 位
银行附言提现银行附言
状态提现状态:提现成功、退票
订单附加信息提现备注，使用JSON格式字符串存储提现单额外信息
扩展字段 1扩展字段，备用
扩展字段 2扩展字段，备用

ErrCode 码表

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

账单样例.csv

腾讯微卡收付通接口文档