快速开始

Smilepayz 提供覆盖多地区的代收、代付 API。本指南介绍登录、商户后台仪表盘，以及首次调用 API 前在哪里配置沙盒与生产环境。

开始之前

• 还没有账户？ 联系您的 业务拓展（Business Development） 对接人开通商户账户，暂不支持自助注册。
• 已完成开通？ 使用开通时提供的凭据登录。

登录

1. 打开 https://merchant.smilepayz.com/#/signin。
2. 输入 Merchant Name（商户名） 或 Merchant ID（商户 ID） 及密码。
3. 点击登录进入 Dashboard（仪表盘）。

如需重置密码，请联系客服。

两步验证（2FA）

• 首次登录时可能会提示绑定 Google Authenticator。
• 也可稍后通过页面顶部的 Google 开关启用。
• 启用后，敏感操作需输入 Google Authenticator 验证码。

仪表盘概览

登录后，仪表盘会按左侧边栏所选 Currency Time Zone（货币时区） 展示实时摘要。

• Balance（余额） — 当前账户的 Available（可用）、Freeze（冻结）、To be settled（待结算），以及快捷按钮（Transactions、Methods、Balance、Statistics）。
• Statistics Today（今日统计） — 按支付方式拆分的今日交易构成。
• Payment Success Data — 今日 Payin、Payout 成功金额及趋势图。
• Operation Record（操作记录） — 近期操作（Payout、Topup、Withdraw 等），含时间、金额与状态（成功 / 处理中 / 失败）。

顶部还有 Production / Sandbox 切换、Google Authenticator 开关、通知、语言与账户菜单。

环境配置

Smilepayz 有两个相互独立的环境。请先在 Sandbox（沙盒） 开发测试，再切换到 Production（生产） 上线。两个环境各自拥有独立的凭据与设置。

沙盒

1. 将顶部开关切换为 Sandbox。
2. 在左侧打开 Configuration。
3. 在 Configuration Info 复制 Merchant ID、Merchant Name、Merchant Secret、Platform Public Key。
4. 在 API Setting 配置 IP 白名单、回调（通知）URL 及商户 RSA 公钥。

完整步骤见集成信息与 RSA 密钥生成。

生产

1. 将顶部开关切换为 Production。
2. 进入 Settings → Configuration。
3. 复制生产环境的 Merchant ID、Merchant Name、Merchant Secret、Platform Public Key。
4. 在 API Setting 配置回调 URL 与商户公钥。

生产 IP 白名单

在 生产 环境，API IP 白名单由平台维护。请将服务器 IP 提交给 客服 进行安全配置 — 这是正式调用 API 前的必要步骤。

后续步骤

• 集成流程 — 端到端集成与上线检查
• 集成信息 — 凭据与 API 设置
• 签名授权 — 如何对请求签名
• 回调通知 — 接收并校验订单更新

支持与资源

• 文档：本站 API 参考与集成指南
• 沙盒：专用于开发与集成的测试环境
• 技术支持：集成协助与问题排查
• 业务拓展：账户开通、商务条款与合作支持