SDK 下载

文档页已内置两套官方示例 SDK,签名算法、query 排序、JSON 规范化和回调验签规则都与当前服务端实现保持一致。

如果你只想快速接入,优先直接下载对应语言的 zip 包;如果你想二次封装,也可以继续单独取客户端、签名工具和示例文件。

Node.js SDK

适用于 Node.js 18+ 项目,提供 4 个接口方法、请求签名、回调验签和最小示例脚本。

特点
  • 内置 createPayinOrder、getPayinOrder、createExclusiveBinding、createPayoutOrder 4 个方法
  • 请求签名与服务端 merchant-openapi-signature 完全一致
  • 回调验签支持直接使用原始请求体字符串校验
安装
npm install ./sdk/nodejs
快速示例
import { UUGateClient } from 'uugate-openapi-sdk';

const client = new UUGateClient({
  baseUrl: 'https://api.uugate.com',
  merchantUid: '880001',
  apiKey: 'mch_xxxxxxxxxxxxxxxxxxxx',
});

const order = await client.createPayinOrder({
  chainCode: 'TRON',
  tokenSymbol: 'USDT',
  merchantOrderNo: 'M202604170001',
  amount: '100.00',
  notifyUrl: 'https://merchant.example.com/api/uugate/payin-notify',
});

PHP / Laravel SDK

适用于 PHP 8.1+ 和 Laravel 10/11/12,提供客户端、服务提供者、Facade、配置文件和回调验签工具。

特点
  • 支持 Laravel 自动注册 ServiceProvider 和 Facade
  • 支持直接通过 UUGateClient 或 Facade 发起 4 个开放接口请求
  • 已内置 apiKey 验签工具,适合直接接收收款和代付回调
安装
composer config repositories.uugate-sdk path ./sdk/php-laravel
composer require uugate/openapi-laravel-sdk:*
快速示例
use UUGate\OpenApi\Facades\UUGate;

$order = UUGate::createPayinOrder([
    'chainCode' => 'TRON',
    'tokenSymbol' => 'USDT',
    'merchantOrderNo' => 'M202604170001',
    'amount' => '100.00',
    'notifyUrl' => 'https://merchant.example.com/api/uugate/payin-notify',
]);