接受YooKassa支付并将交易记录到Google表格

🧾 概述

该工作流程让您无需编写代码即可通过YooKassa接受在线支付，并将订单和交易记录到Google表格。它支持完整的支付流程：产品选择、支付发起、网络钩子处理、退款更新和支付状态检查。

👥 适用人群

本模板非常适合：

• 拥有简单结账流程的在线商店
• 数字产品或信息课程卖家
• 使用Telegram机器人或网页表单的创业者
• 需要快速集成支付并追踪到Google表格的用户

🎯 解决什么问题？

通常设置在线支付需要后端基础设施。这个无代码方案自动化了整个支付流程：

• 处理产品列表和价格获取
• 通过邮件和返回URL发起支付
• 监听payment.succeeded和refund.succeeded事件
• 将所有操作记录到结构化的Google表格中

⚙️ 工作流程功能

1. GET /products

从Google表格（products）返回排序后的产品列表。

2. POST /payment

• 验证必填字段（product_id、email、return_url）
• 检查邮件格式
• 从products获取产品数据
• 生成唯一的幂等键
• 向YooKassa API发送请求
• 将订单保存到orders表格
• 返回支付确认链接

3. POST /yoomoney

处理支付/退款事件的网络钩子：

• 在payment.succeeded时，向transactions添加记录
• 在refund.succeeded时，更新交易状态

4. GET /status/:id

从YooKassa返回实时支付状态

🚀 设置步骤

1. 连接凭证：

   • Google表格（OAuth2）
   • YooKassa（使用shopId和secretKey的基本认证）

2. 更新以下Google表格：

   • products：应包含product_id、title、price
   • orders：保存确认的购买
   • transactions：记录所有成功或退款的支付

3. 使用任何HTTP客户端测试端点：

/payment的示例负载：

{
"product_id": "abc123",
"email": "[email protected]",
"return_url": "https://your.site/success"
}

🔧 如何自定义

• 添加交付逻辑（例如支付成功后发送产品链接邮件）
• 将Google表格替换为数据库（如PostgreSQL）
• 连接Telegram或其他通讯工具发送支付后通知
• 添加促销码、折扣或订阅逻辑

💼 使用场景

• 简单在线结账
• Telegram机器人销售访问权限
• 教育产品销售
• 电商MVP流程
• 捐款或会员支付

📎 注意事项

✅ 包含各部分的便签说明
✅ 包含错误处理和验证
✅ 除UUID生成外无需自定义代码