连接 Stripe | Coin Moebius

最简单的方法:使用Stripe登录

无需寻找钥匙，无需粘贴。您登录Stripe，批准Coin Moebius，大约一分钟后即可返回。 Coin Moebius 仅保留您的 Stripe 帐户 ID，而不保留您的密钥，Stripe 会在您的帐户发生任何变化时告诉我们。

打开提供商并单击Connect a provider
在Coin Moebius 仪表板中，选择左侧菜单中的提供商，然后单击右上角的Connect a provider。
Coin Moebius → 提供者 → Connect a provider
选择Stripe
在搜索框中输入Stripe，或向下滚动到它，然后单击它。
Connect a provider→Stripe
为其命名，添加两个页面，然后保存
为连接指定一个昵称。输入您的成功 URL(买家付款后看到的页面)和取消 URL(他们退出后看到的页面)。停留在第一个选项卡上，然后单击Save and connect with Stripe。
昵称、成功 URL、取消 URL → Save and connect with Stripe
两个地址都必须以 https:// 开头。它们是您在此屏幕上键入的唯一内容。
批准Stripe
Stripe 打开。登录您的Stripe 帐户，如果您还没有帐户，则直接创建一个帐户，然后批准Coin Moebius。 Stripe 显示您要使用哪个帐户，因此您可以在同意之前检查它。
Stripe → 登录或创建帐户 → 批准Coin Moebius
你回来了，并已连接
Stripe 会将您直接发送回Coin Moebius。绿色勾号表示卡付款已准备就绪，Stripe 卡现在位于您的提供商页面上，标记为“已验证”和“实时”。
返回Coin Moebius:Stripe 帐户已连接
提供商→您的Stripe卡:已验证，实时
看到“需要采取行动”而不是绿色勾号？ Stripe 尚未完成您帐户的卡付款清算。完成Stripe的要求，回来，然后点击Stripe卡片上的Verify。

或

另一种方法:粘贴您自己的密钥

从这里往下的一切都是手动路径。您在 Stripe 仪表板中设置了一个 Webhook，在那里收集三个值，并将它们粘贴到 Coin Moebius 中。计划十分钟左右。如果您在上面登录，则您已经完成并可以跳过所有这些。

你需要什么

字段	它做什么
可发布密钥（pk_…）	在浏览器里打开 Checkout 的公钥。非机密。
密钥（sk_…）	让我们创建 Checkout 会话，使扣款通过你的账户进行。机密。
Webhook 签名密钥（whsec_…）	确认一个 webhook 确实来自 Stripe。机密。
成功网址 / 取消网址	买家在付款或退出后落到哪里。

只有关键路径需要这些。如果您使用上面的Stripe登录，则没有任何可收集的信息。 Stripe 为测试模式和实时模式保留单独的密钥(pk_test_ / sk_test_ 与 pk_live_ / sk_live_)，每个密钥都有自己的 webhook 签名密钥。 Coin Moebius 同时保留在“实时”和“测试”选项卡中，因此您可以验证测试密钥并稍后添加实时密钥，而无需重新输入所有内容。

我们为什么要每个字段

可发布密钥

当结账在买家浏览器里打开时标识你的账户。设计上就是公开的。

密钥

授权创建扣款的那一半私钥，使付款通过你的账户进行。

Webhook 签名密钥

证明一个传入的 webhook 真的来自 Stripe，于是没人能伪造一个“已付款”事件。它是一个与密钥不同的值。

成功与取消网址

普通设置：买家在付款或退出后落到哪里。非机密。

设置

