交易对账单下载
PingPongCheckout 提供SFTP对账服务， 您可以通过 SFTP 服务器中的特定目录下载对账报告，PingPongCheckout 会将所有报告上传到 SFTP 中。通过 SFTP 服务器所下载对账报告为zip 压缩文件。
# SFTP地址
test-ppsftp.pingpongx.com:22222
1
ppsftp.pingpongx.com:22222
1
// Make sure to add code blocks to your code group
# SFTP服务申请
请将申请材料 通过邮件发送到 acq-tech-mc@pingpongx.com并抄送 acq-ts@pingpongx.com。
# 申请材料
- 商户服务器IP;
- PingPongCheckout 将会把商户服务器
IP加入IP 白名单,未加入白名单的IP不可访问 PingPongCheckout SFTP 服务
- PingPongCheckout 将会把商户服务器
- 商户RSA公钥;
- PingPongCheckout 将会把商户 RSA 公钥加入 SFTP 服务，之后商户可以凭此公钥对应的私钥访问
SFTP服务。
- PingPongCheckout 将会把商户 RSA 公钥加入 SFTP 服务，之后商户可以凭此公钥对应的私钥访问
# 商户RSA公钥获取
# 从服务器上导出RSA公钥
如果您知道服务器公钥文件所在，可以尝试导出公钥，使用cat /path/to/public_key.pub命令可以查看公钥内容，例如：
cat .ssh/id_rsa.pub
1
# 生成秘钥
如果您不清楚公钥文件所在路径，可以生成一对RSA秘钥。
ssh-keygen -t rsa
1
注意 :
1. 请确保密钥对的私钥（private_key.pem 或 id_rsa）存储在安全的位置，并且不能被他人访问。如果您担心私钥的安全性，可以设置一个密码来加密私钥文件。
2. 对账周期：按照合同约定。
# 文件路径约定
每个商户的账单文件都将归集到以约定的规则命名文件夹下，定时每天以 YYYYMMDD 命名新增文件夹。文件夹内的zip文件为商户的账单文件。
# 特定商户目录
注意
使用给定的用户名登录后会自动进入 约定的登录名目录中
在找到您的账单压缩文件前，您首先需要找到自己的目录所在
在SFTP上使用特定的文件路径标识指定商户存放账单的文件夹，规则为登录名。这部分 path 是固定的
示例：
clientId=2023052907161543393,登录名=worldready的商户存放的文件目录如下：
worldready
# 日账单目录
2023-10-25这一天的账单 path：
示例
- 商户的目录
worldready - 根据
YYYYMMDD目录命名规则，20231025
# 周账单目录
20231016-20231022 这一周的账单 path：
示例
- 商户的目录
worldready - 根据
YYYYMMDD-YYYYMMDD目录命名规则，20231016-20231022
# 月账单目录
202309 这一月的账单 path：
示例
- 商户的目录
worldready - 根据
YYYYMM目录命名规则，202309
# 账单模板
# 常见问题
sftp 下载的是一个 .zip 文件，zip 文件的命名和文件的命名是一样的嘛？一个 zip 下只有一个文件嘛？
不同的 Sheet 各自代表什么意思？
Purchase 表下是否包含失败的记录？交易类型Purchase Type、交易状态Purchase Status枚举值定义？
Refund 表下是否包含失败的记录?
上次更新: 2024/01/30, 15:44:59