API REFERENCE

清算报表

YabandPay 文档·更新于 2026年10月26日

此接口获取YabandPay的清算报表

小贴士

1、YabandPay将在（荷兰时区）每日凌晨4点对前一天所有交易进行清算，并形成报表。建议在荷兰时间7点以后进行查询。

2、清算报表将按照每个门店以及每种支付按天生成，即如果一个门店有两种支付方式，那么每天将生成2份报表。

3、此API仅限商户超级管理员账号调用，操作员或收银员账号无权调用。

参数	类型	描述	是否必填
user	String	超级管理员账号的UID	必填
sign	String	签名	必填
method	String	v3.GetTradebill	必填
time	Long	时间戳	必填

参数

参数	类型	描述	是否必填
command	String	getTradebill	必填
bill_date	String	账单日期格式dd-MM-yyyy 仅支持三个月内的账单下载申请。	必填
nonce_string	String	随机字符串，不长于32位	必填

签名示例：

拼接为URL方式并排序后的字符串

"bill_date=2024-02-19&command=getTradebill&method=v3.GetTradebill&nonce_string=tw5be5b7sry5prm96s&time=1708422208&user=036870"

得到的 stringA 使用 secret_key做签名

得到的签名如下：

"YOUR_SIGNATURE"

提交示例：

{
  "user": "040268",
  "sign": "YOUR_SIGNATURE",
  "method": "v3.GetTradebill",
  "time": 1708422208,
  "data": {
    "command": "getTradebill",
    "bill_date": "19-02-2024",
    "nonce_string": "tw5be5b7sry5prm96s"

  }
}

返回示例：

{
	"status": true,
    "code": 200,
    "message": "",
    "data": {
        "tradebill": [
            {
                "time_zone": "GMT+1",
                "MID": 102300,
                "merchant_name": "Yaband Telecom B.V.",
                "store_name": "YabandPay",
                "sub_pay_method": "WeChat Pay",
                "settlement_currency": "EUR",
                "number_of_payment": 8,
                "amount_of_payment": "53.25",
                "number_of_refund": 0,
                "amount_of_refund": "0.00",
                "fee": "0.9",
                "net_value": "52.35",
                "vat": "0.19",
                "state": "settled",
				"transaction_date": "2024-02-19",
                "due_date": "2024-02-21",
                "settlement_date": "2024-02-21",
                "clearing_id": "M20240220001503109569"
            },
            {
                "time_zone": "GMT+1",
                "MID": 102300,
                "merchant_name": "Yaband Telecom B.V.",
                "store_name": "YabandPay",
                "sub_pay_method": "Alipay",
                "settlement_currency": "EUR",
                "number_of_payment": 9,
                "amount_of_payment": "67.85",
                "number_of_refund": 0,
                "amount_of_refund": "0.00",
                "fee": "1.23",
                "net_value": "66.62",
                "vat": "0.20",
                "state": "settled",
				"transaction_date": "2024-02-19",
                "due_date": "2024-02-21",
                "settlement_date": "2024-02-21",
                "clearing_id": "M20240220001503109614"
            }
        ],
        "count": 2
    }
}

更多信息：

返回参数说明如下：

参数	类型	描述
time_zone	String	清算时区，通常为商户注册国家所在时区
MID	String	商户的MID
merchant_name	String	商户名称
store_name	String	商户store名称
sub_pay_method	String	支付方式
settlement_currency	String	结算货币，ISO 4217
number_of_payment	String	支付交易笔数
amount_of_payment	String	支付交易金额统计
number_of_refund	String	退款交易笔数
amount_of_refund	String	退款交易金额统计
fee	String	交易手续费
net_value	String	交易净值，未扣除VAT
vat	String	全部交易手续费的VAT
state	String	结算状态：processing 或 settled
transaction_date	String	交易发生日期
due_date	String	预计结算日期
settlement_date	String	实际结算日期
clearing_id	String	清算ID
count	String	返回的数据数量