# Waffo Documentation: Chinese 产品指南

## 产品指南

### 产品与服务

- [Waffo 产品概览](https://waffo.com/docs/zh/essentials/product-overview.md): 构建全球支付基础设施。从收单到增长的一站式全栈解决方案。

### 收单与支付

- [收银台](https://waffo.com/docs/zh/essentials/checkout.md): Waffo 的标准化收银台产品，用于管理覆盖一次性支付与订阅支付模式的全球支付交互流程。
- [一次性支付](https://waffo.com/docs/zh/essentials/one-time-payment.md): 一次接入，覆盖全球主流支付方式，每笔交易清晰可控。
- [订阅与定期扣款](https://waffo.com/docs/zh/essentials/subscription-recurring.md): 为周期性支付场景提供自动化、高成功率的账单解决方案。通过一次授权、多次自动扣款的机制，我们支持灵活的计费周期配置与智能重试。
- [支付方式](https://waffo.com/docs/zh/essentials/payment-methods.md): 通过单一、统一的 API 接口，将您的业务连接到主流全球及特色本地支付方式。

### 结算与资金

- [商户结算](https://waffo.com/docs/zh/essentials/merchant-settlement.md): 智能透明的全球资金结算服务，自动汇兑多币种交易，以灵活结算策略精准优化商户现金流。
- [商户门户](https://waffo.com/docs/zh/essentials/merchant-portal.md): 面向跨境企业的一站式支付管理平台。在一个平台集中管理交易、结算、数据分析与团队访问权限。

### 全球税务 / MoR

- [税务](https://waffo.com/docs/zh/essentials/tax.md): Waffo Global Tax 是一款专为跨境数字业务打造的智能税务解决方案。无论您的客户位于美国、欧盟/英国，还是亚太地区，我们都会自动识别并处理本地税务合规。

### 增值服务

- [争议与拒付](https://waffo.com/docs/zh/essentials/dispute-chargeback.md): 覆盖三个核心阶段的系统化、分层闭环防御体系：拒付预警、客户争议与拒付。
- [全链路数据智能](https://waffo.com/docs/zh/essentials/data-intelligence.md): 端到端的数据智能，将晦涩的银行代码转化为可执行的增长策略。

### 高级功能

- [支付凭证化](https://waffo.com/docs/zh/essentials/tokenization.md): 使用 Waffo Tokens 安全存储支付凭证，在无需处理原始卡号的情况下，实现一键结账、周期性扣款与延后扣款。
- [授权-扣款](https://waffo.com/docs/zh/essentials/auth-capture.md): 将支付拆分为两个步骤——先预授权资金，仅在交易确认后再扣款，从而降低欺诈风险与退款成本。

### 点卡充值

- [点卡充值](https://waffo.com/docs/zh/essentials/point-topup.md): Waffo Point Topup 是点卡充值 API 与白标点卡充值方案。供应商通过 API 或一条 URL 跳转接入点卡库存或充值能力，无需自建店面和支付。

### 常见问题 FAQ

- [API 凭证范围与认证错误排查](https://waffo.com/docs/zh/support/api-credential-scope-and-triage-faq.md): 哪个 API key 允许调用哪个接口、为什么 Withdraw 必须是独立凭证、Waffo 检查您的 API key、范围、签名和 IP 的确切顺序、如何解读 A0001 / A0002 / A0004 / A0046，以及凭证变更多久生效。
- [API 参考速查表](https://waffo.com/docs/zh/support/api-reference-tables.md): 其他 Waffo API 页面所指向的四张查询表：按国家和 Payout 方式划分的 Payout 收款人字段要求、创建订单时的条件必填字段、供自建收银台商户使用的完整 orderAction.actionData 字段列表，以及各 API 族（Payout、收单、订阅、提现）的错误码表。
- [鉴权与签名 FAQ](https://waffo.com/docs/zh/support/auth-signature-faq.md): 解答 Waffo API 鉴权中最常见的问题：API key 从哪里获取、请求与响应签名如何工作、Webhook 验签、A0001/A0002 排查以及 RSA 密钥生成。
- [Waffo 能自动帮我提现余额吗？提现怎么对接？](https://waffo.com/docs/zh/support/auto-withdrawal-and-withdrawal-integration-faq.md): 自动提现合约的完整说明——如何触发、六种状态各自的含义、余额低于阈值时会发生什么、如何暂停或终止——以及提现Webhook 通知事件、如何区分 API 提现和 Portal 提现、导出提现列表，还有提现上的 openingRegion 和 fundsFrom 是什么意思。
- [余额与账户历史](https://waffo.com/docs/zh/support/balance-and-account-history-faq.md): 如何理解 Waffo 的三种余额——待结算、结算账户和保证金——为什么可提现金额可能低于结算账户余额，账户历史记录了哪些内容，以及对账单和发票 PDF 的命名规则。
- [银行转账与虚拟账户](https://waffo.com/docs/zh/support/bank-transfer-and-virtual-account-faq.md): 虚拟账户（VA）与银行转账支付的行为说明：VA 账号有效期多长、之后能否被复用，用户输错金额会发生什么，以及法币多付或少付会对订单状态产生什么影响。
- [批量 Payout 的状态与资金来源](https://waffo.com/docs/zh/support/batch-payout-faq.md): 如何读懂批量 Payout 的状态及其逐行状态、为什么批次会从列表中消失而不是显示为失败、为什么只向您提供部分国家的模板，以及 Payout 的资金允许从哪里来。
- [批量退款](https://waffo.com/docs/zh/support/batch-refund-faq.md): Portal 的批量退款 Tab：模板列与限制、上传校验检查什么及检查顺序、重复文件与同一时间只能有一个批次的规则、批次状态，以及逐行失败原因在哪里查看。
- [客制化收银台页面（品牌、颜色、Logo）](https://waffo.com/docs/zh/support/cashier-customization-faq.md): 如何为 Waffo 收银台页面做品牌定制：Customization 在 Portal 的哪里、可以设置的每个颜色和尺寸、创建订单时哪个字段控制字号、订单参数如何覆盖 Portal 设置、MID 与 SubMID 配置、多个 Logo 和 Logo ID、实时预览及其限制，以及团队中谁可以保存更改。
- [收银台支付方式展示规则](https://waffo.com/docs/zh/support/cashier-display-rules-faq.md): Waffo 收银台如何决定展示哪些支付方式以及展示顺序：商户自定义排序、新签约的支付方式、折叠、不可用的支付方式、国家分组以及展示模式选项。
- [收银台表单、预填与错误处理](https://waffo.com/docs/zh/support/cashier-forms-and-flow-faq.md): 客户在 Waffo 收银台上实际需要填写什么：您传入的信息是否会被预填、何时会跳过支付方式选择页、卡表单的校验规则与长度、已保存卡片的表现、二维码有效期，以及哪些收银台错误会重试、哪些会直接跳转到失败页。
- [收银台语言](https://waffo.com/docs/zh/support/cashier-language-faq.md): 哪个字段决定 Waffo 收银台的语言、准确的 BCP 47 格式与校验错误、收银台选择展示语言时使用的完整优先级顺序，以及收银台可渲染的全部语言列表。
- [收银台页面生命周期与收据](https://waffo.com/docs/zh/support/cashier-order-lifecycle-faq.md): Waffo 收银台页面在订单生命周期各阶段的行为：支付后重新打开链接、处理中状态、结果页跳转、商户展示名称、logo、跨币种金额以及回头客的信息预填。
- [收银台重定向与 Action Type](https://waffo.com/docs/zh/support/cashier-redirect-and-action-type-faq.md): orderAction.actionType 是如何决定的、为什么 webUrl 和 deeplinkUrl 互斥、actionType 与 userInfo.userTerminal 的关系、顾客何时可以在收银台切换国家、订阅收银台能否通过请求参数收窄范围，以及一个支付方式配置了多个币种时以哪个为准。
- [拒付证据指南](https://waffo.com/docs/zh/support/chargeback-evidence-guide.md): 如何选择申诉证据：每次抗辩都必须回答的三个问题、每种争议原因取决于哪个问题、实物商品/数字商品/服务的材料有何不同、原因不明时该发什么、为什么你没有任何操作也会出现第二周期，以及为什么客户争议会自行关闭。
- [拒付与争议 FAQ](https://waffo.com/docs/zh/support/chargeback-faq.md): 商户关于拒付最常见问题的解答：通知如何送达、拒付发生时该做什么、如何提交抗辩证据、期限与状态流转，以及为什么争议中的订单不能退款。
- [拒付字段参考](https://waffo.com/docs/zh/support/chargeback-field-reference.md): 用于在商户 Portal 和结算对账单中读懂拒付的字段词典：四种 CHARGEBACK Event Type 及其正负方向、Compulsory Channel Review 标志、客户争议与拒付时间线的每个事件、哪些事件会增加未读计数、拒付 CSV 导出的 26 列、Dispute Amount 如何得出、拒付手续费币种，以及每日争议报告中的 Alert Status 取值。
- [拒付原因码与 Reported Fraud](https://waffo.com/docs/zh/support/chargeback-reason-codes-and-reported-fraud.md): Waffo 识别的全部 Visa 与 Mastercard 争议原因码，按类别分组并说明每个码的主张内容；以及什么是 Reported Fraud、它与拒付有何不同、如何查询。
- [在我自己的 App 里加载收银台（WebView、App 唤起、返回）](https://waffo.com/docs/zh/support/checkout-in-app-webview-faq.md): WebView 集成指南没有回答的 App 侧问题：Waffo 是否会检测 WebView 并提示客户、要放行哪些域名、客户不再返回时您的 App 如何得知支付结果、钱包 App 往返后收银台是否会自行刷新、支付跳转链接能否打开两次、钱包打不开时要采集什么、为什么 App 唤起无法在 sandbox 测试，以及能否只在 App 环境隐藏某种支付方式。
- [按支付方式划分的条件必填字段](https://waffo.com/docs/zh/support/conditional-required-fields-faq.md): 为什么 /api/v1/order/create 上标记为可选的字段——goodsId、goodsUniquePrice、skuName、userFirstName、userPhone、地址等——仍可能因缺失而被拒绝，缺失字段列表中可能出现哪些字段路径，以及为什么正确做法是先提交再读取返回的列表而不是预判。
- [优惠券与促销码](https://waffo.com/docs/zh/support/coupons-and-promotion-codes-faq.md): Waffo 折扣引擎全流程：按百分比与按固定金额的优惠券、Once / Repeating / Forever 持续周期、单个与批量促销码、核销记录、折扣分析、账户级上限、订阅试用、退款回滚，以及两个 API 入口。
- [使用某个币种之前必须先开通吗？](https://waffo.com/docs/zh/support/currency-and-method-enablement-faq.md): 币种和支付方式如何在 Waffo 账户上变为可用：订单币种与用户币种的区别、在哪里查看你已开通的内容、未开通的币种实际返回哪个错误码、开通是按商户 ID 还是按整个账户、同一支付方式能否在一个市场用本地币种定价而在另一个市场用 USD 定价，以及新增支付方式是否影响已在运行的支付方式。
- [限额、币种与配置类错误](https://waffo.com/docs/zh/support/error-codes-and-limits-supplement.md): 其他页面未覆盖的下单拒绝原因：A0008 / A0020 / A0021 三种金额限额的区别，为什么未签约币种返回 A0018 而不是 A0007，A0026 / A0047 收银台语言，A0024 汇率过期（不是 A0023），A0014 跨币种退款换算后归零，A0022 支付方式指向多个产品——以及为什么限额不随汇率变动、为什么 Portal 里可能没有结算菜单、Sandbox 与生产环境的可用性差异，和周期扣款的相关规则。
- [常见错误排查](https://waffo.com/docs/zh/support/errors-troubleshooting-guide.md): 如何诊断和修复商户最常遇到的 API 错误——无效 API key（A0001）、签名失败（A0002）、参数校验（A0003）、支付方式/合约不匹配（A0018）、未知状态错误（Exxxxx），以及不断重试的 webhook 通知。
- [支付与结算中的汇率](https://waffo.com/docs/zh/support/exchange-rates-faq.md): 跨币种订单使用哪一个汇率、何时报价与重新报价、为什么本地金额在 UTC+8 中午会变化、已应用的汇率在 API 和 Portal 中显示在哪里，以及结算和退款各自如何选取汇率。
- [导出与报表下载](https://waffo.com/docs/zh/support/export-center-faq.md): Portal 列表导出是后台任务而不是即时下载：完成的文件出现在哪里、四种任务状态各是什么意思、为什么 Failed Count 不代表缺少数据行、下载链接何时过期，以及在导出开始前就会拦住它的日期跨度和行数限制。
- [失败卡交易的计费](https://waffo.com/docs/zh/support/failed-transaction-billing-faq.md): 为什么一笔从未成功的卡支付仍会出现在你的结算账单上：哪些失败阶段可计费、Event Type 列如何工作、为什么失败行没有订单金额，以及如何在 Merchant Portal 中找到并导出这些交易。
- [手续费与税费处理](https://waffo.com/docs/zh/support/fee-and-tax-treatment-faq.md): Waffo 如何决定一笔卡交易适用哪套手续费条款、三种税费承担模式的含义及各自由谁承担、争议和拒付对你资金的影响有何不同，以及拒付导出和结算预估导出的限制。
- [自助注册、Sandbox 与账户认证](https://waffo.com/docs/zh/support/getting-started-self-serve-faq.md): 自助注册商户实际走的路径：创建账户、验证邮箱、回答公司问题、通过六步设置向导配置 Sandbox、领取 Sandbox 凭据，然后完成七步账户认证——包括申请被退回时该怎么做。
- [账户认证：表单、状态与你能改什么](https://waffo.com/docs/zh/support/kyb-application-lifecycle-faq.md): 账户认证申请的行为说明：自助表单接受哪些国家和实体类型、哪些字段必填、草稿是否保存和共享、谁可以提交、每个申请状态的含义、何时可以编辑，以及审核通过后会发生什么。
- [KYB 文件要求：一次通过审核](https://waffo.com/docs/zh/support/kyb-document-requirements-faq.md): 每份账户验证文件要长什么样才会被接受：您所在国家适用哪种注册证书、股权结构图如何评判、护照和地址证明规则、退回项可能是什么、补充材料要求如何运作，以及为什么 Guidelines 下载链接会失效。
- [自建收银台页面而不使用 Waffo 的收银台](https://waffo.com/docs/zh/support/merchant-built-checkout-faq.md): 商户自建收银台能从 Waffo 拿到什么、拿不到什么：orderAction.actionData 何时有值何时为空、哪些支付凭据以原始数据返回、由谁校验必填的顾客字段、如何自行查询支付方式可用性和金额范围、托管与自建流程能否按订单混用，以及只有 Waffo 托管收银台才会执行的那些流程环节。
- [小程序支付](https://waffo.com/docs/zh/support/mini-program-payments-faq.md): 如何在钱包小程序内收款：必须集成哪些前端 JS API 和哪些 Waffo 接口、创建订单时发送什么、退款如何工作、如何用 userid/inquiry 识别用户，以及为什么除非额外 scope 获批你只能拿到用户的公开 ID。
- [在一个账户下运营多个品牌](https://waffo.com/docs/zh/support/multi-brand-and-sub-merchant-faq.md): 如何使用 SubMID 在一个 Waffo 账户下运营多个品牌或业务线：每个品牌各自的收银台名称和 logo、哪一级配置优先、在你配置任何内容之前会发生什么、哪些内容会被固定、某些支付会额外收集的信息，以及报表中的 USD 金额是如何换算的。
- [我该核对哪个金额和币种字段？](https://waffo.com/docs/zh/support/order-amount-and-currency-fields-faq.md): 一笔订单带有多个金额——orderAmount、originalAmount、finalDealAmount、用户实际支付的金额，以及一笔用户手续费——最多涉及三种币种。本页说明核对订单时应比较哪个字段、应按哪个字段发货、为什么 finalDealAmount 与 orderAmount 不同是正常的，以及应该用哪个币种创建订单。
- [订单金额、限额与拒绝](https://waffo.com/docs/zh/support/order-amount-precision-and-decline-faq.md): 为什么看起来有效的金额会被拒绝、同币种与跨币种订单的校验方式有何不同、processingAmountLimits 的 min/max/multiple 是什么意思、哪个限额产生了哪个错误码、支付方式类型如何决定你的客户能否付款、如何解读卡拒绝，以及未支付订单会保持开放多久。
- [创建订单字段指南](https://waffo.com/docs/zh/support/order-create-field-guide.md): 完整的 /api/v1/order/create 请求字段表及每个长度限制、哪些字段必填、值过长时会怎样、重发时 paymentRequestId 幂等检查的实际行为，以及常见校验错误背后的字段规则。
- [我的订单被拒了——是我的问题、我的配置问题，还是支付方式的问题？](https://waffo.com/docs/zh/support/order-rejection-self-diagnosis-faq.md): 针对商户最常提出的拒绝情形的决策树：A0018 支付方式/合同不匹配及产生它的每个维度、密钥轮换后的 A0001、C0005 渠道拒绝及随之返回的失败原因、退款时的 A0017，以及如何区分尚未开通的支付方式与错误的参数。
- [订单在每个状态下我能做什么？](https://waffo.com/docs/zh/support/order-status-actions-and-capture-faq.md): 订单状态列表（包括大多数商户从未见过的两个状态）、哪些状态接受取消、请款和退款、为什么订单会停在 AUTHORIZATION_REQUIRED、关闭原因写在哪里、支付方式已经收了钱时取消会怎样，以及对已授权卡支付请款的规则。
- [Payin 协议与交易限额](https://waffo.com/docs/zh/support/payin-agreements-and-limits-faq.md): 如何读懂 Service → Payin：Payin 协议列表的每一列、手续费与结算周期的记法、协议状态、金额限额——以及两个超限错误的含义、每日限额如何计数与释放、客户在收银台看到的是哪个名称。
- [Payment Enrollment：为什么审核通过了还不能收真实付款](https://waffo.com/docs/zh/support/payment-enrollment-faq.md): 认证审核已通过，但仍然收不了真实付款？本页解释 KYB 审核通过后的 Payment Enrollment（支付方式开通）阶段：Activating Payment Capabilities 面板在哪里、IN_PROGRESS 和 COMPLETED 分别是什么意思、为什么某个支付方式一直停在 Processing，以及单个支付方式显示 Suspended 或 Rejected 意味着什么。
- [支付链接（无代码收款）](https://waffo.com/docs/zh/support/payment-link-faq.md): 无需任何集成，直接在商户 Portal 收款：什么是支付链接、创建时要填哪些字段、过期如何工作、为什么一个链接对应恰好一笔订单、在哪里跟踪结果，以及何时应该改用 Checkout。
- [读懂您的支付方式配置](https://waffo.com/docs/zh/support/payment-method-config-and-limits-faq.md): 如何以编程方式发现您的账户可以使用哪些支付方式：支付方式配置响应上的每个字段、为什么 currentStatus 可能返回为空、四个 refundAllowed 编码的含义、点名您商户 ID 或 notifyUrl 的参数错误，以及发生变化的导出列和列表筛选。
- [我可以接受哪些支付方式和市场？](https://waffo.com/docs/zh/support/payment-method-coverage-faq.md): 如何通过已发布的支付方式目录自行回答覆盖范围问题：列出了哪些市场、表格如何聚合行、为什么一个支付方式会以两个名字出现、如何判断一个方式是否支持订阅或退款，以及你自己签约的列表与目录有何不同。
- [按支付方式的退款限制](https://waffo.com/docs/zh/support/payment-method-refund-limits-faq.md): 为什么同一个退款请求在一种支付方式上成功、在另一种上被拒绝：部分退款的可用性、退款窗口和截止时间、一个订单允许多少次退款、重复请求保护、请款前后的退款、已关闭的用户账户，以及被发卡行拒绝的卡退款。
- [确认支付结果](https://waffo.com/docs/zh/support/payment-results-faq.md): 如何可靠地判断一笔支付是否成功：跳转、webUrl、Webhook 通知和 Order Inquiry 各自的角色，每个 orderStatus 的含义，以及收不到通知时该怎么做。
- [超时与结果何时算最终](https://waffo.com/docs/zh/support/payment-timeout-and-finality-faq.md): 为什么订单超时不能证明支付失败：Waffo 在关单时间做了什么、超时由谁的时钟决定、哪些失败会以通知形式到达你、哪些只有查询才能看到、迟到的通知与重试、迟到成功后的自动退回、独立的 3DS 认证超时，以及你的前端应该等多久。
- [Payout 错误码与重试](https://waffo.com/docs/zh/support/payout-error-codes-and-retry-faq.md): Payout 的错误码集合与支付的不同：每个 A/B/C/D/E 码对 Payout 意味着什么、哪四个码可以安全重试、哪些码意味着要修改请求、为什么 A0003 携带字段名，以及 B 前缀的码实际指的是什么。
- [Payout FAQ](https://waffo.com/docs/zh/support/payout-faq.md): 解答关于 Waffo Payout 最常见的问题：创建并跟踪一笔 Payout、通知、各国收款人字段要求、幂等性以及错误码。
- [Payout 请求字段指南](https://waffo.com/docs/zh/support/payout-request-field-guide.md): 构建 Payout 创建请求的逐字段解答：payoutRequestId 幂等到底如何比较请求、哪些收款人字段按国家条件必填、两种不同的日期格式、电话和 PIX key 格式、各通道的银行属性、purpose 取值、金额精度，以及 API 会拒绝哪些字段。
- [Payout 状态、通知与报表](https://waffo.com/docs/zh/support/payout-status-notifications-and-reports-faq.md): 每个 Payout 状态和子状态的含义、为什么 DEDUCTED 永远不会到达你、Payout Webhook 何时触发以及完全不触发的两种情况、如何发现冲正，以及每日、每周和每月 Payout 报表包含什么、何时出现。
- [Payout 钱包与覆盖范围](https://waffo.com/docs/zh/support/payout-wallet-and-coverage-faq.md): Waffo 的第四个账户：Payout 钱包里放的是什么、资金如何进出、失败和被冲正的 Payout 如何回到你的结算账户、如何读它独立的账户历史，以及在哪里查看你签约了哪些 Payout 通道。
- [Point Topup 分销商 API](https://waffo.com/docs/zh/support/point-topup-reseller-api-faq.md): Point Topup 分销商可以调用的六个签名接口：商品目录查询、采购余额查询、带 resellerRequestId 幂等键的订单创建、单笔与分页订单查询、履约查询，以及四个订单状态和采购通知。
- [Portal 登录、链接与账户状态](https://waffo.com/docs/zh/support/portal-account-access-faq.md): 为什么商户 Portal 会把你登出、每种邮件链接的有效期多长、为什么重发会被拒绝、密码过期与复用规则是什么、Continue with Google 做了什么，以及哪些账户状态能登录、哪些不能。
- [Portal 看板与数据分析](https://waffo.com/docs/zh/support/portal-analytics-faq.md): 如何读懂商户 Portal 的各看板：首页数据的更新时效与结算日历、Payments Analytics 指标定义、Chargeback Analytics 的比率与统计周期，以及交易、退款和结算导出背后的规则。
- [缺失的列、筛选项与视图](https://waffo.com/docs/zh/support/portal-conditional-screens-faq.md): 为什么你在文档里读到的 Portal 列、筛选项、Tab 或编辑按钮不在你的屏幕上：哪些元素由合同决定、哪些只在有数据时出现、你会看到哪种分析视图及原因、为什么某个时间间隔是灰色的，以及为什么通知 URL 被拒绝。
- [首页看板](https://waffo.com/docs/zh/support/portal-dashboard-faq.md): Portal 首页看板如何统计：Today 面板的三个 TPV 基线、TPV / Txns / ASP 的定义、产品拆分、五种时间粒度、Compare 对比，以及切换展示币种会换算什么、不会换算什么。
- [Portal 列表筛选与日期范围](https://waffo.com/docs/zh/support/portal-list-filters-and-date-ranges-faq.md): 商户 Portal 每个列表可以筛选和搜索什么、每个列表默认回看多久、哪些日期选择器拒绝超过一个月的范围、如何覆盖整年，以及为什么列表上的某个按钮或文件名点不了。
- [商户 Portal 操作](https://waffo.com/docs/zh/support/portal-operations-faq.md): Waffo 商户 Portal 的账户与团队管理：为什么不同商户看到的菜单不一样、各角色能做什么、如何邀请和移除用户、登录安全与两步验证、界面语言，以及在哪里找到集成密钥。
- [收据：查看、发送与配置](https://waffo.com/docs/zh/support/portal-receipt-faq.md): 如何在商户 Portal 中查看支付收据、通过邮件发送给客户、解读投递状态，以及理解什么控制着收据内容。
- [Portal 自助安全配置](https://waffo.com/docs/zh/support/portal-security-config-faq.md): 如何在商户 Portal 中管理 API 安全设置：通过挑战字符串验证提交与轮换公钥、配置退款和拒付通知 URL，以及用 IP 白名单限制 API 访问。
- [商户切换器、Demo 模式与环境](https://waffo.com/docs/zh/support/portal-switcher-and-environments-faq.md): Portal 顶部的商户 ID 下拉框及旁边的别名、它与子商户筛选的区别、Demo Mode 标记是什么意思以及如何退出、沙箱和生产是否是同一个账户，以及管理员离职时该怎么办。
- [Webhook 事件日志与手动重发](https://waffo.com/docs/zh/support/portal-webhook-log-faq.md): 如何在 Merchant Portal 中检查 Webhook 投递：什么算投递成功、为什么记录可能完全缺失、每种事件显示哪个 Order ID，以及手动重发与自动重试如何相互影响。
- [生产环境公钥与 API 操作类型](https://waffo.com/docs/zh/support/production-api-key-and-public-key-faq.md): 自助提交和轮换你的生产环境公钥：字段接受的精确格式、为什么 Portal 要你对挑战字符串签名、三种 API 操作类型的含义以及为什么 Withdraw 必须独立，还有轮换期间新旧密钥如何共存。
- [上线收款之前需要完成哪些事？](https://waffo.com/docs/zh/support/production-go-live-faq.md): 把通往生产环境的完整路径放在一页：哪些阶段是上线收款的前置门槛、从 sandbox 切到生产时到底有哪些变化、集成验收要求什么以及什么时候可以用简化模板、你这边需要做哪些技术准备，以及已经上线后如何新增国家或支付方式。
- [收据配置与下载](https://waffo.com/docs/zh/support/receipt-configuration-and-download-faq.md): 面向客户的收据端到端如何工作：客户下载时选择什么（语言、用于报销的公司名称，以及为什么只能设置一次）、你可以在 Portal 中配置什么、配置变更是否影响过去的交易、收据 URL，以及你的配置无法触及的交易。
- [退款 FAQ](https://waffo.com/docs/zh/support/refund-faq.md): 解答关于 Waffo 退款最常见的问题：多次部分退款、退款前置条件、幂等重试、跨币种金额与取整、退款与取消的区别、处理时长以及支付方式限制。
- [退款的钱从哪里来](https://waffo.com/docs/zh/support/refund-funding-source-faq.md): 退款实际从你的哪个 Waffo 余额中扣、按什么顺序、为什么结算刚打款后退款会因余额不足失败、退款备用金账户如何避免这种情况，以及为什么这一切都不改变退款 API。
- [退款记录、ID、通知与时效](https://waffo.com/docs/zh/support/refund-records-and-notifications-faq.md): 退款携带的每个标识以及该向谁报哪一个、为什么有些退款要求你提供客户的银行账户和姓名、这些信息填错了怎么办、退款 Webhook 何时触发以及发到哪里、退款通常多久到达客户，以及客户能否自己发起退款。
- [报表交付与邮件订阅](https://waffo.com/docs/zh/support/report-delivery-and-subscription-faq.md): Waffo 报表文件送达你的四种方式——Portal 下载、Waffo SFTP、你自己的 SFTP 或邮件——以及如何自助管理结算报表邮件订阅：计划、收件人、正文语言、发送历史，还有交付方式变更何时生效。
- [保证金账户](https://waffo.com/docs/zh/support/reserve-faq.md): 固定保证金与滚动保证金有何区别、冻结资金从哪个账户扣、冻结期怎么计算、结算周期为负时会怎样、冻结何时释放，以及在商户 Portal 哪里核对每一笔保证金变动。
- [风控拒绝与 3D Secure](https://waffo.com/docs/zh/support/risk-declines-and-3ds-faq.md): 风控拒绝会返回什么、如何将它与支付方式拒绝区分开、你能否强制或跳过 3D Secure 以及你的指令何时会被忽略、挑战如何到达购物者，以及你在 Portal 中能看到哪些关于拒绝、拒付率和欺诈率的信息。
- [Sandbox 环境与访问 FAQ](https://waffo.com/docs/zh/support/sandbox-environment-and-access-faq.md): Waffo sandbox 是如何开通的、哪些 URL 和商户 ID 属于它、sandbox 设置向导如何工作以及每个选项会改变什么、sandbox 密钥从哪里来，以及 sandbox 与生产环境究竟是如何隔离的。
- [沙箱模拟范围 FAQ](https://waffo.com/docs/zh/support/sandbox-simulation-limits-faq.md): Waffo 沙箱到底能复现什么、不能复现什么：哪些保留金额触发哪个错误、为什么退款保留金额不起作用、如何模拟钱包侧取消、为什么模拟的失败续订从不重试，以及哪些场景在沙箱中完全没有路径。
- [沙箱测试 FAQ](https://waffo.com/docs/zh/support/sandbox-testing-faq.md): 如何获取沙箱凭据、模拟支付成功与失败、使用测试卡号、在本地接收 Webhook，以及理解沙箱与生产环境的差别。
- [商户 Portal 里哪些设置我可以自己改？](https://waffo.com/docs/zh/support/self-service-boundaries-faq.md): 针对商户在入网和上线阶段问到的每一项设置——支付方式、币种、银行账户、IP 白名单、域名、密钥、订单超时、收银台布局——说明商户 Portal 是否允许你自己修改，还是由 Waffo 一侧配置，以及哪些内容你可以自己查看而不必询问。
- [结算账户结构与账户历史筛选](https://waffo.com/docs/zh/support/settlement-account-structure-faq.md): 为什么一个结算币种会显示两个账号、为什么一笔提现会分成两笔付款到账，accountSubType 和透支额度字段是什么意思，以及账户历史正确的筛选值——覆盖结算账户和保证金账户的六种业务类型，包括保证金扣留、释放和调整。
- [结算批次与日历](https://waffo.com/docs/zh/support/settlement-batch-and-calendar-faq.md): 交易如何被分组为结算条目和批次、标识符是什么意思、结算记录的状态时间线显示什么、Balance History 记录什么以及如何筛选和导出，还有如何解读结算日历的国家维度和假期详情。
- [结算计算详解](https://waffo.com/docs/zh/support/settlement-calculation-explained.md): 逐行复现 Waffo 的结算数字：四个清算步骤、2 位与 6 位小数精度设置、每种币种组合使用哪个货币对和取整规则、最小和最大手续费上限如何应用、什么是 Return Fee，以及为什么负数结算周期不付款。
- [结算周期与日历](https://waffo.com/docs/zh/support/settlement-cycle-faq.md): 结算日期背后的运营规则：UTC+8 的日切、按支付方式划分的结算协议、日 / 周 / 半月 / 月周期类型及各自 T+N 的计算方式、按合并节假日日历的工作日顺延、结算批次、净额为负的周期，以及不顺延的退款备用金结算。
- [我到底能拿到哪些结算数据，从哪里拿？](https://waffo.com/docs/zh/support/settlement-data-availability-faq.md): 回答「能不能加这个字段 / 有没有这个的 API」这一类对账问题：交易导出、结算报表和资金流动 API 中存在哪些标识和维度、哪些根本不存在、为什么同一个月的三份导出对不上，以及哪份文件是发给谁的。
- [结算文件规范](https://waffo.com/docs/zh/support/settlement-file-specification-faq.md): 三份对账报表文件以及结算账单和发票 PDF 的逐列参考：每个字段的含义、小数精度、何时为空、文件命名规则、文件投递位置，以及如何按日期范围批量下载。
- [结算报表模块](https://waffo.com/docs/zh/support/settlement-reports-export-faq.md): 商户 Portal 中结算报表模块的工作方式：选择支付日期还是结算日期维度、导出类型及各自的日期跨度限制、适用哪个币种选择器、汇总表中 Order Amount 和 Fee Amount 如何定义、导出何时会拆成 zip，以及如何解读导出任务列表。
- [结算报告与导出](https://waffo.com/docs/zh/support/settlement-reports-faq.md): Waffo 如何计算结算报告中的每一个金额、每一列适用哪条取整规则、如何使用 Settlement History、Settlement Batch 和 Customized Export，以及为什么结算文件可能缺失或为空。
- [稳定币异常与退款](https://waffo.com/docs/zh/support/stablecoin-exceptions-faq.md): 购物者多付、少付、迟付，或在错误的链上、用错误的代币支付时会发生什么——这些情况您在哪里能看、哪里看不到，USDC/USDT 退款必须使用的确切地址格式，以及为什么稳定币退款是全有或全无。
- [稳定币支付](https://waffo.com/docs/zh/support/stablecoin-payments-faq.md): 接受 USDC 和 USDT：两条集成路径选哪一条、要发送的确切链值、每条路径中收款地址如何工作、金额和小数规则、支付窗口、购物者完成转账意味着什么和不意味着什么、法币结算，以及稳定币订单在 Portal 中的位置。
- [订阅金额与按期排程 FAQ](https://waffo.com/docs/zh/support/subscription-amount-scheduling-faq.md): scheduledAmounts 是什么意思、Waffo 如何为每个账单周期选取金额、/subscription/update 能改什么不能改什么（它只能下调金额；上调需要变更套餐或席位加购补款）、金额更新 Webhook，以及为什么没有按比例计费字段。
- [订阅到底在什么时候扣款？](https://waffo.com/docs/zh/support/subscription-billing-schedule-faq.md): Waffo 如何从订阅开始时间推算每个计费日期，为什么 31 号开始的月度订阅在二月之后会弹回 31 号，延迟重试成功是否会挪动下一个日期，为什么首期失败不重试，以及每个按期扣款状态的含义。
- [订阅创建与校验 FAQ](https://waffo.com/docs/zh/support/subscription-creation-validation-faq.md): 创建订阅时 Waffo 接受的精确取值范围、哪些字段必须一起提供、订阅状态的完整列表及其合法流转，以及创建重试、查询和未来开始日期的行为。
- [跨币种订阅与 Portal FAQ](https://waffo.com/docs/zh/support/subscription-cross-currency-and-portal-faq.md): 以一种币种定价、以另一种币种扣款的订阅其外汇如何运作、换算后的金额和汇率在哪里可见，以及如何在商户 Portal 中找到订阅、扣款和退款。
- [订阅 FAQ](https://waffo.com/docs/zh/support/subscription-faq.md): 解答关于 Waffo 订阅最常见的问题：升级与降级、金额变更、扣款失败与重试、通知、试用期以及用户侧管理。
- [托管的订阅管理页面](https://waffo.com/docs/zh/support/subscription-hosted-management-faq.md): /subscription/manage 如何工作：哪些状态会返回链接以及为什么会得到 A0028、链接有效多久以及新链接是否会使旧链接失效、顾客在页面上到底能看到和做什么、页面可以品牌化到什么程度，以及为什么在那里取消是立即生效的。
- [订阅生命周期与支付方式管理](https://waffo.com/docs/zh/support/subscription-lifecycle-management.md): 如何让订阅在未来某天开始、开始前可以做什么、用户如何管理多个支付方式并自动用备用方式重试、金额更新规则，以及 Waffo 向终端用户发送的生命周期通知。
- [Waffo 会给我的订阅客户发哪些邮件？](https://waffo.com/docs/zh/support/subscription-notifications-faq.md): Waffo 可以直接发给订阅者的六封邮件、每一封确切的触发时机、以哪种语言渲染、如何避免与你自己的邮件重复，以及订阅计费历史返回什么。
- [订阅套餐的升级与降级](https://waffo.com/docs/zh/support/subscription-plan-change-faq.md): /subscription/change 的端到端流程：remainingAmount 是什么、由谁计算，四种变更状态，原订阅会发生什么、何时发生，如何替换客户从未支付的变更，以及 A0048 / A0049 / A0050 / A0054 的含义。
- [订阅重试与支付方式](https://waffo.com/docs/zh/support/subscription-retry-and-payment-methods-faq.md): Waffo 如何重试失败的订阅扣款、何时停止重试以及这对订阅意味着什么、滚动重试窗口如何工作，以及订阅上支付方式的绑定、排序、替换和删除的完整规则。
- [税费、折扣与 Topup 边缘情形](https://waffo.com/docs/zh/support/tax-coupon-and-topup-edges-faq.md): 那些棘手的情形：多次部分退款时税费如何退还以使总额精确对平、税费计算失败何时阻止订单何时订单不含税继续、折扣记录的每个状态是什么意思以及由哪个订单事件驱动、为什么一笔订单不能叠加两个折扣，以及未支付的 Point Topup 订单占用库存多久。
- [Tokenization 与卡支付 FAQ](https://waffo.com/docs/zh/support/tokenization-faq.md): 关于 Waffo 卡 Tokenization 最常见问题的解答：token 是什么、如何获取、token 生命周期、CIT 与 MIT、首次支付与后续扣款，以及如何处理过期或无效的 token。
- [非卡 Token 与 Token 失败原因](https://waffo.com/docs/zh/support/tokenization-non-card-faq.md): 卡 FAQ 未覆盖的 tokenization 内容：CARD 之外的 token 类型、钱包类 token 的额外字段和固定有效期、为什么 tokenization 提交被拒绝、持卡人姓名规则、MIT 与 CIT 行为上的差异、为什么卡支付在发出之前就可能被拒绝，以及已保存支付方式的自助管理。
- [交易与退款字段参考](https://waffo.com/docs/zh/support/transaction-field-reference-faq.md): Portal 上支付或退款记录每个字段的实际含义：退款上的两个商户订单 ID、Initiation Type（CIT/MIT）及其为何通常为空、卡信息以及卡号如何掩码、金额为何显示为短横线，以及退款按钮为何缺失或灰显。
- [单卡购买限额 API](https://waffo.com/docs/zh/support/transaction-limit-api-faq.md): 如何通过带签名的 transactionlimit create / update / inquiry 接口，限制单张卡对某个产品或产品类目最多可购买的数量：请求字段、两组互斥的限额配置、幂等、生效窗口，以及规则命中时买家会看到什么。
- [我能把购物者信息传过去，让收银台不再重复询问吗？](https://waffo.com/docs/zh/support/trusted-shopper-data-faq.md): Waffo 收银台上的可信购物者数据：究竟哪九个字段可以从你的订单请求中预填、为什么表单仍会出现、购物者编辑后以哪个值为准、为什么 CPF 这类国家身份证号不在其中，以及该配置的作用范围和申请方式。
- [Webhook 通知投递契约 FAQ](https://waffo.com/docs/zh/support/webhook-delivery-contract-faq.md): Waffo 投递Webhook 通知时应用的确切规则：您的接口有多长时间应答、哪些响应体算成功、每种事件的回调 URL 来自哪里、为什么同一事件可能到达两次或乱序，以及未支付通知长什么样。
- [Webhook 通知事件字典与批量重发](https://waffo.com/docs/zh/support/webhook-events-and-resend-faq.md): 商户 Portal 跟踪的七种Webhook 通知事件类型、每种事件携带哪个标识以便你匹配回自己的订单、日志保留多久，以及如何用 Retry by Date 重放一段时间窗口内的失败投递。
- [Webhook 报文字段 FAQ](https://waffo.com/docs/zh/support/webhook-payload-field-faq.md): Webhook body 中哪个字段是你的订单号、卡 BIN 和后四位实际在哪里、该消费哪些 Payout 手续费字段、失败的订阅周期如何表达，以及通知 body 与对应查询响应的差异之处。
- [提现与余额 API](https://waffo.com/docs/zh/support/withdrawal-and-balance-api-faq.md): 让你从自己的系统提取结算资金并读取余额的五个签名接口：consult → create → inquiry 的调用顺序、withdrawRequestId 幂等键、余额查询返回哪些账户，以及账户历史查询的时间窗口和字段。
- [提现与批量付款 FAQ](https://waffo.com/docs/zh/support/withdrawal-and-batch-payout-faq.md): 关于从 Waffo 商户 Portal 提现结算资金和发起批量付款的最常见问题解答：手续费、状态、对账单、收款账户、批次校验和自动提现。
- [提现异常与状态](https://waffo.com/docs/zh/support/withdrawal-exceptions-and-status-faq.md): 提现在审核时被拒绝、被银行拒付，或在已成功后被退回时会发生什么：完整的状态链、提现费用是否退回、一次退回会产生哪些 Account History 行、Description 列在各状态下显示什么，以及为什么 Withdraw 按钮可能是灰的。