Skip to main content

概述

Clink 会将每日结算文件投递到一个安全的 SFTP 目录。您可以使用 SFTP 客户端 (或您自己的自动化任务)拉取这些文件,用于记账和内部对账。
文件为只读。SFTP 账户按商户单独开通,仅能访问您自己的文件。

获取 SFTP 凭证

连接仅支持 SSH 密钥认证。
  1. 在您本地生成一对 SSH 密钥,并妥善保管私钥:
  2. 进入商户后台,打开 开发者 菜单
  3. 点击 申请SFTP,并:
    • 公钥clink_sftp.pub)内容粘贴进去。公钥必须是单行;复制前可 使用 tr -d '\r\n' < clink_sftp.pub 去除换行
    • 支持 Ed25519、ECDSA 和 RSA(至少 2048 位),不支持 DSA
    • 添加 IP 白名单(必填,至少 1 个、最多 5 个网段)。每个网段支持 /24/32 的 CIDR 前缀(例如 203.0.113.7/32203.0.113.0/24
连接信息:
  • 主机sftp.clinkbill.com
  • 端口2022
  • 用户名:您的商户 ID
  • 认证方式:仅 SSH 密钥

管理 SFTP 配置

更换公钥

如需定期轮换密钥或替换已泄露的密钥,请在 开发者 菜单中打开 SFTP 配置, 点击 编辑 并更换公钥。
更换公钥会立即断开当前 SFTP 连接并中断正在进行的下载。请避开定时跑批或 下载时段操作,之后使用与新公钥匹配的私钥重新连接。

申请历史文件

定时任务只生成前一天的结算文件。首次申请 SFTP 之前的历史文件不会自动补充到 /statements,如有需要,请联系 Clink 支持团队。

建立连接

使用 OpenSSH 客户端:
也可以使用 SFTP 客户端应用程序(FileZilla、WinSCP 或 Cyberduck)连接,填入上述 主机、端口、商户 ID 和私钥。

结算文件

结算文件放在根目录下的 /statements 目录中:
每天 UTC 时间 02:00 会生成一份前一天的结算文件,命名规则为 settlement_report_YYYYMMDD.csv

下载文件