清算报表

此接口获取YabandPay的清算报表

[!TIP|style:flat]

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

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

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

API URL：https://mapi.yabandpay.com/Payments

Method：POST

POST data type：Json

参数 类型 描述 是否必填
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做签名

得到的签名如下：

"d9dc3b2900c618368b8fd337b1d050c282621543a5db37f588d7f99836b19fab"

提交示例：

{
  "user": "040268",
  "sign": "d9dc3b2900c618368b8fd337b1d050c282621543a5db37f588d7f99836b19fab",
  "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 返回的数据数量

results matching ""

    No results matching ""