> ## Documentation Index
> Fetch the complete documentation index at: https://waffo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 自助注册、Sandbox 与账户认证

> 自助注册商户实际走的路径：创建账户、验证邮箱、回答公司问题、通过六步设置向导配置 Sandbox、领取 Sandbox 凭据，然后完成七步账户认证——包括申请被退回时该怎么做。

[快速开始](/docs/zh/developer-docs/getting-started/quickstart)是从你已经持有凭据的地方讲起的。本页覆盖此前的全部内容：Portal 会向自助注册商户要求什么、按什么顺序。自助注册和 Sandbox 设置向导是按账户开通的——**只要你在 Portal 里能看到这个页面，它就对你可用**；如果某个入口没有显示，请联系 [support@waffo.com](mailto:support@waffo.com) 开通。

## 从注册到正式收款，完整流程是什么？

| 阶段 | 位置 | 产出 |
| - | - | - |
| 注册 | `/auth/sign-up` | 一个账户，邮箱尚未验证 |
| 验证邮箱 | `/auth/sign-up/verify-email` | 可用的登录 |
| 公司基本信息 | `/auth/get-started` | 第一份草稿记录；开始准备 Sandbox |
| Sandbox 设置向导 | `/sandbox-setup/step/1` … `/step/6` | 配置好的 Sandbox 和 API 凭据 |
| 账户认证 | `/verify-account` | 一份已提交的认证申请 |
| 上线 | 认证审核通过之后 | 可以接受真实支付 |

首页有一个与此列表对应的进度面板，所以你可以随时离开、随时回来继续。

## 怎么创建账户并验证邮箱？

注册需要一个邮箱地址和一个密码；强度指示器会检查大写字母、小写字母、数字和最小长度。也可以选择用 Google 登录。验证随后以两种形式之一到达，取决于账户的创建方式：**一个 6 位验证码**，输入到验证页面（支持粘贴——六个框会自动填满），或者邮件里的**一个验证链接**，点击即可。**重新发送**在倒计时结束后才会再次可用；如果验证码一直没有收到，请等倒计时结束后重新发送，而不是重新注册——再注册一次会创建一个新账户。

接下来的 **Get started** 页面只要求填**公司法定名称**和**注册国家/地区**——足以创建你的第一条记录并开始准备 Sandbox。它稍后会在账户认证中预填好再次出现。

## Sandbox 设置的六个步骤分别要填什么？

| 步骤 | 页面 | 你需要提供的内容 |
| - | - | - |
| 1 | Tell us about your business | 公司法定名称、官方网站（可选）、主营业务类型、注册国家 |
| 2 | Select your Waffo products | 一次性支付、订阅支付，或两者都选 |
| 3 | Choose pricing strategy | 全球 USD 定价，或本地币种定价 |
| 4 | Select your target markets | 按区域分组的国家/地区，另有一个 **Global** 选项；支持拖选和按区域全选 |
| 5 | Manage your payment methods | 启用/禁用每一条生成的记录，并选择其订单币种 |
| 6 | Sandbox Ready | 无——向导等待资源准备完成，然后告诉你下一步 |

步骤按进度门控：向导会把你重定向回你实际完成的最远一步，所以你无法通过深链接跳过未回答的问题。**业务类型**是一个单选分类列表（AI/SaaS、游戏、电商、流媒体、教育、旅游、金融科技、平台市场、社交与聊天应用、数字内容等）。第 1 步的**注册国家**是一个简短的卡片列表——如果你的国家不在其中，请使用该步骤上的 *Contact us* 链接，而不是选一个最接近的。

## 产品、定价策略和市场会怎样影响我能测试的内容？

它们是支付方式列表的输入，不是装饰。离开第 4 步时，Portal 会针对你所选的精确组合预览支付方式，第 5 步只渲染返回的结果。

| 字段 | 取值 |
| - | - |
| `productSolution` | `ONE_TIME_PAYMENT`、`SUBSCRIPTION`、`BOTH`（第 2 步两个产品都选会发送 `BOTH`） |
| `pricingStrategy` | `GLOBAL_USD`、`LOCAL_CURRENCY` |

选择前值得了解两个后果：**仅订阅 + 全球 USD 定价**会导致没有任何本地市场可选，只剩 Global 选项；**仅订阅 + 本地币种定价**会把第 4 步收窄到提供本地币种订阅的少数市场，其余市场标签会置灰而不是隐藏。事后更改产品选择或定价策略会**有意清空你的下游选择**——之前的列表已不再有效。

第 5 步列出国家/地区、产品、支付方式类型、支付方式、订单币种和状态，可按国家、支付方式类型和启用/禁用筛选。热门支付方式默认预先启用；每一条你保持启用的记录必须至少选择一个订单币种，否则该步骤无法继续。

