> ## 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.

# 收据：查看、发送与配置

> 如何在商户 Portal 中查看支付收据、通过邮件发送给客户、解读投递状态，以及理解什么控制着收据内容。

收据是面向客户的、针对一笔成功支付的文件。本页覆盖商户 Portal 中可用的收据操作。
收据上的商户名称和 logo 规则在《收银台页面生命周期与收据 FAQ》中描述。

## 我在哪里找到一笔交易的收据？

在 **Transactions → Payment Orders** 中打开该交易，在详情页找到 **Receipt** 区块。
**View Receipt** 会在新标签页打开收据页面，在那里可以切换收据语言并下载。

如果你更愿意从自己的系统处理这件事，订单查询响应会为支持收据的订单返回
`userReceiptUrl`；收据有效期多长见
[开发者 FAQ](/docs/zh/developer-docs/tools-and-references/references/faq)。

## 为什么有些交易完全没有 Receipt 区块？

Receipt 区块只在该交易确实能生成收据时出现。以下条件必须全部成立：

* 支付到达了**成功**状态，
* 支付经过了 Waffo 收银台会话，并且
* 收据已**为你的合约类型启用**。

任一条件不满足时，整个区块——包括 **View Receipt**——都会隐藏，针对该订单的发送请求也会
因为收据未启用而被拒绝。无法从 Portal 为这类交易生成收据。

## 我如何把收据通过邮件发给客户？

在交易详情页使用 **Send Receipt** 并输入收件人地址。它不必是客户在收银台使用的地址，
所以你也可以给自己或你的财务邮箱发一份副本。

邮件从 Waffo 的官方发送地址发出，标题为
`Your Receipt from {your merchant display name}`，包含的是收据页面的链接而不是附件。

## 我点了两次 Send。客户会收到两封邮件吗？

不会。在短时间窗口内针对**同一订单 + 同一收件人 + 同一 Portal 操作人**的重复提交会被去重：
Portal 报告成功，但只发出一封邮件。

超出该窗口——或使用不同收件人——发送会被当作新请求处理，并创建新的发送记录。
你可以按需要重发任意多次。

## 收据邮件的状态是什么意思？

详情页始终显示该订单**最近一次**的发送记录。

| 状态 | 含义 |
| - | - |
| `PENDING` | 发送请求已记录并排队。 |
| `SENT` | 邮件服务已**接受**该消息。这不是投递成功的证明。 |
| `DELIVERED` | 消息已实际投递到收件人的邮件服务器。 |
| `FAILED` | 投递失败——包括被退回和被丢弃的消息。会显示失败原因。 |

把 `SENT` 当作"已交出"，而不是"已收到"。如果客户说收据从未到达而记录仍显示 `SENT`，
请等待记录变为 `DELIVERED` 或 `FAILED` 后再重发。

## 我能看到是谁发的、发到了哪里吗？

可以。每条发送记录都带有投递状态、**实际收件人地址**、触发方式、Portal 操作人的邮箱、
发送时间戳，以及失败时的失败原因。当客户对是否曾出具收据有争议时，这就是要引用的记录。

自动重试由邮件服务执行，且只更新**现有**记录的状态——它们永远不会创建新记录。
只有当你再次点击 **Send Receipt** 时才会出现新记录。

## 支付成功后 Waffo 会自动发送收据邮件吗？

不会。目前发送收据邮件是 Portal 中的手动操作。同样不可用的还有：批量下载收据、一次发送
给多个收件人、定时发送，以及客户从收据页面自行触发重发。

如果你的客户期望每笔成功支付都收到收据邮件，请用订单查询响应中的 `userReceiptUrl`
从你自己的系统发送。

## 什么控制着收据上显示的内容？

收据内容由**为你的账户保存的收据配置**驱动，而不是按订单传入的字段。订单和订阅的支付信息
以 `receiptTemplateId` 报告所应用的配置。

你在 **Settings → Receipt Configuration** 自行管理该配置：文件标题、商户展示名称和 logo、
"From" 主体区块、页脚和支持文案，以及是否显示客户的姓名和邮箱。金额、费用和订阅行由
Waffo 从交易本身填充，无法编辑。更改在保存时生效，没有审批步骤，并且适用于过去和未来的
交易——见
[收据配置与下载](/docs/zh/support/receipt-configuration-and-download-faq)。


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