---
title: 文档
description: Coinetic 加密货币支付网关开发者文档：快速开始、API 请求签名、账单、支付页面、Webhook、退款与沙盒，助您快速接收 USDT、USDC 和比特币。
url: https://coinetic.money/zh/docs/
lang: zh-Hans
---

# Coinetic 文档

在网站、App 或机器人中接收加密货币所需的一切。集成只需两个 API 请求和一个 Webhook 处理程序。

- [快速开始](https://coinetic.money/zh/docs/quickstart/) — 15 分钟完成第一笔测试支付：账单、跳转、Webhook。
- [客户端与示例](https://coinetic.money/zh/docs/sdks/) — Node.js、PHP、Python、Go —— 单个文件，无任何依赖。
- [Webhook](https://coinetic.money/zh/docs/webhooks/) — 事件、签名、重试与投递顺序。
- [上线检查清单](https://coinetic.money/zh/docs/go-live/) — 开始接收真实资金前需要检查的事项。

## 支付流程

`支付流程`

```
 您的服务器                      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://dash.coinetic.money/merchant) |
| 沙盒 | `https://sandbox.coinetic.money` | [https://sandbox.coinetic.money/merchant](https://sandbox.coinetic.money/merchant) |

所有响应均为 UTF-8 编码的 JSON，时间采用 UTC 的 RFC 3339 格式。完整的正式接口规范为 OpenAPI 3（`openapi.yaml`），可向技术支持索取或在后台获取。

## 商户全部接口

| 方法 | 路径 | 作用 |
| --- | --- | --- |
| POST | `/v1/invoices` | [创建账单](https://coinetic.money/zh/docs/invoices/) |
| GET | `/v1/invoices/{id}` | 账单、付款记录、确认数 |
| GET | `/v1/invoices` | 账单列表，支持筛选和游标分页 |
| GET | `/v1/assets` | 可用资产及最低金额 |
| GET | `/v1/rates` | 参考汇率（多家交易所共识价） |
| POST | `/v1/refunds` | [提交退款申请](https://coinetic.money/zh/docs/refunds/) |