## Global 市场和某个国家有什么区别？

**Global** 在市场列表里与各国并列，但它不是一个国家。它代表全球卡组织，这些卡组织不属于任何单一国家，而列表中其他每一项都是你想测试其本地支付方式的国家或地区。

两者**不是二选一**，这是第 4 步最常见的误读：

| 你的选择 | 第 5 步给你的内容 |
| - | - |
| 仅 Global | 全球卡支付方式，没有任何本地支付方式 |
| 仅国家 | 那些国家的本地支付方式，没有全球卡 |
| Global **和**国家 | 两者都有——通常的选择 |

选择 Global 不会清除你选的国家，选择国家也不会清除 Global。如果你打算在全球任何地方接受卡支付*并且*在两个市场接受本地支付方式，三项都要选。在第 5 步，全球记录会归在 **Global** 国家标签下并排在最前，方便你一眼把它们与国家记录区分开。

## 为什么我预期的支付方式在第 5 步里没有？

第 5 步不查询任何东西。列表是在你离开**第 4 步**时，由恰好三个输入——你的产品选择、你的定价策略、你的市场——生成的，第 5 步渲染返回的结果。所以请按这个顺序逐一检查输入：

| 检查项 | 为什么会踩坑 |
| - | - |
| 该支付方式所属国家在第 4 步选了吗？ | 不会提供你所选市场之外的任何内容。全球卡需要选 **Global** 项，而不是某个国家 |
| 第 5 步的筛选器清空了吗？ | 国家、支付方式类型和启用/禁用是对已有列表的**展示筛选**。一个没有清掉的筛选条件会静默地隐藏记录 |
| 你的产品选择覆盖它吗？ | 列表按产品生成。一个只面向一次性支付的支付方式不会出现在仅订阅的预览里 |
| 你的定价策略允许该币种吗？ | 全球 USD 定价下，订单币种单元格是**只读**的。你只能在预览为该记录返回的币种范围内启用它 |

如果表格完全为空，它会渲染成一个空表格而不是给出解释——请回到第 4 步扩大市场范围，而不是以为该步骤坏了。

这一步*不是*的两件事：它不是你的生产环境合约（见下文），也不是 Waffo 的完整产品目录。你的正式账户能接受什么，见[Service → Payin](/docs/zh/support/payin-agreements-and-limits-faq)，代码层面则是 `/api/v1/paymethodconfig/inquiry`——见[支付方式配置与限额](/docs/zh/support/payment-method-config-and-limits-faq)。

## 我在 Sandbox 里关掉一个支付方式，生产环境会变吗？

不会。向导和 **Settings → Sandbox Config** 只写入你的 *Sandbox* 配置。你在生产环境能接受什么取决于你的 Payin 协议，它由 Waffo 一侧设置，在 **Service → Payin** 中查看——向导从不写入它。

这个含义是双向的，上线前值得牢记：

| 情形 | 含义 |
| - | - |
| Sandbox 已启用，Service → Payin 中没有 | 生产环境未签约。为测试启用它并不等于正式开通 |
| Sandbox 已禁用，Service → Payin 中为 `Active` | 正式支付不受影响。你只是缩小了自己的测试范围 |
| 两边都有 | 今天就能端到端集成的那一个 |

一个在 Sandbox 能用、在生产环境失败的支付方式，就是第一行的可见症状；[限额、币种与配置类错误](/docs/zh/support/error-codes-and-limits-supplement)介绍了这种失败的表现，[Sandbox 环境与访问](/docs/zh/support/sandbox-environment-and-access-faq)介绍了两个环境是如何相互隔离的。

## 页面显示「Default configuration」，我不配置也能测试吗？

可以。**Settings → Sandbox Config** 会显示以下两个标记之一：

| 标记 | 含义 |
| - | - |
| `Default configuration` | 你尚未完成设置向导。已就位一组初始的产品、定价策略、市场和热门支付方式，让你可以立即开始测试 |
| `Configured` | 你自己提交的配置正在生效 |

请在该页面上读取实际的默认集合，而不是从任何文档读取——页面显示给你的就是它，而且它只是一个起点，不是承诺。**Customize** 会以当前值为初始值从第 1 步重新进入向导，这些控件都不会影响你的 API 凭据。**Reset** 和 **Clear all** 对进行中的编辑有什么影响、以及重新提交是整体替换而不是局部修补你的选择，见[Sandbox 环境与访问](/docs/zh/support/sandbox-environment-and-access-faq)。

## 提交时报错了，我该怎么做？

提交是全有或全无的，失败以一条消息返回而不是字段级错误，所以没有需要清理的中间状态。你的答案仍留在向导里：按消息指出的内容修正后再提交一次。

