---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/en/notes/reconciliation/settlementFilePath/index.md
description: >-
  The settlement file path rules on SFTP are used to guide merchants in finding
  billing files on the SFTP server. Each merchant's billing files are stored in
  directories named after `clientId\loginName`, with new subdirectories
  generated daily, weekly, and monthly in formats of `YYYYMMDD`,
  `YYYYMMDD-YYYYMMDD`, and `YYYYMM` respectively to store compressed files for
  corresponding periods.
---
# Settlement File Path Rules on SFTP

There are multiple billing files on the SFTP server, and you need to find your billing files according to the following rules.

## SFTP Address

::: code-tabs
@tab Test Environment
```http
test-ppsftp.pingpongx.com:22222
```

@tab Production Environment
```http
ppsftp.pingpongx.com:22222
```

:::

## File Path Convention

Each merchant's billing files will be collected in folders named according to the agreed rules, with new folders added daily using the `YYYYMMDD` naming convention. The zip files within these folders are the merchant's billing files.

### Specific Merchant Directory

::: warning Note
After logging in with the given username, you will automatically enter the agreed <code>clientId\loginName</code> directory at the <code>clientId</code> level
:::

Before finding your billing compressed file, you first need to locate your own directory.
On SFTP, specific file paths are used to identify folders where designated merchants store their bills, following the rule of `clientId\loginName`. This part of the `path` is fixed.

:::  theorem Example:
For a merchant with `clientId`=`2023052907161543393` and `loginName`=`worldready`, the file directory is as follows:
`2023052907161543393/worldready`
:::

### Daily Billing Directory

The billing `path` for the day of `2023-10-25`:

::: tip  Example
1. Merchant's directory <code>2023052907161543393/worldready</code>
2. According to the <code>YYYYMMDD</code> directory naming rule, <code>`20231025`</code> is the billing directory for this day
   :::

<v4-iImage src = "/v4/sftp/daily.png" name = "Daily Billing Directory"></v4-iImage>

### Weekly Billing Directory
The billing `path` for the week of `20231016-20231022`:

::: tip  Example
1. Merchant's directory <code>2023052907161543393/worldready</code>
2. According to the <code>YYYYMMDD-YYYYMMDD</code> directory naming rule, <code>`20231016-20231022`</code> is the billing directory for this week
   :::

<v4-iImage src = "/v4/sftp/week.png" name = "Weekly Billing Directory"></v4-iImage>

### Monthly Billing Directory
The billing `path` for the month of `202309`:

::: tip  Example
1. Merchant's directory <code>2023052907161543393/worldready</code>
2. According to the <code>YYYYMM</code> directory naming rule, <code>`202309`</code> is the billing directory for this month
   :::

<v4-iImage src = "/v4/sftp/month.png" name = "Monthly Billing Directory"></v4-iImage>