入门

按顺序了解使用 p3p API 的快速指南。

1. 获取您的 API 密钥

在 Telegram 上联系我们请求密钥。您将收到如下字符串：

YOUR_P3P_API_KEY

2. 将其附加到请求

在每次端点调用时将您的密钥作为 api-key 标头发送：

api-key: YOUR_P3P_API_KEY

3. 执行

选择您需要的接口。

3.1. 交易所

加密货币 ↔ 加密货币 - 聚合跨链交易，提供最佳汇率。

• 获取链 — 哪些链可用
• 获取代币 — 按链分组的代币
• 获取汇率 — 实时预言机参考汇率
• 报价交易所汇率 — 跨所有流动性来源的最佳聚合报价
• 创建交易所 — 锁定汇率并获取存款地址

3.2. 交易

法币 ↔ 加密货币 - 相同的交易引擎，一边是法币资产。

• 获取法币 — 可用的法币货币
• 报价交易汇率 — 法币→加密货币或加密货币→法币报价
• 创建交易 — 锁定汇率并获取付款说明

3.3. 商家

支付提供商 - 在您的项目中接受付款，向客户收取任何代币并在您的钱包中接收不同的代币。

• 创建发票 — 编程式结账
• 创建可共享发票 URL — QR 码/链接
• 获取合作伙伴统计、交易所、发票

4. 状态

无论您在步骤 3（执行）中启动了什么，您都以相同的方式跟踪它：

• 检查交易所状态 — 单笔交易
• 检查多个交易所的状态 — 批量轮询

5. 赚取收入

在任何 /exchange/rate 或 /exchange/create（或 /invoice/create 上的 wallet_merchant）上添加 opts.partner_id 设置为您的合作伙伴 ID（或您注册的钱包），以将交易归属于您。收入根据您的支付设置累积（即时按链钱包转账或 USDT 定时提款）。

{
  // ...您通常的请求体
  opts: { partner_id: "P3_YOURPARTNERID" }, 
}

在合作伙伴仪表板配置您的手续费钱包和支付计划。使用合作伙伴端点检查您赚取的金额。