Coinetic 文档
在网站、App 或机器人中接收加密货币所需的一切。集成只需两个 API 请求和一个 Webhook 处理程序。
快速开始
15 分钟完成第一笔测试支付：账单、跳转、Webhook。
客户端与示例
Node.js、PHP、Python、Go —— 单个文件，无任何依赖。
Webhook
事件、签名、重试与投递顺序。
上线检查清单
开始接收真实资金前需要检查的事项。
支付流程
支付流程
您的服务器 Coinetic 顾客
────────── ──────── ──────────
1. POST /v1/invoices ────────▶ 创建账单，返回 checkout_url
2. 跳转到 checkout_url ──────────────────────────────────────────▶ 支付页面
3. 顾客选择币种 ◀────────────────── (USDT, USDC, BTC…)
并向分配的地址付款
4. 网络确认付款
5. Webhook invoice.paid ◀────── POST 到您的 URL（HMAC 签名）
6. GET /v1/invoices/{id} ─────▶ 复核状态
7. 交付订单
8. 「返回商店」 ─────────────────▶ 您的 return_url四条原则
- API 密钥的 secret 只能保存在您的服务器上。不要放在浏览器、移动 App 或 git 中。
- 支付状态只以 Coinetic 为准。不要信任
return_url中的参数，也不要盲目相信 Webhook：先验证签名，再通过GET /v1/invoices/{id}复核状态。 - 金额一律用字符串。金额以十进制字符串（
"49.99"）或最小单位字符串（"49990000"）返回。请勿转换为 float。 - 每个修改类请求都要带
Idempotency-Key。超时后重试会返回同一张账单，而不会创建第二张。
基础地址
| 环境 | API | 后台 |
|---|---|---|
| 生产环境 | https://pay.coinetic.money | https://dash.coinetic.money/merchant |
| 沙盒 | https://sandbox.coinetic.money | https://sandbox.coinetic.money/merchant |
所有响应均为 UTF-8 编码的 JSON，时间采用 UTC 的 RFC 3339 格式。完整的正式接口规范为 OpenAPI 3（openapi.yaml），可向技术支持索取或在后台获取。