结账支付网关配置教程：填写自有商户凭据、验证公网 Webhook 签名与沙盒测试模式核对

整体如何运作

1. 你搭建一个商店（品牌商店 + 商品）。
2. 客户下单 — 从你的品牌商店页面、在与 AI/客服的聊天中，或由你手动添加订单。
3. 你一次性填入网关密钥，之后对任意订单发送结账链接。
4. 客户在网关的安全页面上付款。
5. WAthink 把订单标记为已付款，向客户发送收据；如果订单来自 WooCommerce/Shopify，还会把状态同步回去。

开始之前

• 连接一个 WhatsApp 号码。打开 Devices 并连接一个号码。参见连接通道。当前部署仅支持 WhatsApp 协议连接。
• 准备一个网关账户。在你要用的服务商（例如 Stripe、Razorpay、Paystack）注册，并能打开其 API keys 页面。
• 需要一个公网域名才能自动确认支付（见第 4 步）。在本地地址上仍可用网关的转发工具测试。

第 1 步 — 搭建你的商店（品牌商店）

进入 Store → Storefront。这是你的公开店铺页面。填写：

• Enabled — 打开品牌商店，使其公开 URL 生效。
• Store URL (slug) — 商店地址，例如 your-domain/s/my-shop。选择简短易读的 slug。（也可以接入自定义域名。）
• Currency — 所有价格和结账总额使用的货币（例如 INR、USD、KES）。请在添加商品之前设置，以保证价格一致。
• Branding — logo、品牌色、主题、hero 文案与页脚文案，让店铺看起来属于你。
• Shipping — 可选的固定运费、「满额免运费」阈值和配送说明。
• Cart recovery（可选）— 在延迟后自动向弃购客户发消息。

点击 Save。用商店侧栏顶部的 Open 预览线上店铺，或用 Copy 复制其公开链接。

先设置货币。商品会继承商店货币，结账总额也按该货币收取 — 之后再改货币就需要重新核对所有价格。

第 2 步 — 逐个添加商品

进入 Store → Products → Add product（即 + Add product 按钮）。填好一件商品，保存，再重复添加下一件。各字段如下：

• Name （必填） — 客户看到的商品标题，例如 “Complete Business Growth Package”。
• Price （必填） — 以商店货币计价的售价。输入完整金额，例如 ₹10,000 输入 10000。
• Compare-at price （可选） — 更高的「原价」，以删除线显示，用于提示折扣。
• SKU （可选） — 你的内部商品编码（同步到商品目录时也用作商品引用）。
• Category 和 Tags （可选） — 便于组织和筛选商品。
• Description — 简短摘要；富文本的 body 是商品页上展示的详细说明。
• Image — 上传图片（或粘贴图片 URL）。好图片更好卖 — 使用清晰的正方形图片。
• Stock quantity 和 In stock — 库存数量以及是否可购买。
• Weight （可选） — 如果按重量计价运费，会用到它。
• Status — 设为 Active 才会发布到品牌商店（Draft 保持隐藏）。
• Sort order （可选） — 控制它在列表中的位置。

点击 Save。商品随即出现在 Store → Products 和你的线上品牌商店中。对每件在售商品重复 Add product。

零小数货币（例如 IDR、JPY）会自动处理 — 输入完整金额，WAthink 会在店铺和结账处正确格式化。

第 3 步 — 配置结账网关密钥

进入 Store → Checkout gateways。你会看到所有受支持的服务商。对于你要用的那家：

1. 展开网关（例如 Stripe）。每个字段都标注了该网关要求的确切密钥：
   • Stripe — Secret key（sk_live_… / sk_test_…），以及用于确认的 Webhook secret（whsec_…）。
   • Razorpay — Key ID（rzp_…）、Key secret，以及可选的 Webhook secret。
   • Paystack / Flutterwave — Public key 与 Secret key（Flutterwave 还有一个可选的 webhook hash）。
   • 其他网关都会显示各自的必填字段及提示。
2. 从你的网关后台粘贴密钥。选择 Live 或 Test 模式，并勾选 Active。
3. 点击 Save。密钥加密存储。之后要修改时，只编辑那一个字段即可 — 留空会保留已保存的值。

你可以启用任意多个网关，并按订单选择其中一个。

先测试。使用网关的 Test 密钥和 Test 模式，之后用测试卡付款（Stripe：4242 4242 4242 4242，任意未来日期，任意 CVC），确认整个流程后再上线。

第 4 步 — 连接 Webhook（让支付得到确认）

Webhook 是网关通知 WAthink 支付成功的方式 — 它负责把订单标记为已付款并发送收据。在每家网关的卡片上，WAthink 都会显示一个 Webhook URL。

