SDK 下载

文档提供 Node.js、Java、PHP、Go 四套 SDK,统一接口参数、请求签名、JSON 正文和回调验签规则。

选择对应语言下载 ZIP 整包,安装说明、客户端、签名工具和示例均包含在压缩包内。

Node.js SDK

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

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

const client = new UUGateClient({
  baseUrl: 'https://api.uugate.com',
  merchantUid: process.env.UUGATE_MERCHANT_UID,
  apiKey: process.env.UUGATE_API_KEY,
});

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

Java SDK

Java 标准库客户端,包含四个接口方法、请求签名、回调验签和只读查询示例。

特点
  • 内置 createPayinOrder、getPayinOrder、createExclusiveBinding、createPayoutOrder 4 个方法
  • 成功返回原始业务 JSON;普通 JSON 错误与 HTTP 空正文拒绝分别处理。
  • 回调使用原订单 API Key 和原始请求体字节验签。
安装
cd uugate-java-sdk
javac -encoding UTF-8 -d build src/uugate/UUGateClient.java examples/Example.java
java -cp build Example
快速示例
import uugate.UUGateClient;
import java.util.Map;

UUGateClient client = new UUGateClient("https://api.uugate.com",
    System.getenv("UUGATE_MERCHANT_UID"), System.getenv("UUGATE_API_KEY"));
String order = client.createPayinOrder(Map.of(
    "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 ./uugate-php-laravel-sdk
composer require uugate/openapi-laravel-sdk:*@dev
快速示例
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',
]);

Go SDK

Go 标准库客户端,包含四个接口方法、请求签名、回调验签和只读查询示例。

特点
  • 内置 CreatePayinOrder、GetPayinOrder、CreateExclusiveBinding、CreatePayoutOrder 4 个方法
  • 成功返回原始业务 JSON;普通 JSON 错误与 HTTP 空正文拒绝分别处理。
  • 回调使用原订单 API Key 和原始请求体字节验签。
安装
cd uugate-go-sdk
go test ./...
go run ./examples/basic
快速示例
import (
    "context"
    "os"
    uugate "uugate.local/openapi"
)

client, err := uugate.NewClient("https://api.uugate.com",
    os.Getenv("UUGATE_MERCHANT_UID"), os.Getenv("UUGATE_API_KEY"))
if err != nil { panic(err) }
order, err := client.CreatePayinOrder(context.Background(), map[string]any{
    "chainCode": "TRON", "tokenSymbol": "USDT",
    "merchantOrderNo": "M202604170001", "amount": "100.00",
    "notifyUrl": "https://merchant.example.com/api/uugate/payin-notify",
})
if err != nil { panic(err) }
_ = order