快速开始 | Payve Docs

欢迎使用 Payve！我们的支付网关专为亚洲市场设计，提供免KYC认证、3分钟快速集成、零成本开始的加密货币支付解决方案。

核心优势

极速集成

无需复杂配置，3分钟完成集成

免KYC认证

立即开始，无需繁琐的身份验证

透明费率

固定1%手续费，无隐藏费用

开始之前

在开始集成之前，请确保您已准备好：

一个有效的电子邮箱地址（用于注册商户账户）
您的应用服务器（用于接收支付通知）
基本的 HTTP 请求工具（如 curl 或 Postman）

创建商户账户

您可以通过两种方式创建商户账户：

方案一：通过商户控制台（推荐）

访问 Payve 商户控制台
点击「注册」按钮
填写邮箱地址和公司信息
完成邮箱验证
设置登录密码

注册成功后，您将自动登录到商户控制台。

方案二：通过 API 创建（仅用于测试）

curl -X POST https://api.payve.io/api/v1/merchant \
  -H "Content-Type: application/json" \
  -d '{
    "email": "your-email@example.com",
    "companyName": "Your Company Name"
  }'

响应示例：

{
  "success": true,
  "data": {
    "merchant": {
      "id": "clrxxx...",
      "email": "your-email@example.com",
      "companyName": "Your Company Name",
      "createdAt": "2024-01-15T10:00:00.000Z"
    },
    "apiKey": {
      "keyId": "pk_live_xxx...",
      "key": "sk_live_xxx..."
    }
  },
  "message": "商户创建成功，请妥善保存API密钥"
}

JSON

代码已折叠

共 16 行

API 密钥只会显示一次，请立即保存到安全的地方。如果丢失，您需要在商户控制台重新生成。

获取 API 密钥

通过商户控制台获取（推荐）

登录商户控制台
进入「开发者」→「API 密钥」页面
点击「创建 API 密钥」
设置密钥名称和权限
复制并保存生成的密钥

通过 API 获取访问令牌

使用您的 API 密钥获取 JWT 访问令牌（测试和生产环境都支持）：

curl -X POST https://api.payve.io/api/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "keyId": "pk_live_your_key_id",
    "secret": "sk_live_your_secret"
  }'

响应示例：

{
  "success": true,
  "data": {
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "type": "Bearer"
  }
}

JWT 令牌有效期为 24 小时。过期后需要重新获取。

创建支付订单

使用访问令牌创建一个支付订单：

curl -X POST https://api.payve.io/api/v1/payments \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "100.00",
    "currency": "USDT",
    "network": "TRON",
    "merchantOrderId": "ORDER_12345",
    "productName": "Premium Plan",
    "customerEmail": "customer@example.com",
    "callbackUrl": "https://your-domain.com/payment/callback",
    "returnUrl": "https://your-domain.com/payment/success"
  }'

BASH

代码已折叠

共 13 行

响应示例：

{
  "success": true,
  "data": {
    "orderId": "clrxxx...",
    "address": "TRX7Q2Ey6r7xKNfHBK8Ym2VLx9JqY2uVfX",
    "amount": "100.00",
    "currency": "USDT",
    "network": "TRON",
    "paymentUrl": "https://pay.payve.io/pay/clrxxx...",
    "expiresAt": "2024-01-15T12:30:00.000Z"
  }
}

JSON

代码已折叠

共 12 行

返回的 paymentUrl 是 Payve 提供的标准支付页面链接。将用户重定向到此页面即可完成支付，无需额外开发。支付页面已经过优化，支持多语言、响应式设计，并包含完整的支付流程。

如果您希望完全自定义支付界面，请参考步骤 4 使用前端 SDK。

集成前端 SDK（可选）

如果您希望在前端直接创建订单并自定义支付界面，可以使用我们的 JavaScript SDK。这让您无需使用 Payve 的标准支付页面，而是完全控制用户体验。

安装 SDK

npm install @payve/sdk

React 组件示例

import { PayveButton } from '@payve/sdk';
 
<PayveButton
  apiKey="pk_your_api_key"
  apiSecret="your_secret"
  amount="100"
  currency="USDT"
  onSuccess={(payment) => {
    console.log('Payment success:', payment);
  }}
>
  支付 100 USDT
</PayveButton>

JSX

代码已折叠

共 13 行

下一步

现在您已经完成了基本集成（步骤 1-3），以下是一些推荐的下一步操作：

示例项目

我们在 GitHub 上提供了完整的集成示例，展示了最佳实践：

🚀 快速开始模板

Next.js 电商示例
完整的电商网站，集成了支付功能
React SaaS 示例
SaaS 应用的订阅支付集成
Node.js API 示例
后端 API 集成示例，包含 Webhook 处理

📖 使用方法

# 克隆示例项目
git clone https://github.com/payve/example-nextjs-ecommerce
cd example-nextjs-ecommerce
 
# 安装依赖
npm install
 
# 配置环境变量
cp .env.example .env.local
# 编辑 .env.local 添加您的 API 密钥
 
# 启动开发服务器
npm run dev

BASH

代码已折叠

共 13 行

示例项目包含了完整的支付流程、Webhook 处理、错误处理等最佳实践，是快速上手的最佳方式。