---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/reconciliation/settlementFilePath/index.md
description: 说明 SFTP 对账文件目录规则，覆盖 clientId/登录名、日周月目录命名，以及商户登录后的可见路径差异。
---
# 对账文件在SFTP的路径规则

SFTP服务器存在多个账单文件，您需要根据下列的规则找到您的账单文件。

## SFTP地址

::: code-tabs
@tab 测试环境
```http
test-ppsftp.pingpongx.com:22222
```

@tab 生产环境
```http
ppsftp.pingpongx.com:22222
```

:::

## 文件路径约定

每个商户的账单文件都将归集到以约定的规则命名文件夹下，定时每天以 `YYYYMMDD` 命名新增文件夹。文件夹内的zip文件为商户的账单文件。

### 特定商户目录

::: warning 提示
使用给定的用户名登录后会自动进入 约定的<code>clientId\登录名</code>目录中<code>clientId</code>这一层
:::

在找到您的账单压缩文件前，您首先需要找到自己的目录所在
在SFTP上使用特定的文件路径标识指定商户存放账单的文件夹，规则为`clientId\登录名`。这部分 `path` 是固定的

:::  theorem 示例：
`clientId`=`2023052907161543393`,`登录名`=`worldready`的商户存放的文件目录如下：
`2023052907161543393/worldready`
:::

::: danger 注意
上述路径为管理员权限视角下的完整目录路径，用于说明账单文件的归属规则。商户使用已开通的 SFTP 账号登录后，通常只能看到自己的登录名目录（如 `worldready`）及其下级账单目录，可能不会展示前置的 `clientId` 目录。请以登录后实际可见目录为准，继续按照日、周、月目录规则查找账单文件。
:::

### 日账单目录

`2023-10-25`这一天的账单 `path`：

::: tip  示例
1. 商户的目录 <code>2023052907161543393/worldready</code>
2. 根据 <code>YYYYMMDD</code>目录命名规则，<code>`20231025`</code>是这一天账单目录
   :::

<v4-iImage src = "/v4/sftp/daily.png" name = "日账单目录"></v4-iImage><br/>

### 周账单目录
`20231016-20231022` 这一周的账单 `path`：

::: tip  示例
1. 商户的目录 <code>2023052907161543393/worldready</code>
2. 根据 <code>YYYYMMDD-YYYYMMDD</code>目录命名规则，<code>`20231016-20231022`</code>是这一周账单目录
   :::

<v4-iImage src = "/v4/sftp/week.png" name = "周账单目录"></v4-iImage><br/>

### 月账单目录
`202309` 这一月的账单 `path`：

::: tip  示例
1. 商户的目录 <code>2023052907161543393/worldready</code>
2. 根据 <code>YYYYMM</code>目录命名规则，<code>`202309`</code>是这一月账单目录
   :::

<v4-iImage src = "/v4/sftp/month.png" name = "月账单目录"></v4-iImage><br/>