# 结算周期状态
商户通过该接口查询各国家各支付类型的结算周期信息,包括结算天数、最近结算日和下次预计结算日。
# 接口信息
接口
请求API: /api/v2/recon/period-status
请求方式: GET
# 请求参数
无
# 返回参数
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 周期列表 | periods | 是 | List | 各国家各支付类型的结算周期信息 |
# periods 数据格式
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 国家 | country | 是 | String | DE | 国家二字码 |
| 支付类型 | payType | 是 | int | 1 | 1-卡类,2-钱包类 |
| 结算天数 | periodDays | 是 | int | 3 | 结算周期天数 |
| 最近结算日 | latestSettlementDate | 是 | String | 2026-06-19 | 最近一次结算日期 |
| 下次结算日 | nextSettlementDate | 是 | String | 2026-06-25 | 下次预计结算日期 |
# 返回示例数据
{
"code": 0,
"msg": "SUCCESS",
"data": {
"periods": [
{
"country": "DE",
"payType": 1,
"periodDays": 3,
"latestSettlementDate": "2026-06-19",
"nextSettlementDate": "2026-06-25"
},
{
"country": "BR",
"payType": 2,
"periodDays": 5,
"latestSettlementDate": "2026-06-17",
"nextSettlementDate": "2026-06-27"
}
]
}
}