所有渠道

NOWPayments

买家用加密货币付款,资金结算到你自己的 NOWPayments 账户。Coin Moebius 从不持有这笔钱。

你需要什么

字段它做什么
API key让我们调用 NOWPayments 来创建付款。机密。
IPN secret确认一条付款通知确实来自 NOWPayments。机密。
成功网址 / 取消网址买家在付款或退出后落到哪里。

IPN(Instant Payment Notification,即时付款通知)是 NOWPayments 对它们在付款状态变化时发送的 webhook 的称呼。

我们为什么要每个字段

API key

授权创建付款,使资金结算到你的账户。

IPN secret

证明一条传入的通知真的来自 NOWPayments,于是没人能伪造一个“已付款”事件。它是一个与 API key 不同的值。

成功与取消网址

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

设置

  1. 测试:没有沙盒

    NOWPayments 没有沙盒或测试环境。要端到端验证,用一种低费币种发一笔真实的小额付款,并确认它出现在你的后台里。把那第一笔小额付款当作你的测试。一个 NOWPayments 账户是免费的;你只为真实付款支付正常的网络和服务费用。

  2. 在 NOWPayments 中打开付款设置

    在 account.nowpayments.io 登录,进入 Settings → Payments。这一个界面包含你所需的三项内容:付款钱包(资金落点)、API 密钥和即时付款通知。你将依次访问每一项。

    NOWPayments → Settings → Payments
  3. 添加付款钱包

    NOWPayments 只有在你有付款钱包记录后才会解锁 API。在"付款钱包"页,点击"添加新钱包",选择币种,粘贴你控制的钱包地址,然后点击"添加钱包"。这是你的加密货币结算地址。

    NOWPayments → 付款钱包 → 添加新钱包
  4. 创建 API 密钥

    打开"API 密钥"并点击"添加新 API 密钥"。你的密钥会列在此处,每个旁边都有复制图标,方便你随时回来重新复制。

    NOWPayments → Settings → API 密钥
  5. 复制你的 API 密钥

    NOWPayments 在"API 密钥已创建"对话框中显示新密钥。点击"你的 API 密钥"旁边的复制图标并保存备用。(其下方的公钥不是 Coin Moebius 所需的。)你可以添加可选标签,然后点击"保存"。

    NOWPayments → API 密钥已创建

    这是你的私密 API 密钥。请像对待密码一样保管它。

  6. 设置 IPN 回调并复制 IPN 密钥

    打开"即时付款通知"。IPN(Instant Payment Notification,即时付款通知)是 NOWPayments 在付款状态发生变化时所发送的 webhook 的名称。

    1. 在 Webhook URL 字段中粘贴你项目的 NOWPayments webhook 地址(见下),然后点击"保存"。
    2. 复制顶部显示的 IPN 密钥(如果没有值,点击"重新生成")。
    3. 在"选择 webhook 格式"下,选择"经典方式",以使金额和 ID 保持正常的数字格式。
    https://api.coinmoebius.com/webhook/nowpayments/<your project id>
    NOWPayments → 即时付款通知

    你的项目 ID 显示在 Coin Moebius 后台的项目名称下方;将其填入上方地址中。已连接的渠道卡片(最后一步)也会显示同一个 URL,方便你随时重新复制。

  7. 回到 Coin Moebius:添加渠道 → NOWPayments

    在你的项目里,打开"渠道"标签,点击"添加渠道",选择"连接服务",然后选择 NOWPayments。粘贴你的 API 密钥和 IPN 密钥,设置成功网址和取消网址(买家付款或退出后的落点),然后点击"保存"。

    Coin Moebius → 添加渠道 → NOWPayments
  8. 连接完成

    NOWPayments 现在出现在你的"渠道"标签上,显示连接日期。卡片上显示你粘贴到 NOWPayments 的同一个 webhook URL,以及"编辑"和"断开连接"按钮。由于 NOWPayments 没有沙盒,我们无法自动验证 IPN 密钥,因此卡片提供一次微额付款测试:发送一笔小额真实付款,以确认一切端到端正常工作。

    Coin Moebius → 渠道 → NOWPayments(已连接)

连接之后

没有沙盒,所以你第一笔真实的小额付款就是测试:

  1. 创建一个商品,并把买按钮放到一个页面上(本地 HTML 文件也行),指向你的项目。
  2. 用一种低费币种付一笔小额。
  3. 打开“交易”标签。当新行的状态到达 succeeded 时,你的 API key 和 IPN secret 就都端到端工作了。

问题排查

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

IPN 没有到达或没有通过校验。确认回调 URL 一致,且后台里的 IPN secret 与你 NOWPayments 设置里的 IPN Secret Key 一致。

没法不付款就测试。

没错,没有沙盒。用一种低费币种发一笔真实的小额付款来触发一个真正的 IPN,然后看着订单更新。

状态只在有真实活动时才变化。

NOWPayments 的状态反映 IPN 投递,所以一个安静的账户在有一笔真实付款发生之前不显示任何状态。

值得了解

没有测试模式. 用一笔真实的小额付款来验证,而不是沙盒。

轮换密钥. 随时生成一个新的 API key 或 IPN secret,然后粘上新值。

有问题? Join our Discord

准备好连接一个渠道了吗?

挑你已在用的渠道。买家通过你的账户付款,而你只保留一个买按钮。