使用测试模式（免费）
一个 Stripe 账户是免费的，且测试模式在激活之前就能用。在 dashboard.stripe.com 登录并打开测试模式（右上角）。先把测试设好，再在正式里重复一遍。
复制你的密钥
去 Developers → API keys，复制 Publishable key 和 Secret key。
Stripe → Developers → API keys
添加 webhook
1. Developers → Webhooks → Add endpoint。
2. 把端点 URL 设为你的项目 webhook 地址（见下）。
3. 选择事件。对于一次性付款：checkout.session.completed、charge.refunded、charge.dispute.created。如果你销售订阅，还要加上：customer.subscription.created、customer.subscription.updated、customer.subscription.deleted、invoice.payment_succeeded、invoice.payment_failed。多选的事件无害，我们会忽略用不到的。
4. 复制端点的 Signing secret（whsec_…）。测试和正式各有自己的。
```
https://api.coinmoebius.com/webhook/stripe/<your project id>
```
Stripe → Developers → Webhooks → Add endpoint
测试
测试卡只在测试模式下有效，永远不会扣真卡。用任意未来的有效期、任意 CVC、任意邮编。
结果卡号
成功 4242 4242 4242 4242
需要验证 4000 0025 0000 3155
被拒 4000 0000 0000 9995
在后台里连接
添加渠道 → Stripe。输入可发布密钥、密钥、webhook 签名密钥、成功网址和取消网址。用测试密钥验证流程，然后编辑该渠道并换成正式密钥。

结果	卡号
成功	4242 4242 4242 4242
需要验证	4000 0025 0000 3155
被拒	4000 0000 0000 9995

连接之后

在上线前进行一笔付款:

使用Stripe登录？你的账户是活跃的，所以用你自己的卡购买一美元的产品，然后从Stripe退款。粘贴测试键？每次付款都是测试付款，因此请使用上面的测试卡。
创建一个商品，并把买按钮放到一个页面上（本地 HTML 文件也行），指向你的项目。
用上面的测试卡结账。
打开“交易”标签。当新行的状态到达 succeeded 时，你的密钥和 webhook 就都端到端工作了。

如果您使用测试密钥，请编辑提供商，换入您的实时密钥，然后您就可以进行真正的付款。

问题排查

从Verify开始。在仪表板中，单击Stripe 卡上的Verify。它会询问Stripe有关您的帐户的信息，或检查您的密钥，并在出现问题时返回特定消息。

我使用 Stripe 登录并收到“帐户已连接。需要采取行动。”

您的Stripe 帐户已连接，但Stripe 尚未清除该帐户的卡付款功能。打开Stripe，完成其要求的内容(通常是公司详细信息或银行帐户)，然后单击Coin Moebius 中Stripe 卡上的Verify。

Stripe 卡显示已断开连接。

Coin Moebius 已从您的Stripe 帐户中删除，通常是从Stripe 中的授权应用程序页面删除。打开卡片，选择Edit，然后点击Reconnect再次批准。

验证说密钥格式不对。

密钥以 sk_test_ 或 sk_live_ 开头（受限密钥以 rk_ 开头）。webhook 签名密钥以 whsec_ 开头。把正确的值重新复制到正确的字段里。

验证说 Stripe 拒绝了该密钥。

从 Developers → API keys 重新复制密钥，并确保你没有把测试密钥与正式 webhook 密钥配在一起，或反过来。

付款完成了，但订单仍停在待处理。

webhook 没有到达。确认端点 URL 完全一致、你选了 checkout.session.completed，且测试付款打到的是你的测试模式端点（测试和正式是各自独立的端点）。

签名校验失败。

每个 Stripe 端点都有自己的签名密钥。从这个端点的设置里复制 whsec_，而不是另一个端点的。

端到端确认一下。

Stripe 没有模拟按钮。在 Stripe 后台里，把一个近期事件重发到你的端点，或创建一个测试 PaymentIntent，然后看着订单更新。

值得了解

使用Stripe登录. 无需复制、存储或轮换密钥或 Webhook 机密。当您的帐户发生更改时，Stripe 会通知Coin Moebius。要切断链接，请单击Stripe 卡上的Disconnect，或删除Stripe 中的授权应用程序下的Coin Moebius。

轮换密钥. 粘贴你自己的密钥？随时滚动密钥或 Webhook 密钥，然后粘贴新值。秘密字段在编辑时保持空白，以便您可以放入旋转密钥。

激活. 正式密钥只有在你的账户被激活用于收款后才生效。测试密钥立即生效。

有问题？ Join our Discord

Stripe