甬易支付文档中心

主题

手续费汇总查询 ​

接口描述 ​

商户通过调用该接口查询手续费汇总信息，支持按月份范围和开票状态进行筛选查询，支持分页。

请求URL ​

  • /invoice/fee/inquiry

请求方式 ​

  • POST

公共请求参数 ​

参数名必选类型最大长度说明示例
appId是string应用ID202415629590370906
signature是string签名
transNonce是string32请求流水号43e2c287-24b1-4cd1-b3d2-e40e7840cc40
transDate是string13请求时间，13位时间戳1731406784607

请求参数 ​

参数名必选类型最大长度说明示例
merchantNo是string商户编号XS240820000054
startTime否string汇总月份(起始)，格式：yyyy-MM2024-01
endTime否string汇总月份(结束)，格式：yyyy-MM2024-12
gatherStatus否string手续费状态：I-未开票，P-开票中，F-开票失败，S-开票成功，A-开票申请中I
pageNum否integer页码1
pageSize否integer每页大小10

请求报文示例 ​

json
{
  "appId": "202415629590370906",
  "signature": "pz+Z8unqO2VBjTGtzWASCCfzix5QxODSkAdKKyPiVXIXLtp574xCmuWaOeHfslnbUK2RKsYdNy/OhcMPV+GMaoXxcXuDvmVhUdKHWgYODovK5GbbqfqaT+nrzO0xnNz8rLCnevTQ3y4+Qn6++xVlwyMOW3SDw9gRM5qF40TlectpvylieoFROXzYIHXBveRrcT3FQSwnoNamNet/k7OTvotiT0Fft6SGDflqkWeHhiP83265OSMvQPwtIcEStyTv4AHLsWC5pSd7zTQ+pkvetMlm0AAwO6Jl4xUYx+OZkBM8vpgxqAQa4yzV9mTwfsaFZsKRnTXTJdFVHr9xONro5g==",
  "transDate": "1731469621597",
  "transNonce": "43e2c287-24b1-4cd1-b3d2-e40e7840cc40",
  "merchantNo": "XS241026000093",
  "startTime": "2024-01",
  "endTime": "2024-12",
  "gatherStatus": "I",
  "pageNum": 1,
  "pageSize": 10
}

公共响应参数 ​

参数名必选类型最大长度说明示例
code是string响应编码00000000
message是string响应信息成功
signature是string签名
transNonce是string32请求流水号(同入参)123456
transDate是string13响应时间，13位时间戳1731406784607

响应参数 ​

参数名必选类型最大长度说明示例
total是integer总记录数100
pageNum是integer当前页码1
pageSize是integer每页大小10
list是array查询结果列表

list 列表项说明 ​

参数名必选类型最大长度说明示例
gatherMonth是string汇总月份2024-01
gatherFeeId是string汇总ID202401001
gatherFeeAmount是string汇总手续费金额10000
gatherStatus是string状态：I-未开票，P-开票中，F-开票失败，S-开票成功，A-开票申请中I
pdfUrl否string发票PDF下载地址
ofdUrl否string发票OFD下载地址
xmlUrl否string发票XML下载地址

响应示例 ​

json
{
  "code": "00000000",
  "message": "成功",
  "signature": "pz+Z8unqO2VBjTGtzWASCCfzix5QxODSkAdKKyPiVXIXLtp574xCmuWaOeHfslnbUK2RKsYdNy/OhcMPV+GMaoXxcXuDvmVhUdKHWgYODovK5GbbqfqaT+nrzO0xnNz8rLCnevTQ3y4+Qn6++xVlwyMOW3SDw9gRM5qF40TlectpvylieoFROXzYIHXBveRrcT3FQSwnoNamNet/k7OTvotiT0Fft6SGDflqkWeHhiP83265OSMvQPwtIcEStyTv4AHLsWC5pSd7zTQ+pkvetMlm0AAwO6Jl4xUYx+OZkBM8vpgxqAQa4yzV9mTwfsaFZsKRnTXTJdFVHr9xONro5g==",
  "transDate": "1731469621597",
  "transNonce": "43e2c287-24b1-4cd1-b3d2-e40e7840cc40",
  "total": 100,
  "pageNum": 1,
  "pageSize": 10,
  "list": [
    {
      "gatherMonth": "2024-01",
      "gatherFeeId": "202401001",
      "gatherFeeAmount": "10000",
      "gatherStatus": "I",
      "pdfUrl": "",
      "ofdUrl": "",
      "xmlUrl": ""
    }
  ]
}

备注 ​