SaaS 报表接口文档
1. 简介
给合作方提供对账接口
请求地址，请求头信息参看文档: saas公共请求及响应参数-3. 请求公共参数信息
响应头信息参看文档: saas公共请求及响应参数-4. 响应公共参数信息
2.业务接口
2.1 交易对账文件下载
介绍：下载交易对账文件
接口地址: /sass/report
Header 参数
| 字段名 | 类型 | 是否必传 | 字段名称 | 说明 |
|---|---|---|---|---|
| interfaceVersion | String | 是 | 版本号 | 默认值:1.0.0 |
| language | String | 否 | 语言 | 语言(zh_CN,zh_TW,en_US)默认取值:zh_CN |
| interfaceName | String | 是 | 接口名称 | 填写:getReportUrl |
| businessType | String | 是 | 业务类型 | 填写:report |
| orgNo | String | 是 | 机构编号 | |
| orgCertId | String | 是 | 机构密钥证书序列号 | |
| signature | String | 是 | 机构签名 | |
| signMethod | String | 是 | 机构签名方法 | 取值范围:RSA-SHA256,ECDSA-SHA256,HMAC-SHA256 |
请求参数
| 字段名 | 类型 | 是否必传 | 字段名称 | 说明 |
|---|---|---|---|---|
| reconciliationDay | String | 是 | 服务商对账日 | 格式：yyyyMMdd |
| reportType | String | 是 | 报表类型 | ORG_RECONCILIATION:交易对账文件 |
| version | String | 是 | 版本号 | V1.0 |
Curl请求示例
curl --location '${PAYMENT_DOMAIN}/sass/report' \
--header 'businessType: report' \
--header 'interfaceName: getReportUrl' \
--header 'interfaceVersion: 1.0.0' \
--header 'language: zh_CN' \
--header 'orgNo: S**************' \
--header 'orgCertId: ****************************************' \
--header 'signature: eWr1SEjLJKkyUHtcNnm0jlk2CEy1ohyJ8gqqqyXNvdutFRLdnlDle70P6IkxwlCDCB853/29ErtrFh9IdkarltiWyO8NYXRZ/nCvqmtgUEpx3vIzJei+Q6Ffn/Q/DzwPPOFsYn3jCzNwAa/Dh70Wg22I3cr2cvohdQkpknvaAhe1/bSlmTMu9lXVOxdFr5J29memm3GXY1oioBBrzVu8NwQvTC3beIyRydwaVeXljhdbPCZsNBam/JLK7vHy7HuFKxySqx+48AQ1/adSMy9j0VZTrpLn69EMvw5N0OwW0WX5+p/LYkFtTNmXSQcE5dQeKVWs2w1CYnHClYL/W8vFCQ==' \
--header 'signMethod: RSA-SHA256' \
--header 'Content-Type: application/json' \
--data '{
"requestId": "S**************_20250722100437622_90",
"requestTime": "2025-07-22T10:04:37.622+08:00",
"nonceStr": "brmlnDBMQYuao2OroDYMgLOA2My5eesT",
"data": {
"reconciliationDay": "20250721",
"reportType": "ORG_RECONCILIATION",
"version": "V1.0"
}
}'
响应参数
| 字段名 | 类型 | 是否必传 | 字段名称 | 说明 |
|---|---|---|---|---|
| downloadUrl | String | 是 | 下载地址 | 下载对账文件的地址 |
| expiredTime | String | 否 | 下载地址过期时间 | 预留字段 |
响应Headers数据示例：
signature: ctGQVA1gokAKg4F8ZMjKBcDQcy5ZJKscIX8QHjENQPHwweimhFSFCzmg3NQ3tppuyDF2Rp3585gVDF0buoDzGhbxX/PHoMJfb+DR7kC+CJcHVhDuWG8TxmFrtyr9OmXq4x9eXQdNyjnheGo2zLhn20iy7J+FNxx3xTU3weM8tstTEWUMeRXb5hi2LahGcu+edyZm0hAGBGwUx+3+BVOzbT5B8sxmV4slXQLAe4o9YE6Vrk63KohlknXII1HWq5vO9/VUX1Znx/hdTXYyEfhqUHOrKwFnHLTeZGrhDAQ+9uD7t0ooY+kkmdm6kNTs4nH0o3KCyJwjVv5eQAzFW1B7aw==
orgCertId: ****************************************
signMethod: RSA-SHA256
响应Body数据示例
{
"requestId": null,
"requestTime": null,
"responseTime": "2025-07-22T10:04:45.428+00:00",
"respCode": 200,
"respMsg": "success",
"busCode": null,
"busMsg": null,
"busSubCode": null,
"busSubMsg": null,
"data": {
"downloadUrl": "https://oss-test.suixingpay.com/0/2/32MDJhYjIyYWYzOUI5QzJheDIwMjVfMDdfMjJfMTBfMDBfNjU2MjA4NWEzNzQyNGVmODgzNjAyY2IwNjZmN2RmNjMyYWZ0ZXN0MTJhYjE.csv",
"expiredTime": null
}
}
3.文件示例
3.1 交易对账文件
| 文件版本号 | 服务商对账日 | 交易记录总笔数 |
|---|---|---|
| V1.0 | 20250526 | 0 |
| 交易流水号 | 商户交易流水号 | 订单流水号 | 商户订单流水号 | 原交易流水号 | 原交易时间-UTC | 原交易经营时区时间 | 商户号 | 交易时间-UTC | 支付完成时间-UTC | 经营时区时间 | 商户清分日 | 服务商对账日 | 清分批次号 | 清分状态 | 交易金额 | 交易币种 | 清算金额 | 清算币种 | 收款方费用-扣 | 付款方费用-扣 | 收款方费用-返 | 付款方费用-返 | 产品编号 | 支付方式 | 支付类型 | 支付子类型 | 交易类型 | 付款卡类型 | 付款卡标识 | 付款卡组 | 卡号（脱敏） | 卡号ID | 资金协议类型 | 附加信息 | 终端SN | 收银员编号 |
|---|