ZH
EnglishEspañolFrançaisDeutsch简体中文УкраїнськаРусскийNederlands
登录 立即接入
如何接入

从注册到第一笔付款
只需七步

大部分工作由后台的接入向导完成。开发者只需在服务器端写大约 50 行代码。

打开后台 → 直接看代码
  1. 2 分钟

    注册账户

    在商户后台点击「注册」，填写企业名称、邮箱和密码，然后通过邮件中的链接验证邮箱。

  2. 1 分钟

    开启双重验证

    所有用户必须开启：使用身份验证器应用（TOTP）。开启后才会进入接入向导。之后还可以添加通行密钥（passkeys）。

  3. 10 分钟

    设置收款钱包

    即付款的到账地址。只需要公开信息——无论在我们这里还是其他任何地方，都绝不要输入助记词或私钥。

    • Bitcoin、Litecoin、TRON：从 Ledger Live、Sparrow、Trust Wallet 等钱包导出的账户 xpub/zpub；我们会展示前几个地址，请与钱包中的地址核对。
    • Ethereum、BSC、Polygon、Base、Arbitrum：归集钱包（建议使用 Safe 多签）。
    • Solana：收款人地址。
  4. 1 分钟

    选择资产

    选择向顾客提供哪些币种和网络。最简单的起步方式是稳定币 USDT 和 USDC：与美元 1:1 挂钩，没有汇率风险。

  5. 2 分钟

    创建 API 密钥和 Webhook

    在「密钥与 Webhook」中：API 密钥的 secret 和 Webhook 签名密钥都只显示一次，请立即保存到密钥管理服务或服务器环境变量中。

  6. 一个晚上

    完成集成并在沙盒中测试

    创建账单、跳转支付页面、处理 Webhook。沙盒有独立的后台和密钥，付款无需真实资金。请跑通以下场景：精确支付、少付后补付、多付、账单过期、Webhook 重复投递。

  7. 审核通过后

    提交审核并正式上线

    向导会提交审核申请。审核通过后，签发单独的生产环境密钥，并完成上线检查清单。

您需要准备

  • 由您掌控的钱包硬件钱包或多签钱包，对企业来说比手机钱包更可靠。
  • 支持 HTTPS 的服务器Webhook 只接受 https:// 和 443 端口（沙盒中也可以用 localhost）。
  • 已同步的系统时钟请求签名有效期为 ±5 分钟，请开启 NTP。
  • 存放密钥的地方密钥管理服务或环境变量。不要放在 git、浏览器或手机应用中。
没有开发人员？把快速开始的链接发给您的开发者，所需内容和现成代码都在里面。
最小集成

一张图看懂全部代码

伪代码
# 1. 顾客点击了「支付」
invoice = client.createInvoice({order_id, price_amount: "49.99", price_currency: "USD",
                                return_url}, idempotencyKey = "order-" + order_id)
redirect(invoice.checkout_url)

# 2. Coinetic 发来了 Webhook（原始请求体！）
event = verifyWebhook(WEBHOOK_SECRET, headers, rawBody)     # 否则返回 400/401
if seen(event.id): return 200                               # 重复投递
inv = client.getInvoice(event.data.invoice_id)              # 状态只以 API 为准
if inv.status in ["paid", "overpaid"]: grantOnce(inv.order_id)
return 200

准备好开始了吗？

注册免费，沙盒同样免费。

免费注册 →联系我们