提交之前，有一条规则在本地强制执行——**每一个你保持启用的支付方式必须至少选择一个订单币种**，否则该步骤会拒绝继续并给出提示。这是提交根本无法发起的最常见原因。

如果最后一步报告不存在 Sandbox 配置，它会把你送回第 5 步。什么都没有丢失：提交从未落地，从那里重新提交即可。

## 我在哪里拿 Sandbox 凭据？

第 6 步每隔几秒轮询一次凭据是否就绪，在凭据存在之前显示「setting up your sandbox」状态。**这个轮询没有超时**，所以一个转了很久的页面并不是在倒计时——它仍在等待就绪，值得反馈而不是干等。就绪后，Sandbox MID、API 密钥和密钥材料位于 **Settings → Integration → API Keys**，测试卡库（只有成功和拒绝两类场景——没有 3DS 挑战测试卡）位于 **Settings → Integration → Test cards**。如果第 6 步报告不存在 Sandbox 配置，向导会把你送回第 5 步提交——提交从未落地；凭据并没有丢失。

之后，**Settings → Sandbox Config** 会以可编辑的回顾流程暴露同样的四项决定。重新提交是整体替换所选集合而不是修补某一行，配置变更不影响你的 API 凭据。

## 账户认证要求填什么？

`/verify-account` 是一个七步向导（当要求你补充额外文件时为八步）。每一步必须完成才能继续：

| 步骤 | 继续所需 |
| - | - |
| Business type | 注册国家、业务类型、法律结构 |
| Business details | 公司法定名称、注册号、官方网站、注册地址（地址、城市、国家） |
| Products & channels | 产品类别、产品描述、至少一个同时含渠道类型和 URL 的销售渠道 |
| Key people | 签字董事（姓/名、证件类型、签发国家、证件号）；另加一名主要联系人，除非勾选「same as signing director」 |
| Ownership & control | 所有权类型；个人或混合所有权时，至少一名 UBO，含完整个人信息、证件和居住地址，持股比例合计不超过 100% |
| Documents | 根据你之前的答案派生——见下文 |
| Additional Requirements | 仅在要求补充额外文件时出现；每一份要求的文件都必须上传 |
| Review & Submit | 之前所有步骤完成，加上你的最终确认 |

**Documents** 不是固定清单。它始终要求公司注册证书和签字董事的证件，然后对公司或混合所有权追加股权结构图，主要联系人为不同人时追加其证件，以及每位 UBO 的证件和地址证明。已被列为签字董事或主要联系人的人不会被要求重复提交同一证件。接受的格式为 PDF、JPG、JPEG 和 PNG，每份都在存储前加密。大小限制显示在 Documents 面板上——请在那里查看而不是看本页，因为它是按上传项分别强制的。请上传边缘清晰完整的彩色图片——每个字段都有一个带参考示例的 *Guidelines* 面板。

你每次点继续时答案都会保存为草稿，重新打开 `/verify-account` 会恢复它们，包括已上传的文件和到达的步骤。提交是不可回头的节点：申请进入审核并且**除非被退回给你，否则无法编辑**。

## 我的申请被退回（Returned）了，要改什么？

| 显示的状态 | 向导允许你做什么 |
| - | - |
| Draft | 编辑全部内容 |
| In review | 只读 |
| Returned | 只能编辑被标记的项 |
| Approved / verified | 只读 |
| Rejected | 只读 |

在退回模式下，向导对范围的界定很精确：审核人备注显示在顶部，步骤指示器标出哪些步骤包含被退回的项，各个字段和文件在原位被标记并附上该项的备注，其他一切保持锁定。一个步骤的所有项处理完后就不再被标记，所以这些标记也是你的待办清单。修正后重新提交——重新提交的申请再次视为审核中。

## Portal 上显示了一个邮箱，我的集成又有一个支持群，该用哪个？

它们分别回答入网的两个不同半边，用错是问题一直得不到回复的常见原因：

| 问题 | 去哪里 |
| - | - |
| 向导步骤、Portal 页面、缺失的入口、认证申请 | 你所在页面上显示的入网邮箱 |
| 集成行为、错误码、Sandbox 测试结果，以及**一切与验收有关的事** | 你的 Waffo 技术支持群 |

尤其是验收，只走群：填写完成的[验收模板](/docs/zh/developer-docs/tools-and-references/references/acceptance-criteria)提交到技术支持群并在那里确认——另见[快速开始](/docs/zh/developer-docs/getting-started/quickstart)，它的终点也在同一处。

***

卡在某一步，或者 Portal 里缺少某个入口？请发邮件到 [support@waffo.com](mailto:support@waffo.com) 并附上你所在的页面。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.