SDK Transferências

Esta página inclui dois exemplos oficiais de SDKs. Assinatura, classificação query, normalização JSON e verificação de retorno de chamada correspondem à implementação atual do servidor.

Para integração rápida, baixe o pacote ZIP para o seu idioma. Para empacotamento personalizado, você também pode baixar o cliente, o auxiliar de assinatura e os exemplos separadamente.

Node.js SDK

Para projetos Node.js 18+, com quatro métodos API, assinatura de solicitação, verificação de retorno de chamada e um script de exemplo mínimo.

Destaques
  • Inclui createPayinOrder, getPayinOrder, createExclusiveBinding e createPayoutOrder.
  • A assinatura da solicitação corresponde à implementação da assinatura do comerciante-openapi do servidor.
  • A verificação de retorno de chamada oferece suporte à verificação direta da string body da solicitação bruta.
Instalação
npm install ./sdk/nodejs
Exemplo rápido
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

Para PHP 8.1+ e Laravel 11/10/12, com cliente, provedor de serviços, fachada, arquivo de configuração e verificador de retorno de chamada.

Destaques
  • Suporta descoberta automática Laravel para ServiceProvider e Façade.
  • Suporta o envio de quatro solicitações OpenAPI por meio de UUGateClient ou Façade.
  • Inclui verificação apiKey para retornos de chamada de pagamento e pagamento.
Instalação
composer config repositories.uugate-sdk path ./sdk/php-laravel
composer require uugate/openapi-laravel-sdk:*
Exemplo rápido
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',
]);