交易

在 Dashboard > Commerce > Payments 标签页中浏览成功的收款记录、发起退款并跟踪争议。

Dashboard > Commerce 中的 Payments 标签页显示与你的应用相关的所有收款记录，包括状态、金额、货币、客户及产品引用信息。你可以直接在 builder 中发起退款，无需离开当前页面。

交易状态

状态	含义
succeeded	付款已成功捕获
pending	等待捕获或异步确认
failed	收款尝试失败
refunded	已全额退款
partially_refunded	部分金额已退款
disputed	客户已通过其银行对该收款提出争议

退款

在 Payments 标签页中找到对应交易，点击该行的 Refund 按钮。你可以退还全额或部分金额，并选择退款原因：

• Duplicate — 意外重复收款
• Fraudulent — 该收款未经授权
• Requested by customer — 客户主动申请退款

退款仅可针对状态为 succeeded 或 partially_refunded 的交易发起。处于争议状态的交易须通过 Stripe 的 dashboard 进行处理。

订阅类交易无法通过此流程退款——请改为取消订阅。仅包含 Stripe charge ID 的一次性付款交易才符合退款条件。

退款将通过 Stripe 退回客户的原始付款方式（通常需要 5–10 个工作日到账）。

每笔交易的记录字段

• id
• customerId 和 productId（可为空——纯订阅类交易中不存在）
• amountCents 和 currency
• status（见上文）
• refundAmountCents（如有）
• createdAt

争议（拒付）

如果客户通过其银行对某笔收款提出争议，该交易状态将变更为 disputed。Stripe 负责处理争议响应流程——你将收到一封邮件，并可通过 Stripe 的 dashboard 提交相关证据。

在 Proyecta builder 内原生支持争议响应流程的功能已列入开发路线图。

即将推出

• 单笔交易事件时间线 — 查看每次状态变更记录
• 批量导出交易历史
• Dashboard > Commerce 内的原生争议响应 UI