开发者中心

浏览我们的 API 和工具，轻松集成稳定币支付。WeFlow 提供 RESTful API、SDK 和插件，帮助开发者快速支持加密货币收款。

API 集成

使用 WeFlow API 开始集成非常简单：首先注册账户获取 API 密钥，并在控制台添加收款钱包地址和 IPN 密钥，然后调用我们的 API 接口创建和管理支付。以下是通过 API 创建支付的示例：

示例：创建支付 API 请求 (HTTP POST)

curl -X POST https://api.weflow.cc/v1/payments \
 -H "x-api-key: YOUR_API_KEY" \
 -H "Content-Type: application/json" \
 -d '{"order_id":"ORDER12345","amount":100.00,"currency":"USDT","customer_email":"user@example.com","ipn_callback_url":"https://yourdomain.com/weflow-webhook"}'

调用上述接口后，您将收到一个 JSON 响应，其中包含提供给客户支付的收款地址（或二维码链接）。WeFlow 会自动检测链上付款并更新支付状态。

Webhook 通知

WeFlow 使用 Webhook（即时支付通知 IPN）来通知您的后端支付状态的变更（例如支付确认）。为确保通知的真实性，WeFlow 会对每个 Webhook 请求签名。您的接口应按以下步骤验证签名：

• 排序 按照字母顺序将回调 JSON 数据的键排序。
• 计算 使用您的 IPN 密钥，对排序后的 JSON 字符串进行 HMAC-SHA512 哈希计算。
• 比对 将计算得到的哈希值与请求头中的 `X-WEFLOW-SIGNATURE` 签名进行对比。
• 如果两者一致，则回调合法有效。

PHP 示例 – 验证 Webhook 签名：

<?php
    $receivedSig = $_SERVER['HTTP_X_WEFLOW_SIGNATURE'] ?? '';
    $payload = file_get_contents('php://input');
    $data = json_decode($payload, true);
    ksort($data);
    $sortedJson = json_encode($data, JSON_UNESCAPED_SLASHES);
    $computedSig = hash_hmac('sha512', $sortedJson, 'YourIPNSecret');
    if (hash_equals($computedSig, $receivedSig)) {
        http_response_code(200); // 验证成功
    } else {
        http_response_code(400); // 签名不匹配
    }
?>

SDK 和插件

不懂代码也没关系！WeFlow 提供前端支付 SDK 和主流电商平台插件（如 **Shopify**、**WooCommerce**），无需开发后端代码即可集成稳定币支付。只需安装插件或嵌入我们的 JS 代码段，并配置您的 API 密钥，即可开始接受加密货币支付。