API de pagos USDT / USDC: costos y resultados desconocidos
El pago termina cuando la confirmación en cadena y la liquidación comercial coinciden. Comprueba fondos, costos, destino y referencia antes de crear, y conserva el estado posterior.
Elige la red y el modelo
La API pública permite pagos individuales; los lotes se realizan en el panel. Rutas: TRON-USDT, BSC-USDT, BSC-USDC y SOL-USDC. El destino debe corresponder a la red y no ser una wallet propia del comercio. Una wallet de observación no firma pagos.
Parámetros y pasos de integración
POST /openapi/payout/orders recibe red, activo, amount, toAddress, merchantOrderNo y notifyUrl. fromAddress es opcional; el sistema puede elegir un origen suficiente. Sustituye el destino ilustrativo por una dirección verificada. Mantén desactivado el borrado del origen por defecto.
Este cuerpo es ilustrativo: no se envía una solicitud ni incluye datos reales. La llamada completa requiere UID, API Key, timestamp, nonce y firma en el servidor. Envía importes como cadenas y usa aritmética exacta para la contabilidad.
{
"chainCode": "TRON",
"tokenSymbol": "USDT",
"toAddress": "REPLACE_WITH_VERIFIED_TRON_ADDRESS",
"amount": "35.50",
"merchantOrderNo": "DEMO_PAYOUT_001",
"notifyUrl": "https://merchant.example.com/payouts/notify"
}Estados, callbacks y excepciones
Guarda el orderNo PO y consulta GET /openapi/payout/orders/{orderNo}. confirmed es éxito y failed es fallo. submitted, broadcasted o desconocido no son liquidación. No cambies la referencia para pagar otra vez; si la transacción firmada es incierta, verifica primero la original.
Los fondos de la wallet y la cuenta de costos son separados. Antes de pagar, verifica el saldo real de origen y costos de red suficientes. Un saldo de costos negativo bloquea operaciones críticas. Consulta precios, cuotas y costos actuales; las estimaciones de gas no equivalen al cargo de UUGate.
Usa la API Key de la orden original y el rawBody sin cambios. Verifica HMAC-SHA256(timestamp + "." + nonce + "." + rawBody) contra x-callback-signature. Después valida identidad, orden, activo, red e importe. Una transacción de base de datos y una restricción única evitan el doble abono. Devuelve HTTP 2xx tras persistir de forma fiable; una redirección no confirma el pago.
Caso ilustrativo de integración
Ejemplo: paga 35.50 USDT a un socio y guarda orderNo. Tras un corte de red consulta la orden original y registra una sola liquidación al ver confirmed. Si es desconocida, mantenla pendiente y comprueba txHash. Investiga fallos antes de seguir la recuperación documentada. Este ejemplo no envía fondos.
Verificaciones antes del lanzamiento
- La firma válida pasa; cambiar el cuerpo original invalida la firma.
- Un callback duplicado abona una vez; el procesamiento interrumpido se recupera.
- Consulta, callback, contabilidad y transacción en cadena coinciden.
- Red incorrecta, importe anómalo, vencimiento o resultado desconocido requieren revisión.
Integración y referencias técnicas
- Parámetros API
- Firma de solicitudes
- Verificación de callbacks
- Planes y costos de red
- Tutorial relacionado
- API de pagos USDT
- API de pagos USDC
- Cobros con dirección exclusiva
- SDK Node.js
- SDK PHP / Laravel
- Node.js: HMAC and timing-safe comparison
Las fuentes explican estándares y métodos técnicos; no implican respaldo a UUGate. Los parámetros aplicables están en la documentación actual de UUGate.
Pagos USDT por lotes: consola, tarifas y resultados individuales
La API pública solo ofrece pagos individuales. Los pagos USDT por lotes se realizan en la consola del comercio. Repetir solicitudes individuales no equivale a una API de lote atómico ni garantiza éxito o reversión de todo el lote.
Sigue el tutorial de pagos, verifica cada destino y red, fondos de origen y saldo de tarifas suficiente para todo el lote. Completa la 2FA requerida. Los fondos de la billetera y la cuenta de tarifas se comprueban por separado.
Concilia cada registro, estado y hash. Ante fallos parciales o resultado desconocido, conserva y consulta los registros originales. Si ya existe firma, verifica o retransmite esa misma firma; no firmes otro pago que pueda duplicarlo.