1. 复制显示的 Webhook URL — 形如 https://your-domain/wa/checkout/webhook/<gateway>。
2. 在你的网关后台把它添加为 webhook endpoint（Stripe：选择 checkout.session.completed 事件）。
3. 把网关的 webhook signing secret 复制回 WAthink 中对应网关的卡片并保存。

Webhook 必须能从公网访问。在公网域名上它会直接工作。如果你在本地或局域网地址（例如 192.168.x.x）测试，网关无法访问它 — 测试时请使用网关的本地转发工具（Stripe：stripe listen --forward-to your-address/wa/checkout/webhook/stripe），或直接在公网域名上测试。

第 5 步 — 获取订单

订单可以通过三种方式产生 — 都会显示在 Store → Orders 下：

• 来自品牌商店。客户打开你的店铺链接，把商品加入购物车，填写姓名/电话并下单。
• 来自聊天。你的 AI 助手或客服在 WhatsApp 对话中捕获订单。
• 手动创建。你为客户自行创建订单。

打开 Store → Orders 查看订单，按状态（New、Pending、Paid……）筛选，并打开任意订单查看完整详情。

第 6 步 — 发送结账链接

1. 在 Store → Orders 下打开订单。
2. 在 Send checkout (hosted pay link) 框中，从下拉菜单选择网关并点击 Send checkout link。
3. WAthink 会在该网关上为订单金额创建安全支付页，把链接通过 WhatsApp 发给客户，并保存到订单的 Payment link 字段。

你也可以从流程或 AI 订单助手自动触发，无需客服手动操作即可发出支付链接。

第 7 步 — 客户付款，订单确认

1. 客户点击链接，在网关的安全页面上付款（银行卡、UPI、移动货币、钱包 — 取决于该网关支持的方式）。
2. 网关通知 WAthink（第 4 步的 webhook），WAthink 校验后，订单变为 Paid。
3. 客户会自动在 WhatsApp 上收到「Payment received」收据；如果订单源自 WooCommerce/Shopify，状态也会推送回去。

这就是完整闭环 — 浏览、下单、付款、确认 — 基本都在 WhatsApp 内完成。

支持的网关

使用你自己的密钥配置以下任意一家。显示哪些支付方式取决于网关和你所在的国家/地区。

• 全球银行卡与钱包：Stripe、PayPal、Braintree、2Checkout、Square、Mollie、Paddle、Lemon Squeezy、Authorize.Net、Skrill。
• 印度：Razorpay、PayU、Paytm、PhonePe、Cashfree、Instamojo。
• 非洲：Paystack、Flutterwave（银行卡、移动货币，含 M-Pesa）、CinetPay。
• 东南亚：Midtrans、Xendit、Duitku。
• 中东与土耳其：Tap Payments、HyperPay、iyzico、PayTR。
• 拉丁美洲：Mercado Pago。
• 孟加拉国：SSLCommerz。
• 加密货币：Coinbase Commerce。
• 线下：Bank Transfer 与 Offline / Cash，用于手动结算的订单。

故障排查

• 订单上没有显示「Send checkout link」。尚未配置任何网关 — 订单会显示「Add gateway keys」。先完成第 3 步，再刷新订单。
• 客户已付款但订单仍显示 New。确认 webhook 没有到达你的服务器。在公网域名上，请重新检查第 4 步中的 webhook endpoint 和 secret。在本地/局域网地址上，请使用网关的转发工具。
• 「Add your <gateway> API keys first.」所选网关没有已保存的密钥，或处于未激活状态。请在 Checkout gateways 下添加或启用它。
• 支付页显示金额错误。检查商品价格和商店货币（第 1 步）— 结账总额是商店货币下的订单总额。

要求与注意事项

• 你需要拥有网关账户及其 API 密钥。款项结算到你的网关账户。
• Webhook URL 必须可被公网访问，订单才能自动确认并发送收据。
• 结账链接通过工作区已连接的 WhatsApp 协议连接发送，不需要WhatsApp Business Platform（Meta 官方 API）。

套餐可用性

商店/商务模块 — 品牌商店、商品、订单与结账网关 — 取决于你的工作区是否启用了相应的套餐。

相关页面

• 品牌商店与订单 — 店铺页面与订单列表详解。
• 商品目录 — 管理本地商品，并把商品直接发进 WhatsApp 聊天。
• 支付链接与结账 — 在任意对话中生成并分享收款链接。
• WooCommerce 订单 Webhook — 回写为已付款的订单。
• 连接通道 — 连接结账消息所发出的 WhatsApp 号码。